Send data to a named data set or to a selected medium.
ISSUE SEND
>>-ISSUE SEND--------------------------------------------------->
>--+------------------------------------------------+----------->
+-DESTID(data-value)--+------------------------+-+
| '-DESTIDLENG(data-value)-' |
| .-CONSOLE--. |
'-SUBADDR(data-value)--+----------+--------------'
+-PRINT----+
+-CARD-----+
+-WPMEDIA1-+
+-WPMEDIA2-+
+-WPMEDIA3-+
'-WPMEDIA4-'
>--+------------------------------------------------+----------->
'-VOLUME(data-value)--+------------------------+-'
'-VOLUMELENG(data-value)-'
>--FROM(data-area)--+--------------------+--+--------+---------->
'-LENGTH(data-value)-' '-NOWAIT-'
>--+---------+-------------------------------------------------><
'-DEFRESP-'
Conditions:
FUNCERR, IGREQCD, INVREQ, SELNERR, UNEXPIN
Description
ISSUE SEND sends data to a named data set in an outboard
controller, or to a selected medium in a batch logical unit or an
LUTYPE4 logical unit.
The options CONSOLE, PRINT, CARD, and WPMEDIA1–4 are
alternatives to DESTID and DESTIDLENG.
Options
- CARD
- specifies that the output medium is a card reader or card
punch device.
This option is not valid with DESTID and DESTIDLENG.
- CONSOLE
- specifies that the output medium is that provided for messages to the
operator.
This option is not valid with DESTID and DESTIDLENG.
This refers to a programmable subsystem such as the
IBM® 3790 data communication system.
It does not refer to a CICS® or system console.
- DEFRESP
- specifies that all terminal control commands issued as a result of the
ISSUE SEND command request a definite response from the
outboard batch program, irrespective of the specification of message
integrity for the CICS task (by the system programmer).
- DESTID(data-value)
- specifies the name
(1–8 characters)
of the data set in the outboard destination.
- DESTIDLENG(data-value)
- specifies the length (halfword binary value)
of the name specified in the DESTID option.
- FROM(data-area)
- specifies the data to be written to the data set.
- LENGTH(data-value)
- specifies a halfword binary value
that is the length of the data to be written.
- NOWAIT
- specifies that the CICS task continues processing without waiting
for the ISSUE SEND command to complete.
If this option is
not specified, the task activity is suspended until the command is
completed.
- PRINT
- specifies that the output is to the print medium.
- SUBADDR(data-value)
- specifies the medium subaddress as a halfword binary
value (in the range 0–15)
that allows media of the same type, for example, “printer
1” or “printer 2”, to be defined.
Value 15 means a medium of any type.
The default is zero.
- VOLUME(data-value)
- specifies the name
(1–6 characters)
of a diskette in an outboard destination that
contains the data set specified in the DESTID option.
- VOLUMELENG(data-value)
- specifies the length of the name specified in the VOLUME option as a
halfword binary value.
- WPMEDIA1 through WPMEDIA4
- specifies that for each specific LUTYPE4 device, a word processing
medium is defined to relate to a specific input/output device.
Conditions
- 48 FUNCERR
- occurs if there is an error during execution of the command.
Destination selection is unaffected and other commands for the same
destination may be successful.
Default action: terminate the task abnormally.
- 57 IGREQCD
- occurs when an attempt is made to execute an ISSUE SEND command after a
SIGNAL RCD data-flow control code has been received from an LUTYPE4
logical unit.
Default action: terminate the task abnormally.
- 16 INVREQ
- RESP2 values:
- 200
- A distributed program link server application specified
the function-shipping session (its principal facility)
on the CONVID option.
Default action: terminate the task abnormally.
- 47 SELNERR
- occurs if there is an error during destination selection.
The destination is not selected and other commands for the same
destination are unlikely to be successful.
Default action: terminate the task abnormally.
- 49 UNEXPIN
- occurs when some unexpected or unrecognized information is received from
the outboard controller.
Default action: terminate the task abnormally.