FEPI START
FEPI START is used to relinquish control of a conversation and to specify a new transaction to be started when the next inbound data arrives.
A maximum of 128 characters of user data can be passed to
the transaction as part of the start data, as described in Start data below.
Syntax
FEPI START >>-FEPI START--CONVID--(--data-value--)-------------------------> >--TRANSID--(--data-value--)--+--------------------------+------> '-TERMID--(--data-value--)-' >--+-----------------------------------------------------------+--> '-USERDATA--(--data-value--)--+---------------------------+-' '-FLENGTH--(--data-value--)-' >--+---------------------------+------------------------------->< '-TIMEOUT--(--data-value--)-'
Options
- CONVID(8-character data-value)
- specifies the ID of the conversation to suspend. The conversation must be owned by the task issuing the command.
- FLENGTH(fullword binary data-value)
- specifies the length of the optional user data to pass to the transaction that is started; that is, the length of the data area identified by the USERDATA option. The FLENGTH value must not be greater than 128.
- TERMID(4-character data-value)
- specifies the name of the terminal, if any, to be associated with the transaction that is started.
- TIMEOUT(fullword binary data-value)
- specifies the maximum time in seconds that FEPI is to wait for inbound data to begin to arrive before starting the transaction. If TIMEOUT is not specified or the specified time is zero, the command is not timed out.
- TRANSID(4-character data-value)
- specifies the name of the transaction that is to be started when the next inbound data arrives.
- USERDATA(data-value)
- specifies optional user data to pass to the transaction that is started, in addition to control information passed by FEPI. Its length is specified by the FLENGTH option.
Conditions
The INVREQ condition can have the following RESP2 values:
- RESP2
- Meaning
- 61
- FLENGTH value negative or too large.
- 62
- TRANSID name not valid.
- 63
- TERMID name not valid.
- 214
- CICS shutting down, conversation should be ended.
- 215
- Session lost.
- 216
- Error occurred on previous FEPI SEND.
- 223
- FEPI START not allowed at this point in the conversation.
- 224
- Only FEPI ISSUE or FEPI FREE commands allowed at this point in the conversation.
- 230
- SNA CLEAR command received.
- 231
- SNA CANCEL command received.
- 232
- SNA CHASE command received.
- 233
- Exception response received.
- 234
- Exception request received.
- 240
- Conversation ID not owned by this task.
- 241
- TIMEOUT value negative or not valid.
