IRRPRMxx parmlib parameter syntax

The IRRPRMxx parmlib parameter syntax is as follows:
DATABASE_OPTIONS
     SYSPLEX(NOCOMMUNICATIONS | COMMUNICATIONS | DATASHARING)
     DATASETNAMETABLE
       ENTRY
         PRIMARYDSN(data-set-name)
         BACKUPDSN(data-set-name)
         UPDATEBACKUP(ALL | NONE | NOSTATS)
         BUFFERS(value)
     RANGETABLE
       START(start-value [CHAR | HEX]) ENTRYNUMBER(entry-sequence-number)
The IRRPRMxx parmlib parameter descriptions are as follows:
DATABASE_OPTIONS
Header statement for the RACF® initialization portion of the parmlib member. This parameter is required for each parmlib member that is processed.
SYSPLEX
Specifies the sysplex environment that you want.
NOCOMMUNICATIONS | NOCOMM
Specifies that RACF is not enabled for sysplex communications.
COMMUNICATIONS | COMM
Specifies that RACF is enabled for sysplex communications and requests non-data sharing mode at IPL.
DATASHARING
Specifies that RACF is enabled for sysplex communications and requests data sharing mode at IPL.

This parameter is optional. If not specified, SYSPLEX(NOCOMMUNICATIONS) is the default value.

DATASETNAMETABLE | DSNT
Header statement that marks the beginning of the data set name table. This table can contain multiple entries. The maximum is 90 primary and backup data set pairs.

This parameter is required when defining a data set name table. It is optional if the default data set name table is sufficient. The default data set name table includes a single primary and backup data set pair, for which the operator is prompted. This dataset pair has a default of 255 resident data blocks for buffers and no data duplication to the backup data set.

ENTRY
Header statement that marks the beginning of a single primary and backup data set pair in the data set name table. There can be multiple ENTRY statements to mark each primary and backup data set pair.

This parameter is required for each entry in the data set name table.

PRIMARYDSN(data-set-name) | PRIMARY(data-set-name) | PRIM(data-set-name)
Specifies the name of a primary data set. The data set name must follow data set naming conventions. It can either be a quoted string or an unquoted string. If the data set name is an asterisk, the operator is prompted for a data set name at initialization time.

This parameter is optional. If not specified, the operator is prompted for a primary data set name.

BACKUPDSN(data-set-name) | BACKUP(data-set-name) | BACK(data-set-name)
Specifies the name of a backup data set. The data set name must follow data set naming conventions. It can either be a quoted string or an unquoted string. If the data set name is an asterisk, the operator is prompted for a data set name at initialization time. If the data set name is a blank, the backup is not defined and the operator is not prompted.

This parameter is optional. If not specified, the operator is prompted for a backup data set name.

UPDATEBACKUP | UPDATEBACK
Specifies the update option that you want for the backup data set.
ALL
All updates, including statistics, are to be duplicated on the backup data set.
NONE
No updates are to be duplicated on the backup data set.
NOSTATS
All updates, but no statistics, are to be duplicated on the backup data set.

This parameter is optional. If not specified, UPDATEBACKUP(NONE) is the default value.

BUFFERS(value) | BUF(value)
Specifies the number of data blocks to be kept resident for the primary data set. If the system is enabled for sysplex communications, 20% of this value is used for the backup data set. The valid values are 0 - 255.

This parameter is optional. If not specified, the default value is 255.

RANGETABLE | RANGE | RNG
Header statement that marks the beginning of the range table. This table can contain multiple entries. The first start entry must be binary zeros and must be arranged in ascending order. The first entry can appear as follows:
START('00' HEX) ENTRYNUMBER(1)
If only one entry exists in the data set name table, no range table is required.

When more than one range exists in the range table, each range must point to an entry in the data set name table. When more than one entry exists in the data set name table, each entry must be referenced by at least one range in the range table; otherwise, an error occurs.

The RACF manager uses only the internal forms of these entry names; therefore, you must also use the internal names when you construct the range table. For more information about internal names, see Internal profile naming for general resource classes.

The RANGETABLE parameter is optional. If not specified, a default range table is defined containing a start value of binary zeros that points to the first entry in the data set name table.

START(start-value [CHAR | HEX])
Specifies the starting range for a single primary and backup data set pair. The start value can be a string of hexadecimal or alphanumeric characters with or without single quotation marks. Single quotation marks are required for the following:
  • Lowercase characters
  • Any blanks included in the string
  • A START value that spans multiple lines
  • A START value that contains a single quotation mark within the string. The single quotation mark within the string must immediately be followed by another single quotation mark.

If lowercase characters are not enclosed in single quotation marks, they are folded to uppercase characters.

The START parameter is optional. If not specified, the default is a single entry of binary zeros pointing to the first entry in the data set name table.

CHAR
Specifies the start value that is interpreted as character data. The maximum length of a start-value is 44.
HEX
Specifies the start value that is interpreted as hexadecimal data. The accepted characters are 0 - 9 and uppercase characters A - F. The maximum length of a start-value is 88 hexadecimal characters. An even number of characters must be specified.

If not specified, the default is CHAR.

ENTRYNUMBER(entry-sequence-number) | ENTRYNUM(entry-sequence-number)
Specifies the sequence number (the data set's relative position in the data set name table) of the entry containing the primary and backup data set pair that is associated with the range start value. The valid values are 1 - 90.

The START and ENTRYNUMBER parameters must be specified in pairs.