Initiate an APPC basic conversation (assembler-language and C programs only).
GDS CONNECT PROCESS (APPC basic) >>-GDS CONNECT PROCESS--CONVID(name)----------------------------> >--+-PROCNAME(name)--+------------------------+-+---------------> | '-PROCLENGTH(data-value)-' | '-PARTNER(name)------------------------------' >--+-----------------------------------------------+------------> '-PIPLIST(data-area)--+-----------------------+-' '-PIPLENGTH(data-value)-' >--SYNCLEVEL(data-value)--CONVDATA(data-area)-------------------> >--RETCODE(data-area)--+-------------+------------------------->< '-STATE(cvda)-'
EXEC CICS® conditions are never raised on GDS commands.
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.
GDS CONNECT PROCESS allows the application program to specify a partner application that is to run in the remote system.
In general, the arguments can be replaced by absolute or relocatable assembler-language expressions.
RETCODE (hexadecimal) | Description |
---|---|
02 0C 00 | PARTNER is not known. |
03 00 | CONVID is for a session that is not APPC. |
03 00 | CONVID is for a session that is in use by CPI Communications. |
03 04 | CONVID is for a conversation that is not basic. |
03 0C | The SYNCLEVEL option specifies a value other than 0, 1, or 2. |
03 0C | The SYNCLEVEL option requested either 1 or 2, but it was unavailable. |
03 08 | A state check occurred. |
04 | CONVID is for a session that is not allocated to the task, or that is a relay link. |
05 00 00 00 00 20 | PROCLENGTH is outside the range 1–64. |
05 00 00 00 7F FF | The PIPLENGTH value is outside the range 4–763. |
05 00 00 00 7F FF | The 2-byte length field (LL) for one of the PIPs is less than 4. |
05 00 00 00 7F FF | The total of the LLs in PIP data is greater than the PIPLENGTH value. |