Input

z/OS Cryptographic Services ICSF System Programmer's Guide

Input

z/OS Cryptographic Services ICSF System Programmer's Guide
SA22-7520-17

The single-record, read-write exit receives the address of the address list passed in register 1. The first address in the address list is for the read-write exit parameter block (RWXP). The exit does not receive a parameter list. Entry and return specifications gives a complete list of the registers on entry to the single-record, read-write exit.

The RWXP parameter block contains the address of the CKDS or PKDS record that is being processed and information about the situation in which the exit is called. The exit sets a return code in a field in the block to specify whether the processing should continue. Table 20 describes the RWXP control block.

Table 20. RWXP Control Block Format
Offset (Dec)	Number of Bytes	Description
0	4	Name. The name of the control block. The field contains the character string `RWXP`.
4	2	Version. The version of the control block. The field contains the character string `02`.
6	2	Length. The length of the control block. The value of this field is 28 in decimal.
8	4	Return Code. The value the exit returns. Valid decimal values for this field are: Return Code Description 0 Process current CKDS record 4 Do not process current CKDS record 8 End processing
12	4	Address of the CKDS record.
16	4	The value in decimal of the length of the CKDS record.
20	7	Action. The field is a 7-byte character string describing the action performed on the CKDS record. The field can contain these values: `READ` `WRITE` `DELETE` Note that the value of the field is left-justified and padded with blanks.
27	1	Exit Invocation Reason The reason that the exit was invoked. The field relates to only the CKDS and can contain one of these values: 2 Refresh of the in-storage CKDS with a disk copy of a CKDS. The value of the Action field is READ. 3 Reencipher of the in-storage CKDS from a disk copy of a CKDS. The value of the Action field is READ or WRITE. 5 Conversion record postprocessing. The value of the Action field is WRITE. 8 Key entry hardware input. The value of the Action field is READ or WRITE.
28	4	Data set type (either CKDS or PKDS).

Notices | Terms of use | Support | Contact z/OS | zFavorites