PI09890: SUPPORT LOGICALDBD KEYWORD

APAR status

• Closed as new function.

Error description

• This APAR adds support for the new LOGICALDBD keyword.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IMS Online Reorg Facility V1.3      *
  ****************************************************************
  * PROBLEM DESCRIPTION: Support LOGICALDBD keyword              *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR adds support for the new LOGICALDBD keyword. This
  keyword is used to specify the names of the logical DBDs that
  are defined to the physical database specified by the DBD
  keyword. Specify this keyword only if you have applications that
  update the database during the reorganization process by using a
  PCB that references a logical DBD.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Online Reorganization Facility for z/OS User's Guide
  Version 1 Release 3 (SC19-3967-00)
  ----------------------------------------------------------------
  4.0 Using IMS Online Reorganization Facility
   4.4 HRFSYSIN DD statement keywords
  
    Table 3. HRFSYSIN DD statement keyword
    +----------+------------+--------------+---------------------+
    |Keyword   |REORG       |UNLOAD        |Link to topic        |
    |          |HRFSYSIN DD |HRFSYSIN DD   |                     |
    +----------+------------+--------------+---------------------+
    |DATACLAS  |Optional    |Not applicable|"DATACLAS keyword".. |
    +----------+------------+--------------+---------------------+
        :          :             :                 :
    +----------+------------+--------------+---------------------+
    |LOG2DSN   |Optional    |Not applicable|"LOG2DSN keyword" .. |
    +----------+------------+--------------+---------------------+
  ADD:
  | |LOGICALDBD|Optional    |Not applicable|"LOGICALDBD keyword" |
  | +----------+------------+--------------+---------------------+
  ADD:
        :
  ADD:
  | 4.4.xx LOGICALDBD keyword
  | Use this keyword to specify the names of the logical DBDs that
  | are defined to the physical database specified by the DBD
  | keyword.
  |
  | Specify this keyword only if you have applications that update
  | the database during the reorganization process by using a PCB
  | that references a logical DBD. You can specify up to five
  | logical DBD names.
  |
  | This keyword is optional for REORG HRFSYSIN DD statements, but
  | is not applicable for UNLOAD HRFSYSIN DD statements.
  |
  | Format
  |  (dbdname1 ,dbdname2 ,dbdname3 ,dbdname4 ,dbdname5     )
  |
  | Default value
  |  None.
  ADD:
  
  5.0 Troubleshooting
   5.3 Messages and codes
    5.3.2 Messages
  
  ADD:
  |
  | HRF01181E Logical DBD dbdname is invalid
  |
  | Explanation: The indicated logical DBD does not reference the
  | database that is specified by the DBD keyword.
  | System action: Processing terminates.
  | User response: Ensure that the indicated logical DBD is
  | defined to the database that you are reorganizing.
  |
  ADD:
        :
  ADD:
  |
  | HRF01573E Logical DBD dbdname is not specified by the
  | LOGICALDBD keyword
  | Explanation: The database was updated by using a PCB that
  | references the indicated logical DBD, but the logical DBD is
  | not specified by the LOGICALDBD keyword.  Any logical DBD that
  | applications use for update during the reorganization must be
  | specified with the LOGICALDBD keyword.
  | System action: Processing terminates.
  | User response: Specify the logical DBD by using the LOGICALDBD
  | keyword.
  |
  |
  | HRF01574E DBD dbdname has insert, delete, or replace rules
  | that are not supported
  | Explanation: Unsupported path type is specified in the insert,
  | delete, or replace rules of the indicated DBD.  For HALDB
  | databases that have internal logical relationships, the
  | following restrictions apply to the insert, delete and replace
  | rules. The rules are specified by using the RULES= keyword of
  | a SEGM statement in the physical DBD.
  | - Insert rules L and V are not supported for logical parents.
  |   Only the P insert rule is supported.
  | - Delete rules L and V are not supported for logical parents.
  |   Only the P deletion rule is supported.
  | - Replace rule V is not supported for logical parents.
  | No restrictions apply to the insert, delete, and replace rules
  | of full-function databases.
  | System action: Processing terminates.
  | User response: None. You cannot use IMS Online Reorganization
  | Facility to process a HALDB DBD with such rules.
  |
  ADD:
  

APAR Information

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

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

  UI16370

Modules/Macros

• HRFDBUX1 HRFFLGX0 HRFOAPLY HRFOAPL0 HRFOAPL1
  HRFOARC0 HRFOBKO0 HRFODBDL HRFOFLGX HRFOFMTT HRFOHAL0 HRFOLEV0
  HRFOLOGF HRFOREOD HRFOREO0 HRFOREO1 HRFOREO3 HRFOREO9 HRFOROLS
  HRFORQ02 HRFORQ04 HRFORQ06 HRFORQ11 HRFOSUB0 HRFOUNL2 HRFYCCDF
  HRFYDBD0 HRFYDBD2 HRFYDBD3 HRFYDBD5 HRFYIXRC HRFYMSGT HRFYPRES
  HRFYPSBG HRFYPSB5 HRFZLOGI H2A7130J
  

Fix information

• Fixed component name

  IMS ONLINE REOR

• Fixed component ID

  5655H9700

Applicable component levels

• R130 PSY UI16370

     UP14/03/27 P F403