PQ96271: SMS KEYWORDS SPECIFIED IN GLOBAL STATEMENT ARE NOT EFFECTIVE WHEN USING STACKING FUNCTION.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The following keywords regarding SMS classes are not effective
  when using the STACKING function even though they are specified
  in the GLOBAL statement:
  
       DATACLAS
       MGMTCLAS
       STORCLAS
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy          *
  *                 for z/OS version 3 users (FMID=H1J0310)      *
  ****************************************************************
  * PROBLEM DESCRIPTION: HPIC ignores SMS related keywords       *
  *                      specified in the GLOBAL statement       *
  *                      when stacking is used.                  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the fix for following problem:
  HPIC ignores the following keywords specified in the GLOBAL
  statement when stacking is used:
     DATACLAS
     MGMTCLAS
     STORCLAS
  

Problem conclusion

• FABJICDD has been modified to set DATACLAS, MGMTCLAS, and
  STORCLAS keywords as allocation information of stacking output
  image copy data sets if they are specified in the GLOBAL
  statement.
  
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 3 Release 1
  User's Guide SC18-7617-00 ( SC18761700 ) should be changed
  as follows:
  
  
  6.2.4 Dynamic Allocation for the Stacked Data Set
  
    When stacking is used, the Image Copy function always
    dynamically allocates the stacked image copy data sets. The
    Image Copy function uses the allocation information inherited
    from the stacked data set. The data set name for each stacked
    image copy data set is constructed as follows:
  
       ichlq.ICn.dbdname.ddname.Dyyddd.Thhmmss
  
    where:
  
    ichlq
       is specified with the ICHLQ= keyword.
    n
       is 1 or 2 indicating the primary or secondary copy.
    dbdname
       is the DBD name or the partition dbdname of the database
       to be copied.
    ddname
  |    is the DD name specified in the STACK keyword.
    yyddd
       is the date.
    hhmmss
       is the time stamp.
  
  
    When the stacked data set is requested, HPIC dynamically
    allocates a dummy data set first. The dummy data set is not a
    real data set, but its allocation information is used
    internally for control. If you control the data set name by
    using the tape control program, you need to take the dummy
    data set into consideration. The dummy data set name is:
  
       DSN=ichlq.ddname.job_no.Thhmmss
  
    where:
  
    ichlq
       is the data set name prefix specified with the ICHLQ=
       keyword.
    ddname
       is the ddname specified in the STACK keyword.
    job_no
       is the job number of the HPIC execution job.
    hhmmss
       is the time stamp.
  
  
    Note: You can change the data set naming convention by the
          data set naming template.
  
  
  | When the stacking is used and DD card for stacked data set is
  | not presented in running JCL, the Image Copy function
  | dynamically allocates the stacked data set by using the
  | allocation information specified by the ICEIN control
  | statements.
  | The following keywords are effective for each stacked image
  | copy data set only when they are specified in the GLOBAL
  | statement. If they are specified in any other statement except
  | the GLOBAL statement, they are ignored.
  
       UNIT=icunit
  
    where:
  
    icunit
       is the unit name specified by the ICEIN UNIT keyword.
  
  
       VOL=(,,,volcnt,SER=(ser1,ser2,...))
  
    where:
  
    volcnt
       is the volume count specified by the ICEIN VOLCNT keyword.
    ser1, ser2 ...
       are the volume serial numbers specified by the ICEIN
       VOLSER keyword.
  
  
       EXPDT=expdt or RETPD=retpd
  
    where:
  
    expdt
       is the expiration date specified by the ICEIN EXPDT
       keyword.
    retpd
       is the retention period specified by the ICEIN RETPD
       keyword.
  
  
  |    DATACLAS=data-class-name
  |
  | where:
  |
  | data-class-name
  |    is the name of the data class specified by the ICEIN
  |    DATACLAS keyword.
  |
  |
  |    MGMTCLAS=management-class-name
  |
  | where:
  |
  | management-class-name
  |    is the name of the management class specified by the ICEIN
  |    MGMTCLAS keyword.
  |
  |
  |    STORCLAS=storage-class-name
  |
  | where:
  |
  | storage-class-name
  |    is the name of the storage class specified by the ICEIN
  |    STORCLAS keyword.
  
  
    The Image Copy function uses the volume information of the
    dynamically allocated stacked data set when allocating
    subsequent stacked image copy data sets.
  
  | Note: The disposition parameter for each stacked image copy
  |       data set is as follows:
  | DISP=(NEW,KEEP)
  

Temporary fix

Comments

APAR Information

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

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

  UQ95682

Modules/Macros

• FABJDALC
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R310 PSY UQ95682

     UP04/12/07 P F412

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.