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.