PK28097: THIS APAR PROVIDES NEW FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides new function.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS High Performance Unload for *
  *                 OS/390 Release 1 (FMID=H1IN110)              *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a new option         *
  *                      'SKIPVLC YES' of HSSR Engine to skip    *
  *                      one or more virtual logical child       *
  *                      segments in DLI or DBB region.          *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  *                 This APAR level is required to run under     *
  *                 IMS Paralell Reorganization for z/OS,        *
  *                 Version 3 Release 2 (FMID H25N320).          *
  ****************************************************************
  This APAR provides a new option 'SKIPVLC YES' of HSSR Engine
  to skip one or more sensitive virtual logical child segment
  in the DLI or the DBB region. In the ULU region,
  logical child segments are always skipped.
  If 'SKIPVLC YES' is not specified in DLI or DBB region,
  the HSSR Engine issued the FABH0396E message;
    FABH0396E SENSITIVE VIRTUAL LOGICAL CHILD (segmname) IS FOUND
              IN PCB#=nnnn
  and then;
  - the utility of FABHURG1,FABHFSU,FABHTEST,and FABHBSIM issues
    a user abend U4013.
  - a user application that uses HP Unload API continues
    the processing by passing all calls to IMS DL/I.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  IBM IMS High Performance Unload for OS/390 User's Guide
  (SC27-0936-04) should be changed as follows:
  
  ================================================================
   1.0           Using High Performance Unload
   1.3.4 Restrictions common to FABHURG1 and FABHFSU
   :
    The restrictions that apply to HSSR application programs
    also apply to FABHURG1 and FABHFSU. See "Restrictions"
    in topic 1.6.5 in "Application programming interface"
    in topic 1.6.  Furthermore, the following restrictions
    apply to both FABHURG1 and FABHFSU:
    - The DBD that specifies the input database must be
      a physical DBD.
    - FABHURG1 and FABHFSU do not support sensitive, virtually
      paired segments.
  
  |    In the ULU region, the virtual logical child segment
  |    is ignored. In the DLI and the DBB region, the processing
  |    depends on "SKIPVLC control statement".
  |    For details of the SKIPVLC control statement,
  |    see "SKIPVLC control statement" in topic 1.8.2.2.X.
  
       The restriction applies to the unloading of databases
       for reorganization, because the data set input to
       IMS HD Reorganization Reload utility does not
       contain virtually paired segments.
  
     Note: Virtually paired segments are unloaded by FABHURG1
           when migration unload (to HALDB) is performed.
     :
  ================================================================
   1.8           Specifying options for HSSR Engine
   1.8.2         HSSROPT data set
   1.8.2.2       Description of control statements
  |1.8.2.2.X      SKIPVLC control statement
  |
  |  The SKIPVLC control statement requests HSSR Engine
  |  to ignore a sensitive virtual logical child segment
  |  in the DLI or the DBB region.
  |
  |  In the ULU region, the virtual logical child segment type
  |  is always ignored, therefore this control statement is
  |  not used.
  |
  |   0........1.........2.........3.........4.........5.....
  |   1234567890123456789012345678901234567890123456789012345
  |   SKIPVLC YES
  |           NO
  |
  |  Position Description
  |  1   Code the SKIPVLC keyword to ignore a sensitive
  |      virtual logical child segment in the HSSR PCB.
  |
  |  9   Specify one of the following keywords:
  |      Keyword Description
  |      YES  Requests HSSR Engine to ignore a sensitive virtual
  |           logical child segment in the HSSR PCB.
  |
  |      NO   Requests HSSR Engine not to ignore the sensitive
  |           virtual logical child. The HSSR Engine does not
  |           treat the PCB in which the logical child segment
  |           is sensitive as an HSSR PCB.
  |           - HP Unload utilities such as FABHURG1,
  |             FABHFSU and FABHTEST issue a user abend
  |             because the PCB is not an HSSR PCB.
  |           - In a user application program that uses
  |             the HP Unload API, all HSSR calls to the PCB
  |             fall back to DL/I calls.
  |
  |           This is the default.
  ================================================================
  4.4 Messages
  4.4.2 Message variables
  4.4.2.1 FABH messages
  
  (FABH0396E is modified and FABH0400I and FABH0679E are added.)
  ---------------------------------------------------------------
   FABH0396E SENSITIVE VIRTUAL LOGICAL CHILD (segmname) IS FOUND
             IN PCB#=nnnn
   Explanation: A sensitive virtual logical child segment segname
   is found in the HSSR PCB. nnnn shows the PCB number.
   HSSR Engine does not support sensitive virtual logical child
   segment.
   System Action: HSSR Engine issues a SNAP and falls back to DL/I
   for all PCBs. All PCBs are defined as DL/I PCBs and all calls
   are processed by DL/I action modules.
  | Programmer Response: If you do not need to retrieve
  | the virtual logical child segment, specify the 'SKIPVLC YES'
  | option in the HSSROPT data set.
  ----------------------------------------------------------------
  | FABH0400I VIRTUAL LOGICAL CHILD SEGMENT (segmname) IS IGNORED
  |
  | Explanation: HSSR Engine ignores the virtual logical child
  | segment segname that is specified in the HSSR PCB. In the DLI
  | or the DBB region, the 'SKIPVLC YES' option is used.
  | In the ULU region, it is always ignored.
  | System Action: HSSR Engine continues the processing.
  | Programmer Response: If you need the virtual logical child
  | to be retrieved in a user application program, specify
  | 'SKIPVLC NO' control statement. The PCB will be passed
  | to IMS DL/I and the virtual logical child segment will be
  | retrieved.
  ----------------------------------------------------------------
  | FABH0679E INCORRECT SKIPVLC CONTROL STATEMENT IS SPECIFIED
  |
  | Explanation: An incorrect operand on the SKIPVLC control
  | statement is specified in the HSSROPT data set.
  | The operand must be either "YES" or "NO".
  | System Action: The incorrect statement is ignored.
  | Programmer Response: Correct the SKIPVLC statement.
  ----------------------------------------------------------------
  ================= 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:

  UK17671

Modules/Macros

•    FABHRTI0 FABHTCB  FABHTCBU FABH001  FABH015
  FABH015A FABH0207 FABH0208 FABH0209 HPSUGVT0 HPSUURG8 HPSUURG9
  

Fix information

• Fixed component name

  IMS HIGHPERF UN

• Fixed component ID

  5655E0600

Applicable component levels

• R110 PSY UK17671

     UP06/09/06 P F609

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.