PK53921: PROVIDE VARIABLE SUBSTITUTION TO ORF CONTROL STATEMENTS

APAR status

• Closed as new function.

Error description

• This APAR will provide the following new function:
  - Specify substitution variables to control cards.
  This APAR will fix the following problems:
  - The UNLOAD file needs to be uncompressed when specified by
    the user.
  - The HCMA interface is not working correctly.
  - CICS/ODBA PTF generator did not insert the "." in the PTF
  control stmts.
  - MSGDFS2804A during recovery using an image copy created
    with ORF. The image copy DBRC timestamp does not match the
    timestamp on the IC header.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Online Reorganization       *
  *                 Facility Version 1.2.                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: Provide variable substitution to ORF    *
  *                      control statements.                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR is making the following changes:
  1. Problem: User specified the unload file DFSUINPT/DFSURGU1
  in the JCL. The unload file was compressed. The unload file
  needs to be "not compressed" when specified by the user.
  2. Problem: The image copyDBRC timestamp does not match the
  timestamp on the IC header. ORF does it's IC before the
  "takeover" phase. The IC is registered during that phase.
  3. Problem: HCMA interface not working. HCMA MAINTAIN with
  ONLINE(Y) ends with RC 20 during verification.
  4. Problem: New functionality has been added to ORF. It allows
  to specify substitution variables to control cards. The
  keywords involved in this are: LOG1DSN, LOG2DSN, DBD.
  5: Problem: CICS/ODBA PTF generator did not insert the "."
  in the PTF control statements.
  

Problem conclusion

Temporary fix

Comments

• Problem 1: HRFOREO0 has been changed to set the "nocompressed"
  internal option. The file is DFSUINPT when the HP utilities
  are used, but DFSURGU1 when the standard IMS utilities are used.
  Problem 2: The IC header is now updated with the correct
  timestamp. This happens only if the IC is on disk. For tape
  IC the timestamp check must be bypassed. The description of
  how to do this with the standard recovery utility (DFSURDB0)
  is in the ORF User's Guide, chapter 4, "Synchronizing image
  copy timestamps for standard IMS recovery utility"
  Problem 3: HRFOREO0 did not call HRFODSN1 correclty. This
  code has been modified to make the correct call. HCMA APAR
  PK54065 is an IF-REQ.
  Problem 4: HRFSETOP did not have a storage class for the LOG
  definition. This has been added. The DBD name may now be
  specified via PARM field. Samplib member HRF1 is an example
  how to specify the DBD in the parm field and how to specify
  the new parameter for dynamic allocation of the log datasets.
  HRFSETOP member in SHRFSAMP has changed. The setup needs to
  be redone.
  Problem 5: HRFYINST has been modified. SAMPLIB member HRFCICS
  has been changed to include the SMP/E steps.
  

APAR Information

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

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

  UK30316

Modules/Macros

• HRFCICS  HRFLEVEL HRFODSN0 HRFODSN1 HRFOHAL0
  HRFOLOG0 HRFOPST0 HRFOPST1 HRFOREO0 HRFOREO6 HRFOREO8 HRFOUOW1
  HRFREORG HRFSET   HRFSETOP HRFXTBKS HRFYCCDF HRFYCCRD HRFYCC01
  HRFYCC02 HRFYCMDT HRFYDBD2 HRFYINST HRFYMSGL HRFYMSGT HRFYRC10
  HRFYRC81 HRFYRC91 HRFYSCHD HRFYSTRT HRF1
  

Fix information

• Fixed component name

  IMS ONLINE REOR

• Fixed component ID

  5655H9700

Applicable component levels

• R120 PSY UK30316

     UP07/10/17 P F710