PK11734: DEFAULT OPTION TABLE REPORT SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The default option table report is added to show the contents
  of the system default option table and the installation default
  option table.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Parallel Reorganization     *
  *                 for z/OS, Version 3 Release 1 (FMID=H25N310) *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides the following        *
  *                      functional enhancements for             *
  *                      IPR Driver, IPR Unload, and IPR Reload: *
  *                      1. The new report Default Option        *
  *                         Tables Report is shown.              *
  *                      2. The new message HPSC3719I is issued  *
  *                         when HPSCOPTI is found.              *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the following functional enhancements
  for IPR Driver, IPR Unload, and IPR Reload:
  1. The new report Default Option Tables Report shows the
     contents of the system default option table (HPSCOPTS) and
     the installation default option table (HPSCOPTI). If HPSCOPTI
     was used, this report shows both HPSCOPTS and HPSCOPTI. If
     HPSCOPTS is used, this report shows only HPSCOPTS.
  2. The new message HPSC3719I is issued when Installation Default
     Options Table (HPSCOPTI) is found.
  
  To show the new report and message for IPR Unload utility and
  IPR Reload utility, the following maintenances are required:
   - APAR PK12918 for IMS High Performance Unload (FMID=H1IN110)
   - APAR PK12919 for IMS High Performance Load (FMID=H1IM210)
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Parallel Reorganization for z/OS Version 3 Release 1
  User's Guide (SC18922801) should be changed as follows:
  
  ================================================================
  2.0 IMS Parallel Reorganization Driver
  2.6 JCL requirements
  2.6.2 DD statements
  2.6.2.1 DD names common to all processing options
  
  This section describes the DD names that are common to all
  processing options.
  STEPLIB DD
   Points to the following library data sets:
    :
    :
   IMS tools libraries must be concatenated before the IMS RESLIB
   library.
   The libraries specified on STEPLIB DD statement must be
   APF-authorized.
  |If you create an Installation Default Options Table (HPSCOPTI),
  |the module must be in a library in the STEPLIB concatenation.
  
  2.8 Reports and statistics
  2.8.1 HPSOUT data set
  
  In this data set, the following reports and statistics are
  written in the
  following order:
   1.Environment report that shows the EXEC parameters and the
     system environment. For details, see "Environment report"
     in topic 2.8.1.1.
  |2.Default Option Tables report for Reorganization Manager.
  |  For details, see "Default Option Tables Report"
  |  in topic 2.8.1.X.
   3.HPSIN Control Statements report for Reorganization Manager,
     Unload task, and Reload task The processing option report
     of IMS Index Builder is written in the IIUPRINT data set.
     For details, see the IMS Index Builder User's Guide.
  
  (The new section added.)
  |2.8.1.X Default Option Tables Report
  | This report shows the contents of the system default option
  | table (HPSCOPTS) and the installation default option table
  | (HPSCOPTI). If HPSCOPTI was used, this report shows
  | both HPSCOPTS and HPSCOPTI. If HPSCOPTS was used, this
  | report shows only HPSCOPTS. For details of Installation
  | Default Option Table, see "Setting Installation Default
  | Options" in section 6
  |
  | Figure xx is an example of Default Option Tables Report
  | when HPSCOPTI was used.
  | (Here, this figure xx is omitted.)
  | Figure xx. Default Option Tables Report (HPSCOPTI was used)
  |
  | Figure yy is an example of Default Option Tables Report
  | when HPSCOPTS was used.
  | (Here, this figure yy is omitted.)
  | Figure yy. Default Option Tables Report (HPSCOPTS was used)
  
  3.0 The IPR Unload Utility
  3.9 Reports and Statistics
  The IPR Unload utility produces the reports and statistics in
  the following data sets:
  HPSOUT data set
  HPSLIST data set
  HPSRAPC data set
  The following reports are written in the HPSOUT data set:
  
  Reports that are generated for all database organizations:
    Environment report
  | Default Option Tables report
    HPSIN Control Statements report
    Decoded DBD report (if DECODEDBD=YES)
    DBD Summary report
    Segment Count Summary report
    Segment Statistics report (3)
  | Largest Database Records report (3)
    Data Set Statistics report (3)
  
  (The new section added.)
  | 3.9.X Default Option Tables Report
  | This report shows the contents of the system default option
  | table (HPSCOPTS) and the installation default option table
  | (HPSCOPTI). If HPSCOPTI was used, this report shows
  | both HPSCOPTS and HPSCOPTI. If HPSCOPTS was used, this
  | report shows only HPSCOPTS. For details of Installation
  | Default Option Table, see "Setting Installation Default
  | Options" in section 6.
  |
  | Figure xx is an example of Default Option Tables Report.
  | (Here, this figure is omitted.)
  | Figure xx. Default Option Tables Report
  
  4.0 The IPR Reload utility
  4.8 Reports and Statistics
  4.8.1 HPSOUT Data Set
  This data set contains the following printed reports:
    Environment report
  | Default Option Tables report
    HPSIN Control Statements report
  :
  (The new section added.)
  |4.8.1.X Default Option Tables Report
  | This report shows the contents of the system default option
  | table (HPSCOPTS) and the installation default option table
  | (HPSCOPTI). If HPSCOPTI was used, this report shows
  | both HPSCOPTS and HPSCOPTI. If HPSCOPTS was used, this
  | report shows only HPSCOPTS. For details of Installation
  | Default Option Table, see "Setting Installation Default
  | Options" in section 6
  |
  | Figure xx is an example of Default Option Tables Report.
  | (Here, this figure is omitted.)
  | Figure xx. Default Option Tables Report
  
  10.0 Messages and codes
  10.3 Messages
  10.3.1 HPSC messages
  (The new messages HPSC3719I and HPSC3720I are added.)
  ----------------------------------------------------------------
  | HPSC3719I INSTALLATION DEFAULT OPTIONS TABLE HPSCOPTI (LV.nn)
  | IS FOUND
  | Explanation: The Installation Default Options Table (HPSCOPTI)
  | is found. The HPSCOPTI was generated with the HPSCOPT macro of
  | the level nn. The default values in this table override the
  | values in the system default option table (HPSCOPTS).
  | System Action:  The IPR utility continues processing.
  | Programmer Response: None.
  ----------------------------------------------------------------
  | HPSC3720I DEFAULT OPTION TABLES REPORT IS NOT PRINTED (RSN=nn)
  | Explanation: The Default Option Tables report is not printed
  | because of the reason shown by the reason code nn. The reason
  | code nn is one of the following values:
  |
  |  RSN  Description
  |   01   The RDJFCB macro failed
  |   02   The BLDL macro failed
  |   03   The LOAD macro failed
  |   04   The loaded module is unexpected format
  |
  | System Action: The IPR utility continues processing.
  | Programmer Response: If the reason code is 04, correct the
  | error, and rerun the job. Otherwise this is likely an internal
  | system error. Contact IBM Software Support.
  ----------------------------------------------------------------
  ======================= End of Doc-Change ======================
  

APAR Information

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

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

  UK08965

Modules/Macros

• HPSCMSGT HPSGCM00 HPSGGIOB HPSGGIO0 HPSGGVT0
  HPSGLINK HPSGOPTG HPSGOPTP HPSGOPTR HPSGOPTU H25N310J
  

Fix information

• Fixed component name

  IMS PARALLEL RE

• Fixed component ID

  5655F7400

Applicable component levels

• R310 PSY UK08965

     UP05/11/12 P F511

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.