When you create an ePortal server message for an OS 2200 Open DTP Data Source, the server message contains one or more special metadata fields. These metadata fields are in addition to the regular fields which carry user data. Your ePortal application can access metadata fields like any other field in an ePortal message. That is, you can access metadata fields in your Understanding Orchestration or using the code in your Getting Ready to Build a New Presentation Project. However, metadata fields will not appear in the data record accessed by your OS 2200 Open DTP application.
Below is a description of the different metadata fields found in an ePortal server message in an OS 2200 Open DTP Data Source:
tpservicename__ - This is a string representing the name of the Open DTP service to be invoked on the OS 2200 system. This metadata field exists if and only if the direction of the server message is Input or Input/Output. That is, this field exists only for records which may be sent to the OS 2200 system. If you leave this field blank, the default Open DTP Service Name is used.
tpurcode__ - This is an integer representing the application-defined code which is returned from the Open DTP service on the OS 2200 system. This value is found in tpurcode for code written in C and APPL-RETURN-CODE for code written in COBOL. This metadata field exists if and only if the direction of the server message is Output or Input/Output. That is, this field exists only for records which may be returned from the OS 2200 system.
tpfail__ - This is a Boolean value representing the failure or success of the Open DTP service on the OS 2200 system. If this field is True, then the Open DTP service returned the TPFAIL return code. If this field is False, then the Open DTP service returned the TPSUCCESS return code. This metadata field exists if and only if the direction of the server message is Output or Input/Output. That is, this field exists only for records which may be returned from the OS 2200 system.
Refer to the following topics for more information on configuring the Open DTP Service Name: