PM04676: PROVIDE NEW CONTROL STATEMENT TO SPECIFY WHETHER DBRC 'NOTIFY.UIC' IS ISSUED TO TURN IMAGE COPY NEEDED FLAG OFF.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Provide a new control statement, VIC, to specify whether the
  DBRC 'NOTIFY.UIC' command is issued to turn the IMAGE COPY
  NEEDED flag off.  MR1012092355.
  

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      *
  *                      issue the DBRC commands to turn off     *
  *                      the RECOV_NEEDED and the IC_NEEDED      *
  *                      flag.                                   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR enables Index Builder to issue the DBRC commands
  to turn off the RECOV_NEEDED flag and the IC_NEEDED flag
  as follows:
    CHANGE.DBDS  DBD(SINDXDB1) DDN(SINDXDS1) NORECOV
    NOTIFY.UIC   DBD(SINDXDB1) DDN(SINDXDS1) -
                 UDATA('IIU.UIC.UDATA')
  
  To turn off the IC_NEEDED flag, the VIC statement is needed
  in the IIUIN data set or the runtime parameters module IIURPRMS.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  IBM IMS Index Builder for z/OS, V3R1, User's Guide
  (SC18-9101-01) should be changed as follows:
  ================================================================
  2.0 Using IMS Index Builder
  2.2 JCL and input control statements
  2.2.2 IMS Index Builder input control statements
  
  
  (The note of the INPUT statement is modified.)
  
   INPUT statement
   :
   Notes:
    1. ...
    2. If you issue the CHANGE.DB NONRECOV NOICREQ command to
      each nonrecoverable index in advance, the IC NEEDED flag
      is not turned on even if DBRC NOTIFY command is issued
      by IMS Index Builder.
  |   Alternatively, you can use the VIC YES statement to turn
  |   off the IC NEEDED flag.  This statement specifies whether
  |   IMS Index Builder issues the DBRC NOTIFY.UIC command.
  
  
  (The VIC statement is added.)
  
  | VIC statement
  |
  |               _ NO__________________
  |    >>__VIC___|_ YES ___ ____________|____________________><
  |                        |_,udata_|
  |
  | The VIC statement specifies whether IMS Index Builder
  | issues the DBRC NOTIFY.UIC command to turn off the
  | IMAGE COPY NEEDED flag for the following types of indexes:
  |  - Primary index of HIDAM
  |  - Secondary index of non-HALDB
  |  - PSINDEX
  |
  | VIC
  |    Specifies that this is a VIC statement.
  | NO
  |      Specifies that IMS Index Builder does not issue the
  |    DBRC NOTIFY.UIC command.
  | YES
  |    Specifies that IMS Index Builder issues the
  |    DBRC NOTIFY.UIC command.
  | udata
  |    Specifies the UDATA parameter of the NOTIFY.UIC command.
  |    The maximum length of the string is 64 characters.
  |
  | For example, you can specify this statement in the following
  | form:
  |    VIC   YES,IIU.UIC.UDATA
  |
  | If the VIC statement is not specified, NO is used as default.
  |
  | Note: You can override the default value in the runtime
  | parameters module. See the explanation of the IIURDFLT
  | VIC entry in "2.4 Defining runtime parameters".
  ----------------------------------------------------------------
  2.4 Defining runtime parameters
  
  (The IIURDFLT VIC entry is added.)
  
  
    IIURPRMS CSECT
    IIURPRMS RMODE 31
             DC    CL52'IIURPRMS'                     module start
    *                                alternate sort procedure name
             DC    CL52'IIURSORT  IIUSAS  '
    *                                  run time default parameters
    *        DC    CL52'IIURDFLT  APIP      IIUAPIFC'
    *        DC    CL52'IIURDFLT  CLASS     IIU.STRIPE '
    *        DC    CL52'IIURDFLT  ITKBSRVR  SRVRNAME'
             DC    CL52'IIURDFLT  SCAN      IIUSCNAS'
             DC    CL52'IIURDFLT  SORTP     IIUSRTAS'
    *        DC    CL52'IIURDFLT  SIDXBUF   64,64,64'
    *        DC    CL52'IIURDFLT  TMRWAIT   300'
   |*        DC    CL52'IIURDFLT  VIC       YES,IIU.UIC.UDATA'
  
    *
             DC    CL52'IIUREND'                       module end
    *
             END   IIURPRMS
    Figure 18. Example of IMS Index Builder runtime parameters
    module
  
    :
  | Using IIURDFLT VIC
  |   Use the IIURDFLT VIC entry to specify whether the DBRC
  |   NOTIFY.UIC command is needed.
  |   For details, see the description of the VIC statement
  |   in "2.2.2 IMS Index Builder input control statements".
  |   This value can be changed also by the VIC control statement
  |   for each job.
  ================= 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:

  UK53874

Modules/Macros

•    IBCD     IIUBIBCD IIUBINIT IIUPDBRC IIUSIBCD
  IIUSMP10 SIBCD
  

Fix information

• Fixed component name

  IMS INDEX BUILD

• Fixed component ID

  5655E2400

Applicable component levels

• R310 PSY UK53874

     UP10/01/28 P F001

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.