PK07560: PASS IB LOAD LIBRARY NAME USED IN MAIN JOB TO BE SAME LOAD LIBRARY USED IN SORT JOB.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• In the case where customers have multiple IB load libraries at
  different maintenance levels in order to phase in maintenance,
  but only one IIUBSRT proc, a mismatch in maintenance levels
  between programs can occur.
  
  A new function to pass the load library name used in the main
  job to the IIUBSRT task so the same load library can be used
  will be implemented.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS Index Builder V2R3 users.            *
  ****************************************************************
  * PROBLEM DESCRIPTION: IB V2R3 users on many IMS systems found *
  *                      that it would be more convenient for    *
  *                      production to transit the STEPLIB to    *
  *                      the statrted task instead of hard       *
  *                      coding it in the starting procedure.    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  IMS Index Builder V2R3 requires an explicit STEPLIB DD in the
  sort task starting procedure (IIUBSRT).
  

Problem conclusion

Temporary fix

Comments

• A new control statement was introduced to allow the step library
  to be transited to a modified two parameter starting task
  procedure. STEPLIB TRAN in the control statement stream turns
  library transition on, while STEPLIB NOTR turns a pre-set via
  the run time parameter module library transition off. With
  library transition on, the sort starting procedure must be like
  //IIUBSRTZ PROC  INDEX=,IIUSTEPL=
  //IEFPROC  EXEC  PGM=IIUBSCTL,REGION=33M,TIME=1439
  //STEPLIB  DD    DISP=SHR,DSN=&IIUSTEPL
  //IEFRDER  DD    DISP=SHR,DSN=&INDEX,AMP=('BUFND=128,BUFNI=128')
  *** DOCUMENT CHANGES ***
  have been requested in IBM IMS Index Builder for z/OS
  User's Guide Version 2 Release3, SC27-0930-05
  p24., after SORTSTAT statement, insert
  STEPLIB statement
  The STEPLIB statement turns library transition to the started
  task sort procedure on and off
  STEPLIB TRAN transits the main task's step library to the
  started task which must be initiated via two parameter
  procedure like
  //IIUBSRT  PROC  INDEX=,IIUSTEPL=
  //IEFPROC  EXEC  PGM=IIUBSCTL,REGION=33M,TIME=1439
  //STEPLIB  DD    DISP=SHR,DSN=&IIUSTEPL
  //IEFRDER  DD    DISP=SHR,DSN=&INDEX,AMP=('BUFND=128,BUFNI=128')
  STEPLIB NOTR switches back to single parameter procedure use
  when TRAN has been defaulted via IIURPRMS
           DC    CL8'IIURPRMS'       MODULE START
           DC    CL44' '
           DC    CL8'IIURDFLT'       DEFAULT PARM
           DC    CL44' STEPLIB   TRAN'
           DC    CL8'IIUREND'        MODULE END
           DC    CL44' '
  

APAR Information

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

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

  UK05132

Modules/Macros

•    IBCD     IIUBCSAS IIUBDSEC IIUBIBCD IIUBINIT
  IIUBSCTL
  

Fix information

• Fixed component name

  IMS INDEX BUILD

• Fixed component ID

  5655E2400

Applicable component levels

• R230 PSY UK05132

     UP05/07/07 P F507

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.