PK33118: IMS V10 ( 10.0 ) SUPPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Provide support for IMS V10 ( 10.0 )
  

Local fix

• Apply fix
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS High Performance Unload     *
  *                 for OS/390 Release 1 (FMID=H1IN110)          *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables HP Unload to run      *
  *                      under IMS Version 10.                   *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables HP Unload to run under IMS Version 10
  and support the following new functions introduced
  by IMS Version 10:
  
  1. Parallel RECON access
  
   If IMS RECON is defined as ACCESS=PARALLEL, IMS DBRC SCI
   Registration requires IMSplex name and DBRC group ID.
   User can specify them in the DBRC SCI Registration exit
   (DSPSCIX0) or in the PARM parameter of the EXEC statement
   for PGM=FABHX034.
   Users of FABHULU, FABHDLI, and FABHDBB catalog procedures
   have to add the IMSPLEX= and PARM1= parameters.
   See the "1.2.2.3 Parameters required by the IMS DBRC SCI
   registration" in Documentation Change.
  
  2. z/OS 1.7 DFSMSdfp Large Sequential Data Sets >64k Tracks
  
   The unload utilities, FABHURG1, FABHFSU, and IPR Unload
   utility, support the large format data set for unload data
   sets if IMS Version 10 is used in z/OS V1R7 or later.
  

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.2 Job control language
   1.2.2 Supported IMS region types and cataloged procedures
  |1.2.2.3 Parameters required by the IMS DBRC SCI registration
  
   (This subtopic is added newly.)
  
  | When the IMS DBRC SCI registration requires the IMSplex name
  | and the DBRC group identification, you must add the parameters
  | such as IMSPLEX= or PARM1= to the FABHULU, FABHDLI, and
  | FABHDBB catalog procedures by yourself as shown in Figure xx.
  |
  | //        PROC IMSDSN=IMSVS,DBTLMD='HPS.SHPSLMD0',SOUT='*',
  | //             MBR=TEMPNAME,CTRL=DFSRRC00,DBD=,BUF=7,
  | //             SPIE=0,TEST=0,EXCPVR=0,RST=0,PRLD=,SRCH=0,
  | //             CKPTID=,MON=N,LOGA=0,FMTO=T,IMSID=,SWAP=,DBRC=,
  | //             IRLM=,IRLMNM=,IMSPLEX=,PARM1=
  | //G       EXEC PGM=FABHX034,PARM=('&CTRL/ULU',&MBR,&DBD,&BUF,
  | //             &SPIE&TEST&EXCPVR&RST,&PRLD,&SRCH,&CKPTID,&MON,
  | //             &LOGA,&FMTO,&IMSID,&SWAP,&DBRC,&IRLM,&IRLMNM,
  | //             ,,,,,,,,&IMSPLEX,,'&PARM1')
  | Figure xx. Adding IMSPLEX and PARM1 parameters
  |            to the FABHULU procedure
  |
  |In the JCL that uses the FABHULU procedure, you can specify
  |the parameter values as shown in Figure yy.
  |
  | //UNLOAD   EXEC FABHULU,
  | //            IMSDSN='IMSVS.SDFSRESL',
  | //            DBTLMD='IMS.SHPSLMD0',
  | //            MBR=FABHFSU,
  | //            DBD=PHDV0100,
  | //            DBRC=Y,
  | //            IRLM=Y,
  | //            IMSPLEX=PLEX1,
  | //            PARM1='DBRCGRP=001'
  | Figure yy. Example of the parameter specification
  |            for the FABHULU procedure
  |
  ================================================================
  1.4 Using FABHURG1 to unload IMS databases
  1.4.6 JCL requirements for FABHURG1
  
   :
   Notes.
  |1. The LRECL values for SYSUT2 and SYSUT3 data sets are
      determined as follows:
      :
  |2. The large format data set can be specified for SUSUT2 and
  |   SYSUT3 when z/OS Version 1 Release 7 or later
  |   and IMS Version 10 or later are used.
  ================================================================
   1.5 Using FABHFSU to unload IMS databases
   1.5.6 JCL requirements for FABHFSU
   :
   ddname1 DD
     This is the primary output data set containing the unloaded
     database. One DD statement is required for each PSB control
     statement (in the CARDIN data set) that specifies an output
     format other than NO. (ddname1 must be the name specified
     in the ddname1 field of the PSB control statement.
     See "PSB control statement" in topic 1.5.7.1.4.)
     You can have up to three of those data sets.
  |  The large format data set can be specified for those data
  |  sets if z/OS Version 1 Release 7 or later and IMS Version 10
  |  or later are used.
    :
  ================================================================
  4.4 Messages
  4.4.2 Message variables
  4.4.2.1 FABH messages
  
  (The new messages FABH0059E and FABH0316E are added.)
  ----------------------------------------------------------------
  | FABH0059E  TRACK NUMBER EXCEEDS 65535
  | Explanation: The database data set is larger than 65535 tracks
  | on a volume. To read such a large format data set,
  | the level of z/OS must be version 1 release 7 or later.
  | System Action: HSSR Engine ends abnormally.
  | Programmer Response: Check the level of z/OS.
  ----------------------------------------------------------------
  | FABH0316E  ERROR RETURN FROM IGWASYS (RC=xx, RSN=yy)
  | Explanation: HSSR Engine called IGWASYS, but an error return
  | code was returned from IGWASYS. Here, xx is the return code
  | and yy is the reason code.
  | System Action: HSSR Engine ends abnormally.
  | Programmer Response: See DFSMSdfp Advanced Services
  | and check the meaning of the return code and reason code.
  ----------------------------------------------------------------
  ================= End of Documentation Change ==================
  

