En este tema se describe cómo los usuarios de Enterprise Service Tools pueden anotar definiciones de datos para proporcionar información de la interfaz de servicio y su personalización.
Más específicamente, la función de anotaciones proporciona la posibilidad que actualmente proporcionan los elementos ItemExclusionArray, ItemSelectionArray y XMLNamesArray de los archivos de opciones del procesador por lotes, permite al usuario excluir (ItemExclusionArray), incluir (ItemSelectionArray) y renombrar (XMLNamesArray) explícitamente los elementos que desee en la interfaz de servicio generada.
LINKAGE SECTION. 1 department. 2 member-count pic 9(9) binary. 2 member-details occurs 5 times. 3 first-name pic x(35). 3 last-name pic x(45). 3 contact-phone pic x(25). 3 contact-address pic x(75). 3 promotion-level pic x(20). 3 last-promotion-date pic x(10). 3 salary pic x(3).
<OutputMessage importFile="samp.cpy" importDirectory="C:/Source" nativeTypeName="department">
<ItemExclusionArray>
<ExcludeItem itemName="department.member-details.salary"/>
</ItemExclusionArray>
<XMLNamesArray>
<XMLNameSelection itemName="first-name" XmlName="FirstName"/>
</XMLNamesArray>
</OutputMessage>
La anotación del origen de estructura de datos permite a los usuarios especificar un tipo similar de información directamente en el origen de la declaración de datos en lugar de hacerlo en un archivo de configuración de opciones del procesador por lotes. Este método conserva la especificación de interfaz de servicio y la interfaz real en un archivo origen individual.
@ANN *OMIT salary
@ANN *OLDNAME first-name
@ANN *NEWAME FirstName
@ANN *OPTIONAL FirstName
LINKAGE SECTION.
1 department.
2 member-count pic 9(9) binary.
2 member-details occurs 5 times.
3 first-name pic x(35).
3 last-name pic x(45).
3 contact-phone pic x(25).
3 contact-address pic x(75).
3 promotion-level pic x(20).
3 last-promotion-date pic x(10).
3 salary pic x(3).