EXCSATRD reply object (X'1443')

The EXCSATRD reply data object returns information about the IMS target DDM server, such as server name or the product release level, to the source DDM server.

Format

Read syntax diagramSkip visual syntax diagramDSSHDRLLCP EXTNAM SRVNAM SRVRLSLV SRVCLSNM

Parameters

DSSHDR
The 6-byte header that contains information about the data stream structure (DSS).
LL
The 2-byte specification of the length of the EXCSATRD reply object.
CP
X'1443', the 2-byte codepoint of the EXCSATRD reply object.
EXTNAM
Optional. The variable-length external name of the target DDM server. For the IMS target DDM server, the external name is the name of the job the IMS system creates or activates to run the DDM server. The EXTNAM parameter is used for tracing and problem determination. If the job name includes embedded blanks, the name must be enclosed in quotation marks within the data field. The maximum length of EXTNAM is 255 bytes. The codepoint is X'115E'.
SRVNAM
Optional. The variable-length name of the target DDM server specified as a character string. Returned for tracing and problem determination purposes. If the server name includes embedded blanks, the name must be enclosed in quotation marks. The maximum length is 255 bytes. The codepoint is X'116D'.
If the DDM server name includes embedded blanks, the name must be enclosed in quotation marks within the data field.
SRVRLSLV
Optional. The variable-length name of the product release level of the target DDM server. The SRVRLSLV parameter is used to ensure compatibility between the source server of the application program and the IMS target server. The maximum length of SRVRLSLV is 255 bytes. The codepoint is X'115A'.
SRVCLSNM
Specifies the DDM server class name, DFS, used by IMS. DFS is currently the only name supported by IMS. The SRVCLSNM enables the DRDA product-unique extension used by IMS.
The codepoint of SRVCLSNM is X'1147'. The variable-length DDM server class name is specified as a character string.

Usage

The distributed data management (DDM) architecture EXCSATRD reply object is returned by an IMS target server in response to an EXCSAT command. Unless errors occur, the EXCSATRD reply object is always the first reply command from the IMS target DDM server to the source DDM server.

If errors occur during the exchange of server attributes, the IMS target server responds to the EXCSAT command by issuing an error message instead of the EXCSATRD reply object.