PQ99842: HP UNLOAD API SHOULD ALLOW PROCOPT=A.

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible in next release.

Error description

• The HP Unload API currently does not allow a PCB with PROCOPT=A.
  When an option that is not allowed is specified in the PCB,
  all the DL/I calls to the PCB are transferred to the IMS
  DL/I interface, even if the types of DL/I calls are supported
  by the HP Unload API.
  In this case, the user application program can receive
  the retrieved segments, but the performance decreases.
  To avoid the decrease, the HP Unload API will allow a PCB
  with PROCOPT=A that is used for GET function.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS High Performance        *
  *                 Unload for OS/390 Release 1 (FMID=H1IN110).  *
  ****************************************************************
  * PROBLEM DESCRIPTION: In DLI or DBB region, HSSR Engine does  *
  *                      not accept the database PCB in which    *
  *                      PROCOPT=A or P is defined.              *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  The processing option (PROCOPT) codes that are allowed by HSSR
  Engine are G,O,N,T,R, and E.
  If other codes, such as 'A', is defined as the option,
  MSGFABH0091W is issued:
   +FABH0091W UNABLE TO PROCESS THE FOLLOWING PCB
                         AS AN HSSR PCB (REASON: PROCOPT )
  and all the DL/I calls to the PCB are transferred to IMS DL/I,
  even if the call types are supported by the HSSR Engine.
  In this case, there is no advantage in using the HSSR Engine.
  
  This APAR adds 'A' and 'P' to the allowable PROCOPT codes.
   - If the code 'A' is specified in a HSSR PCB, HSSR Engine will
   accept the PCB and treat the option as 'G' internally.
   Other functions 'I', 'R', and 'D' are not available.
  
   - The code 'P' is required if command code D is to be used.
   If the code 'P' is specified in a HSSR PCB, HSSR Engine will
   accept the PCB and process the DL/I calls until the first call
   with command code D.  If 'APISET 3' is specified in
   the HSSROPT dataset, the following calls are transferred
   to IMS DL/I.
  
  This APAR also includes the change of the FABH040 module
  to set the DBPCBPFX value to PSTDBPCB just before calling
  the compression routine with FUNC=INIT. The PSTDBPCB points
  to the IMS original PCB prefix, not the HSSR PCB prefix.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Unload for OS/390 User's Guide
  (SC27093603) should be changed as follows:
  
  1.0       Using High Performance Unload
  1.6       Application Programming Interface
  1.6.2     Preparing and Running Application Program
  1.6.2.2   Preparing a PSB
  1.6.2.2.2 Processing Option (PROCOPT) Requirements
  
   (In this section, the notes for the PROCOPT requirements
   are added.)
  
   :
   Notes:
   1. PROCOPT=R is also accepted for compatibility with DBT HSSR,
      but is, however, not recommended. See "Support of PROCOPT=R
      and Replace Calls" in topic 1.13.1.7.
  |2. PROCOPT=A is also accepted, but is, however, not
  |   recommended. Even if this PROCOPT is specified, HSSR engine
  |   treats it as PROCOPT=G.  The other functions I,R,and D are
  |   ignored.
  |3. PROCOPT=P is also accepted, but is, however, not
  |   recommended. Even if this PROCOPT is specified, D command
  |   Code is not processed by HSSR engine.
  
  ================================================================
  1.6.4 PCB Feedback Information
  
   :
   (In the table 14, the note for Processing Options is modified.)
  
   Table 14. HSSR PCB Mask
   ---------------------------------------------------------------
   Descriptor:  Processing Options
   Length    :  4 bytes
   Note      :  If PCBLIST HSSR, the default, is specified
                the first two bytes are always 'GX' and the last
                two bytes list additional processing options,
                such as 'O','ON','OT','E ', or 'R'.
  |             If the options are defined as 'GONP' or 'GOTP'
  |             in the PSB, the last two bytes are 'NP' or 'TP'.
                If PCBLIST IMS is specified, the content is
                the same as for IMS.
   ---------------------------------------------------------------
  
  ================================================================
  4.0       Messages and Codes
  4.4       Messages
  4.4.2     Message Variables
  4.4.2.1   FABH Messages
  
  (In this section, FABH0091W and FABH0671W are modified.)
  ----------------------------------------------------------------
   FABH0091W DBD=xxxxxxxx, PCB#=yyyy, PCBNAME=zzzzzzzz
  
   Explanation: The PCB that is specified as an HSSR PCB cannot
   be processed as an HSSR PCB. The string  xxxxxxxx shows
   the name of the DBD that the PCB refers to; the number yyyy
   shows the PCB number in the  PSB; and the string "zzzzzzzz"
   shows the label, if there is one, of the PCB assigned at
   PSBGEN. The string "rrrrrrrr" shows the reason for the error as
   follows:
    Reason Code Description
    :
    PROCOPT
     The PROCOPT parameter on the PCB statement specifies
     an incorrect code or combination of codes.
   | The allowable codes are G, O, N, T, R, A, P, and E.
    :
   System Action: The processing continues. If the PCB can be
   processed as a DL/I PCB, it is treated as a  DL/I PCB,
   and all HSSR calls to the PCB are transferred to the DL/I call
   interface modules.
   Programmer Response: If the database calls should be processed
   by HSSR Engine, check whether the specified PCB is correct.
   Otherwise, ignore this message and continue processing
   by using the DL/I module. You should check the HSSRPCB and
   HSSRDBD control statements or the KEYLEN value for the PCB.
  
  ----------------------------------------------------------------
   FABH0671W DB (xxxxxxxx) PCB IS NOT A VALID HSSR PCB, RC=yyyyyyy
  
   Explanation: When the first HSSR call is issued to the
   database, the database (xxxxxxxx) PCB is incorrect as HSSR PCB.
   If no database PCBs are in the PSB, then xxxxxxxx is blank.
   The reason code (RC=yyyyyyy) shows an error in the PCG.
   The program control is transferred to DL/I modules
   instead of HSSR Engine. It means that the database does not
   take advantage of HSSR Engine.
    RC Meaning
    :
    PROCOPT
     The PROCOPT parameter on the PCB statement specifies
     the incorrect code or combination of codes.
  |  The allowable codes are G, O, N, T, R, A, P, and E.
    :
    System Action: HSSR Engine continues processing.
    Programmer Response: If the database should be processed
    by HSSR Engine, check and correct the PCB that defines
    the database. Otherwise, ignore this message and continue
    processing by using DL/I modules.
  
    Problem Determination: Check the PROCOPT or KEYLEN parameter
    in the PCB. If the reason code is "KEYLEN" and the specified
    PCB does not refer to any DBDs that are listed on
    the DBDL1 control statement, the PCB can be specified
    as an HSSR PCB using the HSSRPCB control statement
    or through the HSSRDBD control statement.
  
  ===================== End of Doc-Change ========================
  

APAR Information

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

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

  UK00388

Modules/Macros

•    FABHHSS7 FABHHSS8 FABHHSS9 FABHJCB  FABHJCB0
  FABHPLI7 FABHPLI8 FABHPLI9 FABH0107 FABH0108 FABH0109 FABH0207
  FABH0208 FABH0209 FABH0307 FABH0308 FABH0309 FABH040
  

Fix information

• Fixed component name

  IMS HIGHPERF UN

• Fixed component ID

  5655E0600

Applicable component levels

• R110 PSY UK00388

     UP05/02/15 P F502

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.