z/OS Security Server RACF System Programmer's Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Recovering from RACF parameter library problems

z/OS Security Server RACF System Programmer's Guide
SA23-2287-00

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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014