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 justified 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-number
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, described below.
- 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.