Update a record in a data set.

ISSUE REPLACE
>>-ISSUE REPLACE--DESTID(data-value)---------------------------->
>--+------------------------+----------------------------------->
'-DESTIDLENG(data-value)-'
>--+------------------------------------------------+----------->
'-VOLUME(data-value)--+------------------------+-'
'-VOLUMELENG(data-value)-'
>--FROM(data-area)--+--------------------+---------------------->
'-LENGTH(data-value)-'
>--+--------------------+--RIDFLD(data-area)-------------------->
'-NUMREC(data-value)-'
>--+-KEYLENGTH(data-value)--+-----------------------+-+--------->
| '-KEYNUMBER(data-value)-' |
'-RRN----------------------------------------------'
>--+---------+--+--------+-------------------------------------><
'-DEFRESP-' '-NOWAIT-'
Conditions:
FUNCERR, INVREQ, SELNERR, UNEXPIN
Description
ISSUE REPLACE updates (replaces) a record in either a relative
(addressed direct) or an indexed (keyed direct) data set in an outboard
controller.
Options
- DEFRESP
- specifies that all terminal control commands issued as a result of the
ISSUE REPLACE 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 that is to be written to the data set.
- KEYLENGTH(data-value)
- specifies the length (halfword binary value)
of the key specified in the RIDFLD option.
- KEYNUMBER(data-value)
- specifies the number, as a halfword binary value, of the index
to be used to locate the record.
There can be eight indexes (1 through 8).
The default is 1.
This option applies only to
DPCX/DXAM and is mutually exclusive with RRN.
- LENGTH(data-value)
- specifies the length (halfword binary value)
of the data to be written.
- NOWAIT
- specifies that the CICS task continues processing without waiting
for the ISSUE REPLACE 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 data set, specifies as a halfword binary value the number
of logical records to be replaced.
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 is replaced.
- RIDFLD(data-area)
- specifies the record identification field.
For a relative record data set, the RIDFLD option
specifies a fullword binary integer (the relative record number
of the record starting from zero); and the RRN option is used.
For an indexed data set, the RIDFLD option
specifies the key that is embedded in the data specified by the FROM
option.
The KEYLENGTH option is also required.
- 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.
If the option is not specified,
RIDFLD is assumed to specify a key.
- 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
- 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.
- 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.
- 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.
- UNEXPIN
- occurs when some unexpected or unrecognized information is received from
the outboard controller.
Default action: terminate the task abnormally.