Terminate APPC basic conversation abnormally (assembler-language
and C programs only).
GDS ISSUE ABEND (APPC basic)
>>-GDS ISSUE ABEND--CONVID(name)--CONVDATA(data-area)----------->
>--RETCODE(data-area)--+-------------+-------------------------><
'-STATE(cvda)-'
Description
GDS ISSUE ABEND causes an APPC basic
conversation to end immediately, regardless of the conversation state. The
partner transaction is informed.
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.
- 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 ABEND
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 the task,
or that is a relay link. |