Defining a security class for UMS

This section covers the steps to define IZP class for SAF and migrate them to a different POSIT number.

Defining the SAF IZP class

If you want to create an IZP class before running the IZPGENER JCL or do not want to use the IZP class definition JCL created by IZPGENER, you need to define the SAF IZP class for the RACF security manager.

For example,
  • Create the SAF IZP class for RACF security manager:
    RDEF CDT IZP UACC(NONE)
    RALT CDT IZP CDTINFO(POSIT(608))
    RALT CDT IZP CDTINFO(RACLIST(ALLOWED))
    RALT CDT IZP CDTINFO(MAXLENGTH(246))
    RALT CDT IZP CDTINFO(FIRST(ALPHA))
    RALT CDT IZP CDTINFO(OTHER(ALPHA NUMERIC SPECIAL))
    SETR RACLIST(CDT) REFRESH
    SETR CLASSACT(IZP) GENERIC(IZP) RACLIST(IZP)
    
Notes:

Migrating to a different POSIT number

If you have already run the security JCLs, you can complete the below steps to migrate to a different POSIT number.

The default POSIT number specified by IBM is 608. Identify the new POSIT number required for this procedure.

To migrate to a different POSIT number, complete the following steps:
  1. Execute the following command to list the SETROPTS options for all classes:SETROPTS LIST
    SETROPTS LIST
    Record all active system options for the IZP class.
  2. Record the current POSIT value of the IZP class. Run the following command to list the POSIT value:
    RLIST CDT IZP CDTINFO NORACF
  3. Run the following command to change the POSIT number:
    RALTER CDT IZP CDTINFO(POSIT(60*8*))
    Ignore the IRR52190I message that is issued by RALTER.
  4. Run the following command to refresh the CDT class on all systems sharing the RACF database that will use the IZP class:
    SETROPTS RACLIST(CDT) REFRESH

    Ignore the following ICH14079I message that is issued by SETROPTS: ICH14079I RACF detected an error in the dynamic class descriptor table entry IZP, error code 08.

    This message will also be issued during IPL on any system with the PTF for z/OS 2.5 and above, until step 10 is performed. These IPL messages can be ignored.

  5. Activate the desired SETROPTS options. Using the SETROPTS LIST output from step 1 as reference, assuming for this example that SETROPTS options CLASSACT, RACLIST, GENERIC, and GENCMD were previously active for the IZP class, run the following command:
    SETROPTS CLASSACT(IZP) RACLIST(IZP) GENERIC(IZP) GENCMD(IZP)
  6. Examine all dynamic and static CDT entries to see if any other existing class shares the previous POSIT value of the IZP class. If another existing class shares the current POSIT value, then continue at step 10. If no other existing class shares the previous POSIT value, continue with step 7 to ensure that any new class will not have unexpected options if you add a new class using that POSIT value in the future.
  7. Add a new, unique, temporary dynamic class and assign it the previous POSIT value of the IZP class. For example, if the class name $TEMPCLS is not in use, and the previous POSIT value of the IZP class was 200, then run the following commands:
    RDEFINE CDT $TEMPCLS CDTINFO(POSIT(200))
    SETROPTS RACLIST(CDT) REFRESH
  8. Deactivate the SETROPTS settings that you recorded in step 1. For example, if the SETROPTS options CLASSACT, RACLIST, GENERIC and GENCMD were active for the IZP class, you can issue the following command to deactivate those options.
    SETROPTS NOCLASSACT($TEMPCLS) NORACLIST($TEMPCLS) NOGENERIC($TEMPCLS) NOGENCMD($TEMPCLS)
  9. Delete the temporary class by running the following commands:
    RDELETE CDT $TEMPCLS
    SETROPTS RACLIST(CDT) REFRESH
  10. Once all of the systems sharing the RACF database are loaded with the PTF for z/OS 2.5 and above, the installation-defined dynamic version of the IZP class can be deleted. Delete the CDT class profile which defines the IZP class using the commands:
    RDELETE CDT IZP
    SETROPTS RACLIST(CDT) REFRESH
    Important: Do not delete the installation-defined dynamic class until all of the systems sharing the RACF database have been loaded with the PTF for z/OS 2.5 and above. If you are propagating changes to the CDT class using the RACF remote sharing facility (RRSF), then this also applies to systems on remote RRSF nodes.