FEPI SEND FORMATTED

Function

This command is for SLU2 mode only.

FEPI SEND FORMATTED sends application data to a target. The data supplied by the application must be formatted data, as key strokes or as a screen image. Full details about the data are given in Data formats.

The command completes as soon as the (first) VTAM SEND has been accepted.

Syntax

Read syntax diagramSkip visual syntax diagramFEPI SEND FORMATTED
 
>>-FEPI SEND FORMATTED--CONVID(data-value)--FROM(data-value)---->
 
>--+---------------------+-------------------------------------->
   '-FLENGTH(data-value)-'
 
>--+-AID(data-value)--+--------------------+-+-----------------><
   |                  '-CURSOR(data-value)-' |
   '-KEYSTROKES--+--------------------+------'
                 '-ESCAPE(data-value)-'
 

Options

AID(1-character data-value)
specifies the attention identifier value to send with the data. Specifying AID also indicates that the data to send is in screen-image format, as described in Data formats. A value of null (X'00') may be specified to indicate that no attention is to be sent, and that a further FEPI SEND is to follow.

Symbolic names for the AID values are available for the supported languages in the language-specific DFHAID copybooks.

CONVID(8-character data-value)
specifies the ID of the conversation to use. The conversation must be owned by the task issuing the command.
CURSOR(fullword binary data-value)
for send data in screen-image format, specifies the position of the cursor, expressed as an offset from the start of the screen image; offset zero is the top left-hand corner of the screen. If CURSOR is not specified, the cursor remains where it was positioned by the last inbound data.
ESCAPE(1-character data-value)
for send data in key stroke format, specifies the escape character used to indicate character combinations representing special keys. You can use any value in the range X'40' through X'FE'. The default escape character is & (X'50').
FLENGTH(fullword binary data-value)
specifies the length of the data to send; that is, the length of the data area identified by the FROM option. It must not be zero or more than the maximum length allowed for the pool.
FROM(data-value)
specifies the data to send to the back-end application. Its length is specified by the FLENGTH option. For send data in screen-image format, if the length is more than the screen image, the additional data is ignored; if it is less, the data is the first part of the screen image, and the last part of the screen image is not changed.
KEYSTROKES
specifies that the data to send is in key stroke format, a sequence of key strokes, as described in Data formats.

Conditions

The INVREQ condition can have the following RESP2 values:

RESP2
Meaning
40
FLENGTH value negative or more than maximum allowed for the current pool.
41
ESCAPE value not valid.
50
Inbound data with ‘begin bracket’ to be received.
51
AID value not valid.
52
Cursor position not valid.
53
Character values in send data not valid.
54
Attribute positions or values in send data not valid.
55
Key stroke escape sequence in send data not valid.
56
Field validation (mandatory fill, mandatory error, trigger) failed.
57
Input inhibited.
58
VTAM SEND failed.
59
DBCS data rules violated.
210
Command not allowed for SLU P mode.
212
Conversation has wrong data format.
215
Session lost.
220
FEPI SEND 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.
[[ Contents Previous Page | Next Page Index ]]