OA42684: IEAFIXXX VOLUME PARM NOT DOCUMENTED SHOULD BE SAME AS IEALPAXX MASTER CATALOGING NOT REQUIRED WHEN USED

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as documentation error.

Error description

  • IEAFIXxx for FLPA additions and IEALPAxx for MLPA additions are
    processed by the same module which has a single entry point and
    is called by only one NIP RIM.  As such, it handles the same
    statement format for both IEAFIXxx and IEALPAxx.  MVS
    Initialization and Tuning currently has two errors:
    
    1. The optional VOLUME parm is missing from the Syntax Format
       section of IEAFIXxx.  It should appear just like it is in
       IEALPAxx, namely:
    
       INCLUDE    LIBRARY(data-set-name) [VOLUME(volser)]
                  MODULES(module-name, module-name,...)
    
    2. Both IEALPAxx and IEAFIXxx state in the introductory
       paragraph to their respective sections:
    
       "(The modules are cataloged in the system master catalog.)"
    
       This is not necessarily required if the VOLUME parameter is
       used.
    
       In Statements/Parameters for IEALPAxx it correctly states the
       conditions under which cataloging in the system master
       catalog is NOT required:
    
       "The specified library, which must be a PDS, must be
       cataloged in the system master catalog unless you specify a
       volser using VOLUME in which case the data set must be on the
       specified volume."
    
       A corresponding statement needs to be added to IEAFIXxx.  The
       following statement which appears in the Statements/
       Parameters section in IEALPAxx needs to be added to the
       corresponding section of IEAFIXxx:
    
       "VOLUME is optional."
    

Local fix

  • Use statement format from IEALPAxx for IEAFIXxx
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users running z/OS HBB7780 and above.        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Parmlib members IEAFIXxx and IEALPAxx have incorrect
    documentation in regards to the VOLUME parameter.
    

Problem conclusion

  • DOCUMENTATION HOLD FOR APAR OA42684
      +-------------------------------------------------------+
    
      o   ORDER NO-  SA22-7592-xx
      o   Book Title- z/OS         MVS Initialization and
                                   Tuning Reference
    
    
      MVS Initialization and Tuning Reference
    
      +--- LOCATION IN PUBLICATION ---------------------------+
      |                                                       |
      |  IEAFIXxx (fixed LPA list)                            |
      +-------------------------------------------------------+
    
      Change the following:
    
    | ... (The libraries, which contain the modules, must be
    | cataloged in the system master catalog, unless the
    | VOLUME parameter is specified) ...
    
      +--- LOCATION IN PUBLICATION ---------------------------+
      |                                                       |
      |  IEAFIXxx (fixed LPA list)                            |
      |    Syntax format of IEAFIXxx                          |
      +-------------------------------------------------------+
    
      Add the VOLUME parameter:
    
    | INCLUDE    LIBRARY(data-set-name)  VOLUME(volser)
                 MODULES(module-name, module-name,...)
    
      +--- LOCATION IN PUBLICATION ---------------------------+
      |                                                       |
      |  IEAFIXxx (fixed LPA list)                            |
      |    Statements/parameters for IEAFIXxx                 |
      +-------------------------------------------------------+
    
      Change the following:
    
      INCLUDE
    
      Specifies modules to be loaded as a temporary extension
      to the existing pageable link pack area (PLPA).
    
    | Both LIBRARY and MODULES must be specified. VOLUME is
    | optional.
    
        LIBRARY
    
      Specifies a qualified data set name. The specified
    | library, which must be a PDS, must be cataloged in the
    | system master catalog unless you specify a volser using
    | VOLUME in which case the data set must be on the
    | specified volume. (If you specify SYS1.LINKLIB or
    | SYS1.LPALIB, the system uses only those libraries, and
    | not their concatenations.)
    
        MODULES
    
      Specifies a list of 1 to 8 character module names.
    
      +--- LOCATION IN PUBLICATION ---------------------------+
      |                                                       |
      |  IEALPAxx (modified LPA list)                         |
      +-------------------------------------------------------+
    
      Change the following:
    
    | ... (The libraries, which contain the modules, must be
    | cataloged in the system master catalog, unless the
    | VOLUME parameter is specified) ...
    

Temporary fix

Comments

APAR Information

  • APAR number

    OA42684

  • Reported component name

    CONTENTS SUPERV

  • Reported component ID

    5752SC1CJ

  • Reported release

    780

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2013-06-26

  • Closed date

    2013-07-02

  • Last modified date

    2013-07-02

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

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

Publications Referenced
SA227592XX        

Fix information

Applicable component levels



Rate this page:

(0 users)Average rating

Document information


More support for:

z/OS family

Software version:

780

Operating system(s):

MVS, z/OS

Reference #:

OA42684

Modified date:

2013-07-02

Translate my page

Machine Translation

Content navigation