PI83671: ENABLE IMS MANAGED ACBS SUPPORT FOR HP UNLOAD

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables HP Unload to use the database definitions from
  the IMS catalog instead of from the DBDLIB specified in the IMS
  DD when IMS management of ACBs is enabled.
  

Local fix

Problem summary

• ****************************************************************
  
  * USERS AFFECTED: All users of IMS High Performance Unload for *
  
  *                 z/OS Version 1 Release 2 (FMID=H1IN120)      *
  
  ****************************************************************
  
  * PROBLEM DESCRIPTION: This APAR enables HP Unload to use the  *
  
  *                      database definitions from the IMS       *
  
  *                      catalog.                                *
  
  ****************************************************************
  
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  
  ****************************************************************
  
  This APAR enables HP Unload to use the database definitions from
  
  the IMS catalog instead of from the DBDLIB specified in the IMS
  DD when IMS management of ACBs is enabled.
  

Problem conclusion

• IMSMGDACBS/K
  

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS High Performance Unload for z/OS User's Guide
  Version 1 Release 2 Suffix 8 (SC27-0936-08) should be changed
  as follows:
  ----------------------------------------------------------------
  
  > IMS High Performance Unload overview
  >> Introduction to IMS High Performance Unload
  >>> IMS High Performance Unload system structure
  
  Change 'IMS DD' to 'IMS DD or IMS catalog directory' in
  "Figure 1. System structure and data flow"
  ----------------------------------------------------------------
  
  > Unloading IMS database
  >> Introduction to the unload utilities
  >>> Considerations for using the unload utilities
  |>>> Considerations for IMS-managed ACBs environment
  |
  |When the IMS management of ACBs is enabled, IMS reads database
  |descriptors (DBDs) from the IMS catalog instead of from
  |the DBD library that is specified in the IMS DD statement.
  |
  |Refer to the following JCL examples when you prepare IMS HP
  |Unload JCL to run an unload job in an IMS-managed ACBs
  |environment. For more information about coding IMS HP Unload
  |JCL, see "Basic job control language".
  |
  |Example 1: Specifying the DFSDF= parameter and DBRC=Y
  | +------------------------------------------------------------+
  
  | | //UNLOAD   EXEC FABHULU,                                   |
  
  | | //              MBR=FABHURG1,DBD=USERDBD,DBRC=Y,           |
  
  | | //              PARM1='DFSDF=CAT'                          |
  
  | | //G.PROCLIB   DD DSN=IMS.PROCLIB,DISP=SHR                  |
  
  | | //DBSAMP01  DD DSN=DBSAMP01.DATA1,DISP=OLD                 |
  
  | | //SYSUT2    DD DSN=DBSAMP01.UNLOAD,DISP=(NEW,PASS),        |
  
  | | //             SPACE=(CYL,(20,10))                         |
  
  | +------------------------------------------------------------+
  
  | DFSDF=CAT parameter is specified on the EXEC statement.
  | This parameter specifies the DFSDFCAT member that enables
  | IMS-managed ACBs. The name of the IMS.PROCLIB data set in
  | which the DFSDFCAT member exists is specified on the PROCLIB
  | DD statement.
  | You must allocate the catalog partition definition data set
  | when unloading a database with DBRC=NO. To do so, add the
  | DFSHDBSC DD statement or the DFSMDA member with the
  | TYPE=CATDBDEF statement.
  |
  |Example 2: Using the IMS Catalog Definition exit routine
  | +------------------------------------------------------------+
  
  | | //UNLOAD   EXEC FABHULU,                                   |
  
  | | //              MBR=FABHURG1,DBD=USERDBD,DBRC=Y            |
  
  | | //G.STEPLIB DD                                             |
  
  | | //          DD                                             |
  
  | | //          DD DSN=user.DFS3CDX0,DISP=SHR                  |
  
  | | //DBSAMP01  DD DSN=DBSAMP01.DATA1,DISP=OLD                 |
  
  | | //SYSUT2    DD DSN=DBSAMP01.UNLOAD,DISP=(NEW,PASS),        |
  
  | | //             SPACE=(CYL,(20,10))                         |
  
  | +------------------------------------------------------------+
  
  | The DFS3CDX0 exit routine must be bound into IMS.SDFSRESL or
  | a concatenated library.
  | You must allocate the catalog partition definition data set
  | when unloading a database with DBRC=NO. To do so, add the
  | DFSHDBSC DD statement or the DFSMDA member with the
  | TYPE=CATDBDEF statement.
  
  ---------------------------------------------------------------
  > Unloading IMS database
  >> Parallel Scan Facility of FABHFSU
  >>> Overview of Parallel Scan Facility
   Restrictions
   The restrictions that apply to FABHFSU in standard mode also
   apply to FABHFSU in PSF mode. For those restrictions , see
   Restrictions for IMS High Performance Unload.
  | Additionally, the following restrictions apply to PSF mode:
  | - FABHFSU does not support the unloading of an HISAM database
     under PSF mode.
  | - PSF mode does not support IMS-managed ACBs.
  
  ---------------------------------------------------------------
  > Basic job control language
  >> Preparing the basic JCL
  (Add Procedure 3)
  |3. If any of the following conditions apply, follow the
  |instructions in these topics:
  |
  |  - "Considerations for a logical parent's concatenated key"
  |  - "Considerations for an unloaded data set used for
  |    reorganization"
  |  - "Considerations for database sharing"
  |  - "Considerations for HALDB Online Reorganization capable
  |    partitions"
  |  - "Considerations for using a secondary index"
  |  - "Considerations for unloading an IMS catalog"
  |  - "Considerations for IMS-managed ACBs environment"
  ---------------------------------------------------------------
  > Troubleshooting
  >> Messages and codes
  >>> Messages
  >>>> FABH messages
  ---------------------------------------------------------------
  | FABH0639E IMS TOOLS CATALOG INTERFACE ERROR: FUNCTION=func
  |           RC=rc RSN=rsn
  | Explanation: HSSR Engine received an error return code from
  | IMS Tools Catalog Interface.
  | System action: HSSR Engine ends abnormally.
  | User response: Contact IBM Software Support.
  ---------------------------------------------------------------
  | FABH0640E DBD=dbdname IS NOT FOUND IN THE IMS DIRECTORY
  |           DATA SETS
  | Explanation: HSSR Engine could not find the indicated DBD
  | in the IMS directory data sets.
  | System action: HSSR Engine ends abnormally.
  | User response: Ensure that the correct DBD name is specified
  | on the EXEC statement and rerun the job.
  ---------------------------------------------------------------
  ================ 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:

  UI50473

Modules/Macros

•    FABHDBDX FABHFSUI FABHFSU3 FABHFSU4 FABHFSU5
  FABHLINK FABHRTI0 FABHTCBU HPSURDBD HPSUUXAI HPSU015  H1IN120J
  

Fix information

• Fixed component name

  IMS HIGHPERF UN

• Fixed component ID

  5655E0600

Applicable component levels

• R120 PSY UI50473

     UP17/10/04 P F710

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.