Several errors related to the RACF® parameter
library can occur. For all of these errors, RACF issues an error message and subsystem initialization
completes, but no RRSF configuration occurs. Errors that can occur
are:
- Error: The data set specified for the RACF parameter library in the RACFPARM DD statement
does not exist.
Recovery: Correct your RACFPARM DD statement
to specify an existing data set, or create the data set you specified
on the RACFPARM DD statement. The RACF subsystem
address space must then be reinitialized to pick up the changes. To
accomplish this, issue the RACF STOP
command followed by the MVS™ START
command with SUB=MSTR specified.
- Error: The EXEC statement in the JCL for the RACF procedure specifies a parameter library
member on the PARM='OPT=xx' parameter, but
no RACFPARM DD statement is included in the JCL.
Recovery:
Add the RACFPARM DD statement to your JCL. The RACF subsystem address space must then be reinitialized
to pick up the changes. To accomplish this, issue the RACF STOP command followed by the MVS START command with SUB=MSTR specified.
- Error: The EXEC statement in the JCL for the RACF procedure specifies a parameter library
member on the PARM='OPT=xx' parameter, but
the parameter library member does not exist in the data set specified
in the RACFPARM DD statement.
Recovery: If an appropriate
parameter library member exists (for example if the PARM='OPT=xx'
parameter is mistyped) you can issue a SET INCLUDE command to process
the commands in that member. This is a temporary recovery method,
and you must repeat it every time you reinitialize the RACF subsystem address space until you correct
your JCL.
If no appropriate parameter library member exists,
you can create one with the suffix you specified on the PARM='OPT=xx'
parameter and issue a SET INCLUDE command to process the commands
in the new member. The new member is processed automatically whenever
the RACF subsystem address
space reinitializes in the future.
- Error: The EXEC statement in the JCL for the RACF procedure does not specify a parameter
library member on the PARM='OPT=xx' parameter,
and the JCL includes a RACFPARM DD statement but the data set it specifies
does not include an IRROPT00 member.
Recovery: This situation
does not always occur as a result of an error. RACF assumes that if you include a RACFPARM
DD statement in your JCL, you want a parameter library member processed
automatically during initialization of the RACF subsystem address space. If you do not
specify a member on the PARM='OPT=xx' parameter, RACF attempts to process member
IRROPT00. However, you might want to use the RACF parameter library without having a member
processed automatically. If this is the case, ignore the error message.
Make sure that you do not create an IRROPT00 member, unless you want RACF to process it automatically
every time the RACF subsystem
address space reinitializes.
If your intent was to have the
IRROPT00 member automatically processed, create it. You can then issue
a SET INCLUDE member to process the commands in the new member. The
new member is processed automatically whenever the RACF subsystem address space reinitializes in
the future.
- Error: The JCL includes a RACFPARM DD statement, and the
data set it specifies is empty. An abend message is issued, but the
abend is not taken.
Recovery: Make sure that the RACFPARM
DD statement specifies the correct data set, and correct it if it
does not. If it does, either add data to the data set, or remove the
RACFPARM DD statement from the JCL. The RACF subsystem
address space must then be reinitialized to pick up the changes. To
accomplish this, issue the RACF STOP
command followed by the MVS START
command with SUB=MSTR specified.