ADD Function

Figure 1. Parameter List for ADD Function

┌─────────────────────────────┬────────────────────────────────────────¿
³ 0   X'01'                   ³ 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   00 00 00                ³ 24  String length                      ³
├─────────────────────────────┼────────────────────────────────────────´
³ 10  00                      ³ 25  String pointer                     ³
└─────────────────────────────┴────────────────────────────────────────Ù

0 X'01': Entry code indicating ADD function.
4 Data set name length.
5 Data set name pointer.
13 Control password pointer.: The control password is assigned when the data set is placed under protection for the first time. The pointer can be 3 bytes of binary zeros if the new 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. Zeros request that the catalog information be used.
20 Protection code.: A 1-byte number indicating the type of protection: X'00' indicates default protection (for the ADD function; the default protection 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 read only; and X'03' indicates that the data set can be read without a password, but a password is needed for write access. The PROTECT macro uses the protection code value, specified in the parameter list, to set the protection-mode indicator in the password record.
21 New password pointer.: If the data set is being placed under protection for the first time, the new password becomes the control password. If you are adding a secondary entry, the new password is different from the control 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 placed in the optional information field. If you do not want to add information, set this field to zero.