ISSUE SIGNAL (APPC)
Request change of direction from sending transaction on an APPC mapped conversation.
Description
ISSUE SIGNAL, in a transaction in receive mode, signals to the sending transaction that a mode change is needed. It raises the SIGNAL condition on the next SEND, RECEIVE, or CONVERSE command executed in the sending transaction, and a previously executed HANDLE CONDITION command for this condition can be used either to take some action, or to ignore the request.
Options
- CONVID(name)
- identifies
the conversation to which the command relates. The 4-character name
identifies either the token returned by a previously executed ALLOCATE
command in EIBRSRCE in the EIB, or the token representing the principal
facility (returned by a previously executed ASSIGN command).
For compatibility with earlier releases, SESSION is accepted as a synonym for CONVID. New programs should use CONVID.
If both CONVID and SESSION are omitted, the principal facility is assumed.
- 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
Conditions
- 16 INVREQ
- RESP2
values:
- 200
- A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option.
also occurs (RESP2 not set) in any of the following situations:- The command has been used on an APPC conversation that is not using the EXEC CICS interface, or is not a mapped conversation.
Default action: terminate the task abnormally.
- 61 NOTALLOC
- occurs
if the specified CONVID value does not relate to a conversation that
is owned by the application.
Default action: terminate the task abnormally.
- 81 TERMERR
- occurs
for a session-related error. Any action on that conversation other
than a FREE causes an ATCV abend.
A CANCEL TASK request by a user node error program (NEP) may cause TERMERR if the task has an outstanding terminal control request when the node abnormal condition program handles the session error.
Default action: terminate the task abnormally with abend code ATNI.