Parameters passed to the exit program

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.

Information Information

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///dwwig/dwwig000326.html