COBOL - PROCEDURE DIVISION - XML GENERATE - Operation of XML GENERATE



Desenvolvido por DORNELLES Carlos Alberto - Analista de Sistemas - Brasília DF. - cad_cobol@hotmail.com

COBOL - PROCEDURE DIVISION - XML GENERATE - Operation of XML GENERATE
Enterprise COBOL for z/OS, V6.3.0, Language Reference

O conteúdo de cada item de dados elementar elegível no identifier-2 que não foi suprimido da geração XML de acordo com uma frase SUPPRESS, é convertido para o formato de caracter.

Somente a primeira definição de cada área de armazenamento é processada.
Redefinições de itens de dados não estão incluídas.
Os itens de dados efetivamente definidos pela cláusula RENAMES também não são incluídos.

Para obter informações sobre a conversão de formato de dados elementares, consulte Format conversion of elementary data e Trimming of generated XML data.

Se a frase TYPE OF for especificada, o conteúdo convertido será processado como conteúdo do caractere do elemento ou valor do atributo, de acordo com as especificações dessa frase.
Se a frase TYPE OF não for especificada, por padrão, o conteúdo convertido será inserido como conteúdo de caractere do elemento ou, se a frase WITH ATTRIBUTES for especificada e o item de dados estiver qualificado para ser expresso como um atributo, como o valor do atributo, no documento XML gerado.

Os nomes dos elementos XML e os nomes dos atributos são obtidos da frase NAME, se especificado; caso contrário, por padrão, eles serão derivados dos nomes de dados no identifier-2, conforme descrito na XML element name and attribute name formation.
Os nomes dos itens de grupo que contêm os itens elementares selecionados são mantidos como elementos pai.
Se a frase NAMESPACE-PREFIX for especificada, o valor do prefixo, menos os espaços à direita, será usado para qualificar as tags de início e fim de cada elemento.

Nenhum espaço em branco extra (novas linhas, recuo e assim por diante) é inserido para tornar o XML gerado mais legível.
Uma declaração XML será gerada se a frase XML-DECLARATION for especificada.

Se a área de recebimento especificada pelo identifier-1 não for grande o suficiente para conter o documento XML resultante, existe uma condição de erro.
Veja a descrição da frase ON EXCEPTION acima para obter detalhes.

Se o identifier-1 for maior que o documento XML gerado, apenas a parte do identifier-1 em que o XML é gerado será alterada.
O restante do identifier-1 contém os dados que estavam presentes antes desta execução da instrução XML GENERATE.
Para evitar consultar esses dados, inicialize o identifier-1 nos espaços antes da instrução XML GENERATE ou especifique a frase COUNT IN.

Se a frase COUNT IN for especificada, o identifier-3 conterá (após a execução da instrução XML GENERATE) o número total de posições de caracteres (unidades ou bytes de codificação UTF-16) gerados.
Você pode usar o identifier-3 como um campo de comprimento de modificação de referência para se referir à parte do identifier-1 que contém o documento XML gerado.

Após a execução da instrução XML GENERATE, o registro especial XML-CODE contém zero, o que indica conclusão bem-sucedida, ou um código de exceção diferente de zero.
Para obter detalhes, consulte Handling XML GENERATE exceptions no Enterprise COBOL Programming Guide.

A instrução XML PARSE também usa o registro especial XML-CODE.
Portanto, se você codificar uma instrução XML GENERATE no procedimento de processamento de uma instrução XML PARSE, salve o valor de XML-CODE antes que a instrução XML GENERATE execute e restaure o valor salvo após o término da instrução XML GENERATE.

Uma marca de ordem de bytes não é gerada para documentos XML que possuem codificação Unicode.



© Copyright IBM Corp.