ISSUE SIGNAL
Requests a change of direction from sending transaction on an advanced program-to-program communications (APPC) mapped conversation. (An APPC conversation allows a program to send data to, and receive data from, a program that is running in a remote system. Programming that uses APPC conversations is called Distributed Transaction Programming (DTP). For guidance information about DTP, see Distributed transaction processing (DTP).)
Syntax
Description
ISSUE SIGNAL raises the SIGNAL condition on the next SEND, RECEIVE, or CONVERSE command that is executed in the remote transaction.
For COBOL programs only, 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 four-byte name identifies
either the token that is returned by a previously executed ALLOCATE command
in the EIBRSRCE field of the EXEC Interface Block (EIB), or the token that
represents the principal facility (that was returned by a previously executed
ASSIGN command).
If this option is omitted, the principal facility is assumed.
- STATE(cvda)
- Gets the state of the current conversation.
Conditions
- INVREQ
- Occurs
for the following conditions, depending on the options that are specified
on the ISSUE SIGNAL command:
- The CONVID option is omitted and the principal facility is not an APPC conversation.
- A remotely linked-to program attempted to execute an ISSUE SIGNAL command that refers to the principal facility.
Default action: Terminates the task abnormally.
- NOTALLOC
- Occurs
if the specified CONVID value does not relate to a conversation that is owned
by the application.
Default action: Terminates the task abnormally.
- TERMERR
- Occurs
if a session-related error occurs. Any subsequent action on that conversation
other than a FREE command causes an ATCV abend.
Default action: Terminates the task abnormally (with abend code ATNI).