ISSUE SEND

Send data to a named data set or to a selected medium.

ISSUE SEND

Read syntax diagramSkip visual syntax diagramISSUE SENDDESTID( data-value)DESTIDLENG( data-value)SUBADDR( data-value)CONSOLEPRINTCARDWPMEDIA1WPMEDIA2WPMEDIA3WPMEDIA4VOLUME( data-value)VOLUMELENG( data-value)FROM( data-area)LENGTH( data-value)NOWAITDEFRESP

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.