APAR Information

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

  PK33111

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

  UK20901 002PC0Ÿ 002PC0Ÿ

Modules/Macros

•    FABHA30  FABHB15X FABHB20  FABHB30  FABHDATE
  FABHFCKR FABHFPHA FABHFSU  FABHFSUA FABHGDLA FABHHSSR FABHHSSX
  FABHHTBL FABHINI0 FABHKEYX FABHLINK FABHPLIX FABHPSLA FABHRPTH
  FABHRTI0 FABHTCB  FABHTCBU FABHTESA FABHTEST FABHURGA FABHURG1
  FABHX034 FABH000  FABH001  FABH002  FABH003A FABH010A FABH011
  FABH015  FABH015A FABH020A FABH021  FABH022  FABH030A FABH031
  FABH040  FABH041  FABH042A FABH050  FABH060  FABH070  FABH080
  FABH081  FABH082  FABH083  FABH090  FABH091  FABH092  FABH093
  FABH100  FABH105  FABH110  FABH111  FABH120A FABH130  FABH140
  FABH150  FABH160  FABH190  FABH200A FABH201  FABH250A FABH500
  FABH510  FABH511  FABH512  FABH513  FABH515A FABH516A FABH520
  FABH530  FABH535  FABH540A FABH550  FABH560  FABH620  FABH630A
  FABH650  FABH660  FABH661  FABH662  FABH663  FABH665  FABH680
  FABH681  FABIHTBL FABIUNLA FABIUNLS HPSSHDRH HPSSMSGT HPSSSCAA
  HPSSSCAN HPSSSEHA HPSUGVT0 HPSUHPTI HPSUHTBL HPSUMAIN HPSUMSGS
  HPSURIO0 HPSURPTH HPSURR01 HPSURR13 HPSUURGA HPSUURG1 HPSUUSHF
  H1IN110J
  

Fix information

• Fixed component name

  IMS HIGHPERF UN

• Fixed component ID

  5655E0600

Applicable component levels

• R110 PSY UK20901

     UP06/12/28 P F612

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.