The parameters that are passed to the exit program.
- Data set name
- The data set name is dependent on these error types:
- 01-02
- Shows that the data set name is for a log
- 11–14, 16, 17
- Shows that the data set name is for the original VSAM base cluster
- 15
- Shows that the data set name is for a VSAM path
The field is left-aligned and is padded with blanks.
- Error type
- A 2-byte character field that tells the exit which type of I/O
processing was occurring when the error occurred. It can contain:
- 01
- Log physical read
- 02
- Log logical read
- 11
- VSAM GET
- 12
- VSAM PUT (new)
- 13
- VSAM PUT (update)
- 14
- VSAM ERASE
- 15
- VSAM GET on a path
- 17
- VSAM ERASE when the relative byte address (RBA) already exists
- Error information
- A character field that provides information about the error.
For
error type 01 (a log physical-read error), it is a 78-byte character
field, containing bytes 50–127 of the SYNADF message buffer. This
buffer contains information such as the ddname and error description.
For
error type 02 (a log logical-read error), it is a 4-byte binary field
that contains the current block ID count while reading forward or
backward.
For error types 11–15 (a VSAM error), it is an 8-byte
character field, containing:
- Bytes 0–1
- The second byte from the feedback field in the VSAM request parameter
list (RPL). This field contains the return code (register 15). The
contents are related to bytes 2–3, are described as follows:
- Bytes 2–3
- The last 2 bytes from the feedback field in the VSAM RPL. This
field contains the VSAM function code and feedback code.
- Byte 4
- A 1-character code indicating log type:
- 3
- Indicates a CICS/ESA V4R1 log
- Byte 5
- A 1-character code showing the status of the sphere being recovered:
- N
- The sphere was restored from a normal backup copy.
- B
- The sphere was restored from a copy made using the backup-while-open
facility.
- Bytes 6–7
- Not used.
For error type 16 (a VSAM insert error to an ESDS
base), it is a 4-byte binary field containing the actual RBA used
on the VSAM file. This error type only occurs when you are recovering
from a CICS/ESA V4R1 log where the logged RBA differs from the real
RBA.
Note: The record has been appended to the file.
- Length of error data
- A fullword containing the length of the error data parameter.
- Error data
- Contains more data about the error.
For error types 01 and
02 (a log read error), this field contains the last log record that
was read successfully.
For error types 11 and 15 (a VSAM GET
error) and error type 14 (a VSAM delete error), it contains the key
of the record to retrieve.
For error types 12, 13, and 16 (a
VSAM insert or update error), it contains the record to process.
- Work area
- A 128-byte work area that can be used to pass information between
exit programs. See the description in Parameters.