OA56715: DOCUMENTATION FOR IRRUT200 LACKS IMPORTANT DETAILS ABOUT USING ICEGENER

APAR status

• Closed as documentation error.

Error description

• The RACF System Programmer's Guide SA23-2287-30 documents that
  ICEGENER can be used to improve performance when running
  IRRUT200 to make a copy of the RACF database.
  
  It fails to mention, however, that the OUTSEC parameter for
  ICEGENER takes precedence over the JCL allocation for an output
  dataset that is allocated in the same job step. This can lead to
  a RACF database copy that crosses multiple extents, which is an
  invalid RACF database and cannot be used to IPL a system.
  
  The default value is OUTSEC=Y and that could lead to an invalid
  RACF database copy.
  

Local fix

• Pre-allocate the dataset for the new database copy or use the
  DFSPARM NOOUTSEC to ensure no extents are used.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of the RACF database verification utility program      *
  * (IRRUT200) who are creating a new data set for the SYSUT1    *
  * work data set and have configured DFSORT to have ICEGENER    *
  * replace IEBGENER.                                            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * The RACF Systems Programmer's Guide (SA23-2287) did not      *
  * document the impact of using the DFSORT ICEGENER utility on  *
  * the RACF data base verification utility program (IRRUT200).  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• The RACF Systems Programmer's Guide (SA23-2287) is updated as
  follows:
  
  1. In the section titled "RACF database verification  utility
  program (IRRUT200)", right after the bullet that states "Using
  DFSORT's ICEGENER (or an equivalent product) as a replacement
  for IEBGENER" the following text is added:
  
       "Installations can configure DFSORTs ICEGENER as a
        replacement for IEBGENER. In addition, there are
        DFSORT installation parameters which affect how ICEGENER
  operates. One of these
        installation parameters, OUTSEC,  controls
        whether DFSORT uses automatic secondary allocation
        for output data sets that are temporary or new."
  
  
  2. After the text which reads "For information on installing
     ICEGENER as a replacement for IEBGENER, see
     z/OS DFSORT Installation and Customization." add the
     following text:
  
        "For information on how to prevent OUTSEC
        processing in the IRRUT200 job, see the discussion
        of the DFSPARM DD statement."
  
  
  3. Add the following text as a new paragraph in the
     description of the SYSUT1 DD statement, immediately before
     the notes:
  
       "For information on installing ICEGENER as a replacement
        for IEBGENER, see z/OS DFSORT Installation and
        Customization. For information on how to prevent
        OUTSEC processing in the IRRUT200 job,
        see the discussion  of the DFSPARM DD statement."
  
  4. Add a description of the DFSPARM DD statement:
  
       "DFSPARM DD  (Optional)
  
        Defines a data set which contains overrides for the
        installation DFSORT defaults. The data set must be
        defined with RECFM of F or FB with an LRECL of
        80 bytes. This statement is only applicable if you are:
           - Using SYSUT1 to create a copy of the RACF data base
           - The SYSUT1 data set is allocated as DISP=NEW
           - The SYSUT1 data set is going to be used as a
             RACF data set or as input to one of the RACF
             utilities
           - Your installation has installed the DFSORT
             ICEGENER utility as a replacement for IEBGENER
           - Your installation uses OUTSEC as a DFSORT default
  
       The data that is input to this statement is:
           OPTION NOOUTSEC
        "
  
  5. In the first example, clarify that the SYSUT1 data
     set is a temporary data set by adding the word
     "temporary" to the statement:
  
       "In the following example, IRRUT200 copies a RACF
        data set to the SYSUT1 temporary data set."
  
  
  6. Add the following new example:
  
        "The following example is similar to the prior example,
        except that the SYSUT1 data set is a non-temporary
        data set and may be used as an online RACF data set
        or as input to other RACF utilities.  In this case,
        to ensure that the data set is allocated as an
        unmoveable, contiguous and single extent data set,
        CONTIG must be specified and the the //DFSPARM DD
        statement has been added to allow the
        specification of NOOUTSEC.
  
        Note that the data set allocated to SYSRACF
        and the data set being allocated by SYSUT1 must be
        on the same type of device (3380 or 3390).
  
  
        //VERIFY   JOB
        //STEP     EXEC PGM=IRRUT200
        //SYSRACF  DD DSN=SYS1.RACF,DISP=SHR
        //SYSUT1   DD UNIT=SYSALLDA, SPACE=(CYL,10,,CONTIG),
        //         DSN=PROD.RACF.BACKUP,
        //         DCB=(LRECL=4096,RECFM=F,DSORG=PSU)
        //SYSUT2   DD SYSOUT=A
        //SYSPRINT DD SYSOUT=A
        //DFSPARM  DD *
            OPTION NOOUTSEC
        /*
        //SYSIN    DD *
           INDEX
           MAP
           END
        /*
       "
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels