FEPI START

Function

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. Up to 128 characters of user data can be passed to the transaction as part of the start data, as described in Start data below.

Syntax

Read syntax diagramSkip visual syntax diagramFEPI 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.
[[ Contents Previous Page | Next Page Index ]]