PI05347: NEW CONTROL STATEMENTS TO OVERRIDE JOBNAME OF SUBORDINATE ADDRESS SPACE AND VOLUME COUNT FOR EACH SORT STRIPE DATA SET

APAR status

• Closed as new function.

Error description

• New control statements to override the subordinate address
  space jobname and the volume count for each sort stripe data
  set.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Index Builder for z/OS,     *
  *                 Version 3 Release 1 (FMID=H22O310)           *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables Index Builder to      *
  *                      support new control statements to       *
  *                      override system default values.         *
  *                      - IIURSORT control statement            *
  *                      - JOBNSCAN control statement            *
  *                      - JOBNSORT control statement            *
  *                      - STRIPE control statement              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR fixes the problems listed in the Problem Description
  field.
  

Problem conclusion

Temporary fix

Comments

• This APAR enables Index Builder to support new control
  statements to override the system default values.
  - IIURSORT control statement to override procedure name
    to start a subordinate address space.
  - JOBNSCAN control statement to override jobname of SCAN SAS
  - JOBNSORT control statement to override jobname of SORT SAS.
  - STRIPE control statement to override jobname UNIT and
    VOLCNT for stripe data sets.
  For the details of these control statements, see
  the documentation change.
  
  ========================
  = Documentation Change =
  ========================
  IBM IMS Index Builder for z/OS, V3R1, User's Guide
  (SC18-9101-04) should be changed as follows:
  
  ================================================================
   2.2.2     IMS Index Builder input control statements
   2.2.2.2   Optional control statements
  |2.2.2.2.x IIURSORT control statement
  |
  | The IIURSORT control statement specifies a procedure name
  | to start SORT and SCAN subordinate address spaces.
  | By default, the IIUBSRT procedure is used.
  |
  | For the details of the procedure, see "2.3 Defining the
  | subordinate address space procedure".
  | __________________________________________________________
  | |                                                         |
  | |                      _ IIUBSRT __                       |
  | | >>___IIURSORT_______|_ procname _|___________><         |
  | |                                                         |
  | |_________________________________________________________|
  |
  | IIURSORT
  |   Specifies that this is a IIURSORT statement.
  |
  | procname
  |   Specifies the 1- to 8-byte procedure name.
  |
  | Tip: You can override the default value in the runtime
  | parameters module. See the explanation of the IIURDFLT
  | IIURSORT entry in "Defining runtime parameters" in topic 2.4.
  ----------------------------------------------------------------
  |2.2.2.2.x JOBNSCAN control statement
  |
  | The JOBNSCAN control statement specifies job name of each
  | SCAN subordinate address space, which is started when the
  | sequential scan method is used for HALDB partitions.
  |
  | By default, the jobname is IIUSCANS.
  | __________________________________________________________
  | |                                                         |
  | |                      _ IIUSCANS__                       |
  | | >>___JOBNSCAN_______|_ jobname  _|___________><         |
  | |                                                         |
  | |_________________________________________________________|
  |
  | JOBNSCAN
  |   Specifies that this is a JOBNSCAN statement.
  |
  | jobname
  |   Specifies the 1- to 8-byte job name of each SCAN subordinate
  |   address space.
  |
  | Tip: You can override the default value in the runtime
  | parameters module. See the explanation of the IIURDFLT
  | SCAN entry in "Defining runtime parameters" in topic 2.4.
  ----------------------------------------------------------------
  |2.2.2.2.x JOBNSORT control statement
  |
  | The JOBNSORT control statement specifies job name of each
  | SORT subordinate address space.
  |
  | By default, the jobname is IIUSORTS.
  | __________________________________________________________
  | |                                                         |
  | |                      _ IIUSORTS__                       |
  | | >>___JOBNSORT_______|_ jobname  _|___________><         |
  | |                                                         |
  | |_________________________________________________________|
  |
  | JOBNSORT
  |   Specifies that this is a JOBNSORT statement.
  |
  | jobname
  |   Specifies the 1- to 8-byte job name of each SORT subordinate
  |   address space.
  |
  | Tip: You can override the default value in the runtime
  | parameters module. See the explanation of the IIURDFLT
  | SORTP entry in "Defining runtime parameters" in topic 2.4.
  ----------------------------------------------------------------
  |2.2.2.2.x STRIPE control statement
  |
  | The STRIPE control statement specifies the UNIT value and
  | the volume count which are used to allocate stripe data sets.
  |
  |  __________________________________________________________
  | |                                                          |
  | |>>__STRIPE_____________________________________________>< |
  | |           |        _SYSALLDA_  | |            10___ |    |
  | |           |_UNIT=_|_unitname_|_| |_,VOLCNT=_|_nnn _||    |
  | |__________________________________________________________|
  |
  | STRIPE
  |   Specifies that this is a STRIPE statement.
  |
  | UNIT=unit
  |   Specifies the device type or the device group name.
  |   The default is SYSALLDA.
  |
  | VOLCNT=nnn
  |   Specifies the maximum number of volumes from 1 to 255.
  |   The value is used to allocate the following stripe data
  |   sets:
  |   - stripe to contain index records when the SORTFSZ control
  |     statement is specified.
  |   - stripe to contain index records when a duplicate key
  |     error is detected.
  |   The default value is 10.
  |
  |   For the following stripe data set, the value is not used:
  |   - stripe to contain WTO messages of each address space
  |   - stripe to contain SORT messages.
  |   VOLCNT=1 is always used.
  |
  | Tip: You can override the default value in the runtime
  | parameters module. See the explanation of the IIURDFLT
  | STRIPE entry in "Defining runtime parameters" in topic 2.4.
  ----------------------------------------------------------------
   2.4 Defining runtime parameters
   IIURPRMS CSECT
   IIURPRMS RMODE 31
            DC    CL52'IIURPRMS'                      module start
   *                                 alternate sort procedure name
   *        DC    CL52'IIURSORT IIUBSRT '
   *                                  RUN TIME DEFAULT PARAMETERS
   *        DC    CL52'IIURDFLT APIP     IIUAPIFC'
   *        DC    CL52'IIURDFLT CLASS    IIU.STRIPE '
   *        DC    CL52'IIURDFLT DBAUTH   NO'
   *        DC    CL52'IIURDFLT ILDS     INITONLY'
   *        DC    CL52'IIURDFLT ITKBSRVR UTILITKB'
   *        DC   CL104'IIURDFLT ITKBLOAD IMSTOOLS.AAAAAAAA.AAAAA
                  AAAA.SHKTLOAD'
   *        DC    CL52'IIURDFLT MAXTASKS 02'
   *        DC    CL52'IIURDFLT SCAN     IIUSCANS'
   *        DC    CL52'IIURDFLT SORTP    IIUSORTS'
   *        DC    CL52'IIURDFLT SIDXBUF  64,64,64'
   *        DC    CL52'IIURDFLT SORTFSZ  2000000'
  |*        DC    CL52'IIURDFLT STRIPE   UNIT=SYSALLDA,VOLCNT=10'
   *        DC    CL52'IIURDFLT SVCDUMP  NO'
   *        DC    CL52'IIURDFLT TMRWAIT  300'
   *        DC    CL52'IIURDFLT VIC      YES,IIU.UIC.UDATA'
   *        DC    CL52'IIURDFLT WFPDEL   YES'
   *        DC    CL52'IIURDFLT WFPHLQ IMSTOOLS.AAAAAAAA.WFPFILE0'
   *
            DC    CL52'IIUREND'                         module end
   *
            END   IIURPRMS
  Figure 21. Example of an IMS Index Builder runtime parameters
              module (Part 2 of 2)
  :
  | Using IIURDFLT STRIPE
  |  Use the IIURDFLT STRIPE entry to specify the UNIT value and
  |  the volume count which are used to allocate stripe data sets.
  |  For details, see "STRIPE control statement".
  :
  ----------------------------------------------------------------
  ================= End of Documentation Change ==================
  

APAR Information

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

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

  UI12837

Modules/Macros

• IIUBIBCD IIUBSCTL IIUBSTMS IIUDYN00 IIUDYN10
  IIUSIBCD IIUSMP10
  

Fix information

• Fixed component name

  IMS INDEX BUILD

• Fixed component ID

  5655E2400

Applicable component levels