Acquire a session to a remote system for use by APPC basic conversation (assembler-language and C programs only).
GDS ALLOCATE (APPC basic) >>-GDS ALLOCATE--+-SYSID(systemname)--+----------------+-+------> | '-MODENAME(name)-' | '-PARTNER(name)-------------------------' >--CONVID(data-area)--RETCODE(data-area)--+---------+-----------> '-NOQUEUE-' >--+-------------+--------------------------------------------->< '-STATE(cvda)-'
GDS ALLOCATE acquires a session to a remote system.
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.
In general, the arguments can be replaced by absolute or relocatable assembler-language expressions.
The return code in RETCODE indicates whether or not a session has been acquired.
If there is a delay, the program waits until the session has been acquired.
If you use this option as an alternative to SYSID and MODENAME, CICS uses the NETNAME and MODENAME from the PARTNER definition.
RETCODE (hexadecimal) | Description |
---|---|
01 0C 00 | SYSID is unrecognized. |
01 0C 04 | SYSID is not an LUTYPE6.2 connection name. |
01 04 04 | NOQUEUE is specified but no bound connection-winner sessions are available. |
01 04 08 | MODENAME is not known. |
01 04 0C | The MODENAME value is SNASVCMG which is restricted to use by CICS. |
01 04 0C | z/OS® Communications Server has no class of service (COS) table for the MODENAME value. |
01 04 10 | The task was canceled during queuing of the command. |
01 04 14 | All modegroups are closed. |
01 04 14 | The requested modegroup is closed. |
01 04 18 | The requested modegroup is draining (closing down). |
01 08 00 | All sessions in the requested modegroup are unusable. |
01 08 00 | The connection is in quiesce state. |
01 08 00 | The connection is out of service. |
01 08 00 | The connection is not acquired. |
01 08 00 | The requested modegroup's local max (maximum permitted number of sessions) is 0. |
01 08 00 | The VTAM® ACB is closed. |
01 0C 14 | The NETNAME specified in the PARTNER definition is not known. |
02 0C 00 | PARTNER is not known. |
06 00 00 | The PROFILE specified in the PARTNER definition is not known. |