FEPI SEND FORMATTED

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) z/OS® Communications Server VTAM® SEND has been accepted.

Syntax

FEPI SEND FORMATTED

Notes:

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: z/OS Communications Server 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.