Add a record to a data set.
ISSUE ADD
>>-ISSUE ADD--DESTID(data-value)--+------------------------+---->
'-DESTIDLENG(data-value)-'
>--VOLUME(data-value)--+------------------------+--------------->
'-VOLUMELENG(data-value)-'
>--FROM(data-area)--+--------------------+---------------------->
'-LENGTH(data-value)-'
>--+--------------------+--+---------+--+--------+-------------->
'-NUMREC(data-value)-' '-DEFRESP-' '-NOWAIT-'
>--+------------------------+----------------------------------><
'-RIDFLD(data-area)--RRN-'
Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN
Description
ISSUE ADD adds records to a sequential
or keyed direct data set in an outboard controller. The FROM option is used
to specify the data to be written, and the LENGTH option specifies its length.
The
RIDFLD option is only needed with this command when it applies to a DPCX/DXAM
data set. In this case, it specifies the relative record number of the record
to be added. When RIDFLD is used, NUMREC must be 1 (the default).
Options
- DEFRESP
- specifies
that all terminal control commands issued as a result of the ISSUE ADD command
are to 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
the length (halfword binary value) of the data to be written. For a description
of a safe upper limit, see LENGTH options in CICS commands.
- NOWAIT
- specifies
that the CICS task continues processing without waiting for the ISSUE ADD
command to complete. If this option is not specified, the task activity is
suspended until the command is completed.
- NUMREC(data-value)
- for
a relative record data set, specifies as a halfword binary value the number
of logical records to be added. Records are replaced sequentially starting
with the one identified by the RIDFLD option.
For an indexed data set,
NUMREC cannot be specified because only one record can be added.
- RIDFLD(data-area)
- specifies,
for a relative record data set, a 4-character field as the relative record
number (starting from zero) of the record. The RRN option is also required.
For a keyed direct data set, RIDFLD should specify a key.
- RRN
- specifies
that the record identification field specified in the RIDFLD option contains
a relative record number. This option is required for a relative record data
set.
- 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 (halfword binary value) of the name specified in the VOLUME option.
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.
- 16 INVREQ
- RESP2
values:
- 200
- A distributed program link server application specified the function-shipping
session (its principal facility) on the CONVID option.
- 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.