Common options used on the SEND command (non-z/OS® Communications Server).
Options
- ALTERNATE
- sets the terminal to use the
ALTERNATE screen size.
- ASIS
- indicates that output is to
be sent in transparent mode (with no recognition of control characters
and accepting any of the 256 possible combinations of eight bits as
valid transmittable data).
Note: If
you are using a katakana terminal, you might see some messages containing
mixed English and katakana characters. That is because katakana terminals
cannot display mixed-case output. Uppercase characters in the data
stream appear as uppercase English characters, but lowercase characters
appear as katakana characters. If this happens, ask your system programmer
to specify MSGCASE=UPPER in the system initialization parameters so
that messages contain uppercase characters only.
- ATTACHID(name)
- specifies that an attach header
(created by a BUILD ATTACH command) is to precede, and be concatenated
with, the user data supplied in the FROM option. “name” (1–8 characters)
identifies the attach header control block to be used in the local
task.
- CBUFF
- specifies that data is to be
written to a common buffer in a 2972 control unit. The WAIT option
is implied.
- CNOTCOMPL
- indicates that the request/response
unit (RU) sent as a result of this SEND command does not complete
the chain. If this option is omitted and chain assembly has been specified,
the RU terminates the chain.
- CTLCHAR(data-value)
- specifies a 1-byte write control
character (WCC) that controls a SEND command for a 3270. These are
documented in the IBM® 3270
Data Stream Programmer's Reference. A COBOL user must specify
a data area containing this character. If the option is omitted, all
modified data tags are reset to zero and the keyboard is restored.
- DEFAULT
- sets the terminal to use the
DEFAULT screen size.
- DEFRESP
- indicates that a definite response
is required when the output operation has been completed.
- ERASE
- specifies that the screen printer
buffer or partition is to be erased and the cursor returned to the
upper left corner of the screen. (This option applies only to the
3270, or 8775, and to the 3604 Keyboard Display.)
The first output
operation in any transaction, or in a series of pseudoconversational
transactions, should always specify ERASE. For transactions attached
to 3270 screens or printers, unless explicitly overridden by the
DEFAULT or ALTERNATE option, this also ensures that the correct screen
size is selected, as defined for the transaction by the SCRNSIZE option
in the RDO PROFILE resource definition.
- FLENGTH(data-value)
- A fullword alternative to LENGTH.
- FMH
- specifies that a function management
header has been included in the data in the FROM area. If the ATTACHID
option is specified as well, the concatenated FMH flag is set in the
attach FMH.
- FROM(data-area)
- specifies the data to be written
to the logical unit or terminal.
- INVITE
- specifies that the next terminal
control command to be executed for this facility is a RECEIVE. This
allows optimal flows to occur.
- LAST
- specifies that this is the
last output operation for a transaction and therefore the end of a
bracket.
- LEAVEKB
- specifies that the keyboard
is to remain locked at the completion of the data transfer.
- LENGTH(data-value)
- specifies the length, as a
halfword binary value, of the data to be written. For a description
of a safe upper limit, see LENGTH options in CICS commands.
- LINEADDR(data-value)
- specifies that the writing
is to begin on a specific line of a 2260/2265 screen. The data value
is a halfword binary value in the range 1 through 12 for a 2260, or
1 through 15 for a 2265.
- PASSBK
- specifies that communication
is with a passbook. The WAIT option is implied.
- PSEUDOBIN (start-stop only)
- specifies that the data being
written is to be translated from System/7 hexadecimal to pseudobinary.
- SESSION(name)
- specifies the symbolic identifier
(1–4 characters) of a session TCTTE. This option specifies the alternate
facility to be used. If this option is omitted, the principal facility
for the task is used.
- STATE(cvda)
- gets
the state of the transaction program. The cvda values returned by CICS® are:
- ALLOCATED
- FREE
- PENDFREE
- RECEIVE
- ROLLBACK
- SEND
- SYNCFREE
- SYNCRECEIVE
- SYNCSEND
- STRFIELD
- specifies that the data area
specified in the FROM option contains structured fields. If this option
is specified, the contents of all structured fields must be handled
by the application program. The CONVERSE command, rather than a SEND
command, must be used if the data area contains a read partition structured
field. (Structured fields are described in the CICS 3270 Data Stream Device Guide.)
CTLCHAR and ERASE are mutually exclusive with STRFIELD, and their
use with STRFIELD generates an error message.
- WAIT
- specifies that processing of
the command must be completed before any subsequent processing is
attempted.
If the WAIT option is not specified, control is returned
to the application program when processing of the command has started.
A subsequent input or output request (terminal control, BMS, or batch
data interchange) to the terminal associated with the task causes
the application program to wait until the previous request has been
completed.
Conditions
- 62 CBIDERR
- occurs if the requested attach
header control block named in ATTACHID cannot be found.
Default
action: terminate the task abnormally.
- 16 INVREQ
- RESP2 values:
- 200
- occurs if a distributed program link server application attempted
to send on its function-shipping session (its principal facility)
Default action: terminate the task abnormally.
- 22 LENGERR
- occurs if an out-of-range value
is supplied in the LENGTH or FLENGTH option.
Default action: terminate
the task abnormally.
- 51 NOPASSBKWR
- occurs if no passbook is present.
Default action: terminate the task abnormally.
- 61 NOTALLOC
- occurs if the facility specified
in the command is not owned by the application.
Default action:
terminate the task abnormally.
- 81 TERMERR
- occurs for a terminal-related
error, such as a session failure. This condition applies to z/OS Communications Server-connected
terminals only.
A CANCEL TASK request by a user node error
program (NEP) may cause this condition if the task has an outstanding
terminal control request active when the node abnormal condition program
(DFHZNAC) handles the session error.
Default action: terminate
the task abnormally with abend code ATNI.
- 03 WRBRK
- occurs if the command is terminated
by the attention key.
Default action: ignore the condition.