GDS ASSIGN
Get the identifier of the principal facility in use by APPC basic conversation (assembler-language and C programs only).
Description
GDS ASSIGN gets the identifier of the principal facility.
The return code is given in RETCODE (see Table 1). For a list of return code values, see the Return codes for APPC basic conversations. EXEC CICS® conditions are never raised on GDS commands.
Options
In general, the arguments can be replaced by absolute or relocatable assembler-language expressions.
- PRINCONVID(data-area)
- specifies a 4-byte data area in which the conversation token (CONVID) of the principal facility is to be returned.
- PRINSYSID(data-area)
- specifies a 4-byte data area in which the SYSID of the principal facility is to be returned.
- RETCODE(data-area)
- specifies the 6-byte application data area into which return code information ( shown in Table 1) is to be moved.
RETCODE (hexadecimal) | Description |
---|---|
03 00 | Principal facility is not APPC. |
03 04 | Principal facility is not basic. |
04 | No terminal principal facility exists. |