Inform an APPC basic conversation partner of an error
(assembler-language and C programs only).
GDS ISSUE ERROR (APPC basic)
>>-GDS ISSUE ERROR--CONVID(name)--CONVDATA(data-area)----------->
>--RETCODE(data-area)--+-------------+-------------------------><
'-STATE(cvda)-'
Description
GDS ISSUE ERROR informs the
conversation partner that there is an error.
The return code
is given in RETCODE, see below. 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.
- CONVDATA(data-area)
- specifies
the 24-byte application data area into which conversation-related
information is to be moved. A description of the format of the data
area is given in the discussion of CONVDATA fields in the Testing indicators .
- CONVID(name)
- identifies
the conversation to which the command relates. The 4-character name
identifies either the token returned by a previously executed GDS
ALLOCATE command, or the token representing the principal session
(returned by a previously executed GDS ASSIGN command).
- RETCODE(data-area)
- specifies
the 6-byte application data area into which return code information
(shown in Table 1) is to be moved.
- STATE(cvda)
- gets
the state of the current conversation. The cvda values returned by
CICS are:
- ALLOCATED
- CONFFREE
- CONFRECEIVE
- CONFSEND
- FREE
- PENDFREE
- PENDRECEIVE
- RECEIVE
- ROLLBACK
- SEND
- SYNCFREE
- SYNCRECEIVE
- SYNCSEND
Table 1. GDS ISSUE
ERROR return codesRETCODE (hexadecimal) |
Description |
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 08 |
A state check has occurred. |
04 |
CONVID is for a session that is not allocated
to task, or that is a relay link. |