REPLACE Function

Figure 1. Parameter List for REPLACE Function

┌─────────────────────────────┬────────────────────────────────────────¿
³ 0   X'02'                   ³ 13  Control password pointer           ³
├─────────────────────────────┼────────────────────────────────────────´
³ 1   00 00 00                ³ 16  Number of volumes                  ³
├─────────────────────────────┼────────────────────────────────────────´
³ 4   Data set name length    ³ 17  Volume list pointer                ³
├─────────────────────────────┼────────────────────────────────────────´
³ 5   Data set name pointer   ³ 20  Protection code                    ³
├─────────────────────────────┼────────────────────────────────────────´
³ 8   00                      ³ 21  New password pointer               ³
├─────────────────────────────┼────────────────────────────────────────´
³ 9   Current password pointer³ 24  String length                      ³
├─────────────────────────────┼────────────────────────────────────────´
³ 12  00                      ³ 25  String pointer                     ³
└─────────────────────────────┴────────────────────────────────────────Ù

0 X'02'.: Entry code indicating REPLACE function.
4 Data set name length.
5 Data set name pointer.
9 Pointer to current password.: The address of the password that is going to be replaced.
13 Control password pointer.: The address of the password assigned to the data set when it was first placed under protection. The pointer can be set to 3 bytes of binary zeros if the current password is the control password.
16 Number of volumes.: If the data set is not cataloged, to have it flagged as protected, specify the number of volumes in this field. A zero requests that the catalog information be used.
17 Volume list pointer.: If the data set is not cataloged, to have it flagged as protected, provide the address of a list of volume serial numbers in this field. If this field is zero, the catalog information is used.
20 Protection code.: A 1-byte number indicating the type of protection: X'00' indicates default protection (for the REPLACE function the default is the type of protection specified in the control password record of the data set); X'01' indicates that the data set is to be read and written; X'02' indicates that the data set is to be read only; and X'03' indicates that the data set can be read without a password, but a password is needed for write access.
21 New password pointer.: The address of the password to be used to replace the current password.
24 String length.: The length of the character string (maximum 77 bytes) to be placed in the optional information field of the password record. If you do not want to add information, set this field to zero.
25 String pointer.: The address of the character string to be placed in the optional information field. If you do not want to add information, set this field to zero.