GDS ASSIGN

Get the identifier of the principal facility in use by APPC basic conversation (assembler-language and C programs only).


GDS ASSIGN (APPC basic)

>>-GDS ASSIGN--+-----------------------+------------------------>
               '-PRINCONVID(data-area)-'   

>--+----------------------+--RETCODE(data-area)----------------><
   '-PRINSYSID(data-area)-'

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.

Table 1. GDS ASSIGN return codes
RETCODE (hexadecimal)	Description
03 00	Principal facility is not APPC.
03 04	Principal facility is not basic.
04	No terminal principal facility exists.

dfhp4_gdsassign.html | Timestamp icon

Last updated: Thursday, 27 June 2019