PM31791: COEXISTENCE WITH V12 PRECONDITIONING CODE FOR INIT/UPD OLR ENHANCEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible in next release.

Error description

• For sharing V12 and V11 IMSs environment, if INIT OLREORG with
  OPTION(REL) or OPTION(NOREL) is entered from V12 IMS system
  and it's routed to all IMSs, V11 IMS system will need to be
  able to process the new options.
  Keywords: IMSV12COEX/K IMSV13COEX/K
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All customers who use HALDB OLR and have     *
  *                 a mixed environment with V11 and V12 IMS     *
  *                 systems in the IMSplex.                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: In a mixed environment with IMS V11 and *
  *                      IMS V12 systems, the IMS V11 system     *
  *                      must be able to process the command     *
  *                      grammar generated by a IMS V12 system.  *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  The IMS V12 APAR PM27815 will change the command grammar for
  the INITIATE and UPDATE OLREORG commands as new options were
  added for the OPTION keyword.  OM builds the parsed command
  output using the command grammar from the highest version of
  IMS.  The parsed command output is sent to all IMSs in the
  IMSplex that can process the command.  The IMS V11 system does
  not understand the modified parsed command blocks generated by
  OM when there is a V12 IMS with PM27815 installed in the
  IMSplex.
  

Problem conclusion

Temporary fix

Comments

• This APAR provides preconditioning for IMS V12 HALDB OLR to
  coexist with IMS V11.  It allows IMS V11 systems to understand
  the IMS V12 INITIATE and UPDATE OLREORG command grammar.  For
  any set of data sharing IMSs that are using HALDB OLR, this
  APAR (PM31791) must be installed on all IMS V11 systems in the
  data sharing group before any IMS V12 system with service for
  PM27815 is started within the group.  This APAR may be
  installed serially (one system at a time) among the V11 IMS
  systems.
  
  The following code changes are made:
  ====================================
  
  1. DFSODB1D MACRO
    - Add IOLR_$$$VER internal keyword field for IOLR grammar
      version.  This is dummy keyword and is not specified by
      the user.  The value is defined by the default value in
      the BPEPADEF.
    - Add 4-byte IOLR_OPTOFF offset to PCEB chain field for
      INIT OLREORG with OPTION command.
    - Add IOLR_V1LEN field for IOLR length when IOLR_$$$VER=1.
  
    - Add UOLR_$$$VER internal keyword field for UOLR grammar
      version.  This is dummy keyword and is not specified by
      the user.  The value is defined by the default value in
      the BPEPADEF.
    - Add 4-byte UOLR_OPTOFF offset to PCEB chain field for
      UPDATE OLREORG with OPTION command.
    - Add UOLR_V1LEN field for UOLR length when UOLR_$$$VER=1.
  
  2. DFSORC00 ASSEMBLE
    - After label INITLOOP, add a checking if R15 has RC=x'12',
      then send an error message for invalid filter in option
      keyword.  Stop processing.
    - After label PARM5000, code was added to do the following:
      . For INIT OLREORG
         If IOLR_$$$VER = 0 then
           Process 1-byte IOLR_OPT
         ElseIf IOLR_$$$VER = 1 then
           Process 4-byte IOLR_OPTOFF offset to PCEBs chain field
         Else
           Issue an error with Return code=00000008, Reason
           code=00002040, Reason text=No filter, an invalid
           filter, or insufficient # of filters specified.
         EndIf
  
      . If IOLR_$$$VER = 1 and the value is specified any value
        other than DEL or NODEL in OPTION keyword, issue an error
        with Return code=00000008, Reason code=00002040, Reason
        text=No filter, an invalid filter, or insufficient #
        of filters specified.
  
      . If IOLR_$$$VER = 1 and both value DEL and NODEL are
        specified in OPTION keyword, issue an error with Return
        code=00000008, Reason code=00002040, Reason text=No
        filter, an invalid filter, or insufficient # of
        filters specified.
  
      . For UPDATE OLREORG
         If UOLR_$$$VER = 0 then
           Process 1-byte UOLR_OPT
         ElseIf UOLR_$$$VER = 1 then
           Process 4-byte UOLR_OPTOFF offset to PCEBs chain field
         Else
           Issue an error with Return code=00000008, Reason
           code=00002040, Reason text=No filter, an invalid
           filter, or insufficient # of filters specified.
         EndIf
  
      . If UOLR_$$$VER = 1 and the value is specified any value
        other than DEL or NODEL in OPTION keyword, issue an error
        with Return code=00000008, Reason code=00002040, Reason
        text=No filter, an invalid filter, or insufficient #
        of filters specified.
  
      . If UOLR_$$$VER = 1 and both value DEL and NODEL are
        specified in OPTION keyword, issue an error with Return
        code=00000008, Reason code=00002040, Reason text=No
        filter, an invalid filter, or insufficient # of
        filters specified.
  
  3. DFSCMDRR MACRO
     - Add ICC_PARMERR, X'CF', PARM VALUE CONFLICT, for
       INIT/UPDATE OLREORG with OPTION command.
  
  
  IMS Publication changes
  =======================
  
  1. The IMS V12 Program Directory (GI10-8843-00)
     Needs to be modified to add the coexistence APAR
     PM31791 for IMS V11 to coexist with IMS V12
     after the IMS V12 APAR PM35154 is data
  
  2. The IMS V12 Release Planning Guide (ZES1-3088-00)
     Needs to be modified to add the coexistence APAR
     PM31791 for IMS V11 to coexist with IMS V12
     after the IMS V12 APAR PM35154 is installed.
  
  3. IMS Version 11 Commands, Volume 1: IMS Commands A - M
     (SC19-2430-01)
     a. Under header "INITIATE OLREORG command", "Table 3. Return
        and reason codes for the INITIATE OLREORG command", after
        " X'00000008' X'00002020' ", add "X'00000008' X'00002040'
        No filter, an invalid filter, or insufficient # of
        filters specified."
  
     b. Under header "INITIATE OLREORG command", "Table 4.
        Completion codes for the INITIATE OLREORG command", after
        "CE HALDB OLR cannot access all the data in the partition
        because an EEQE exists.", add "CF Parm value conflict".
  
     c. Under header "UPDATE OLREORG command", "Table 3. Return
        and reason codes for the UPDATE OLREORG command", after
        "X'00000008' X'00002008' ", add "X'00000008' X'00002040'
        No filter, an invalid filter, or insufficient # of
        filters specified."
  
     d. Under header "UPDATE OLREORG command", "Table 4.
        Completion codes for the UPDATE OLREORG command", after
        "24 No HALDB OLR is in progress.", add "CF Parm value
        conflict".
  

APAR Information

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

  PM31789

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

  UK67485

Modules/Macros

• DFSCMDRR
  DFSODB1D
  DFSORC00
  

Fix information

• Fixed component name

  IMS V11

• Fixed component ID

  5635A0200

Applicable component levels

• R100 PSY UK67485

     UP11/05/12 P F105

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.