ISSUE ERASE
Delete a record from a data set.
Description
ISSUE ERASE deletes a record from a keyed direct data set in an outboard controller, or erases a record from a DPCX or DXAM relative record data set.
Options
- DEFRESP
- specifies that all terminal control commands issued as a result of the ISSUE ERASE 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.
- KEYLENGTH(data-value)
- specifies the length of the key specified in the RIDFLD option, as a halfword binary value.
- 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–8). The default is 1. This option applies only to DPCX or DXAM and is mutually exclusive with RRN.
- NOWAIT
- specifies that the CICS task continues processing without waiting for the ISSUE ERASE 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 deleted. 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 deleted.
- 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. The KEYLENGTH option is also required.
- RRN
- specifies that the record identification field specified in the RIDFLD option contains a relative record number. 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
- 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.
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.