PK21070: THIS APAR PROVIDES NEW FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides FCTOPPRC Primary option when FASTIC=(,COPY),
  and Secondary IC Options.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides some new keywords    *
  *                      of HPIC that are used for allocating    *
  *                      secondary ICs:                          *
  *                       - EXPDT2=                              *
  *                       - RETPD2=                              *
  *                       - STORCLAS2=                           *
  *                       - DATACLAS2=                           *
  *                       - MGMTCLAS2=                           *
  *                                                              *
  *                      Also, this APAR provides a new optional *
  *                      parameter for FASTIC= keyword,          *
  *                      'FCTOPPRCP'.                            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  HPIC V4R1 provides some new keywords which are used for
  allocating secondary image copy data sets:
  - EXPDT2= specifies expiration date for secondary ICs.
  - RETPD2= specifies retention period for secondary ICs.
  - STORCLAS2= specifies storage class for secondary ICs.
  - DATACLAS2= specifies data class for secondary ICs.
  - MGMTCLAS2= specifies management class for secondary ICs.
  These keywords are effective only for secondary image copy data
  sets.
  
  Also, HPIC V4R1 provides a new optional parameter for FASTIC=
  keyword.
  The new parameter FCTOPPRCP is to be specified only in third
  operand of FASTIC= keyword. This parameter is specified to use
  'FCTOPPRCPrimary' option for DFSMSdss.
  

Problem conclusion

Temporary fix

Comments

• FABJPARM, FABJPRM2, FABJTGEN, FABJMRGE, FABJSTMD and FABJBLKD
  have been modified to accept new keywords and a new optional
  parameter.
  
  FABJCSIF, FABJCSTD, FABJPRMD, FABJSTMP, FABJSTMS, FABJPRM3 and
  FABJRETC have been modified to change length of ICEIN keyword.
  The maximum length of keyword has become 12 characters.
  
  FABJGLRP has been modified to report new keywords for GLOBAL
  statement.
  
  FABJDALC, FABJDALO and FABJICDD have been modified to use
  options of DYNALLOC macro which specified in new keywords.
  
  FABJDFCN, FABJDSSB, FABJFCCM, FABJRDB7, FABJRDB8, FABJRDB9 and
  FABJRFCN have been modified to pass 'FCTOPPRCP' option to
  DFSMSdss.
  
  The following modules have been reassembled.
    FABJACQG, FABJAPIM, FABJATRC, FABJCMDB, FABJCRC0, FABJCRC1,
    FABJCRC3, FABJCTCV, FABJCZCV, FABJDALS, FABJDBCM, FABJDBC1,
    FABJDBD7, FABJDBD8, FABJDBD9, FABJDBF0, FABJDBLK, FABJDBR7,
    FABJDBR8, FABJDBR9, FABJDCTL, FABJDEMP, FABJDFC7, FABJDFC8,
    FABJDFC9, FABJDMP0, FABJDMP7, FABJDMP8, FABJDMP9, FABJDOPN,
    FABJDPS7, FABJDPS8, FABJDPS9, FABJDPUT, FABJDREQ, FABJDRQS,
    FABJFCAI, FABJFCC7, FABJFCC8, FABJFCC9, FABJFCD7, FABJFCD8,
    FABJFCD9, FABJGDGB, FABJIDX7, FABJIDX8, FABJIDX9, FABJINT1,
    FABJINT2, FABJINT3, FABJIPRC, FABJMAIN, FABJMAS1, FABJMDP7,
    FABJMDP8, FABJMDP9, FABJNTFC, FABJNTFI, FABJORC7, FABJORC8,
    FABJORC9, FABJRCH7, FABJRCH8, FABJRCH9, FABJRETD, FABJRETM,
    FABJRETP, FABJRETS, FABJRFC7, FABJRFC8, FABJRFC9, FABJRPT0,
    FABJSAS1, FABJSAS2, FABJSTA,  FABJTERM, FABJTOI,  FABJUIC1,
    FABJXCR,  FABJXHPC, FABJXLIM
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 1
  User's Guide SC18-9409-00 ( SC18940900 ) should be changed as
  follows:
  
  2.3.4.1 GLOBAL Statement
    The GLOBAL statement contains the following keywords:
      :
  | . DATACLAS2=
      :
  | . EXPDT2=
      :
  | . MGMTCLAS2=
      :
  | . RETPD2=
      :
  | . STORCLAS2=
      :
  
  2.3.4.2 GROUP Statement
    Optional keywords:
      :
  | . DATACLAS2=
      :
  | . EXPDT2=
      :
  | . MGMTCLAS2=
      :
  | . RETPD2=
      :
  | . STORCLAS2=
      :
  
  2.3.4.3 IC/AIC Statement
    Optional keywords:
      :
  | . DATACLAS2=
      :
  | . EXPDT2=
      :
  | . MGMTCLAS2=
      :
  | . RETPD2=
      :
  | . STORCLAS2=
      :
  
  2.3.4.4 CIC/ACIC Statement
    Optional keywords:
      :
  | . DATACLAS2=
      :
  | . EXPDT2=
      :
  | . MGMTCLAS2=
      :
  | . RETPD2=
      :
  | . STORCLAS2=
      :
  
  2.3.4.6 CRC Statement
    The following keywords are optional:
      :
  | . DATACLAS2=
      :
  | . EXPDT2=
      :
  | . MGMTCLAS2=
      :
  | . RETPD2=
      :
  | . STORCLAS2=
      :
  
  2.3.5.23 FASTIC=
  Add following explanation in this section.
     +---------------------------------------------------------+
     |       FASTIC=N |(REQ|PREF , DUMP|COPY , FCTOPPRCP)      |
     +---------------------------------------------------------+
    where:
      :
  | FCTOPPRCP
  |  Specifies that the DFSMSdss FCTOPPRCPrimary option is to be
  |  used in creating image copy.
  |  This optional parameter is effective, when the Fast Recovery
  |  Image Copy is requested.
  |  For details, see the description about FCTOPPRCPrimary in
  |  'z/OS DFSSMSdss storage administration reference'.
  |  NOTE:
  |   FCTOPPRCP option is to be ignored when ;
  |    - specified in FASTIC=(,DUMP) processing.
  |    - release level of DFSMSdss is lower than V1R6, because
  |      FCTOPPRCP option is supported by DFSMSdss V1R6 or higher.
  
  2.3.5 ICEIN Keywords
  Add following sub sections in this section.
    2.3.5.xx DATACLAS2=
    The DATACLAS2 keyword specifies the name of the data class for
    the new SMS managed image copy output data sets that are
    dynamically allocated.
    This keyword is effective for only secondary IC.
     +---------------------------------------------+
     |       DATACLAS2=data-class-name             |
     +---------------------------------------------+
    where:
    data-class-name
    is the name of the data class to be used for allocating the
    data set. The name, which is from one to eight characters, is
    defined by the storage administrator at your installation
    site.
    The DATACLAS2= keyword is not valid when you use the FASTIC=
    process and dynamic allocation.
    This keyword does not have a default.
  
    This keyword can be used in the following control statements:
      GLOBAL, GROUP, IC, CIC, AIC, ACIC, CRC
  
    2.3.5.xx EXPDT2=
    The EXPDT2 keyword specifies the expiration date of the output
    image copy data set.
    This keyword is effective for only secondary IC.
     +---------------------------------------------+
     |       EXPDT2=yyyyddd|yyddd                  |
     +---------------------------------------------+
    where:
    yyyyddd or yyddd
    is the expiration date of the output image copy. The date
    format should comply with the DFSMS format (the Julian
    calendar format).
    This keyword does not have a default.
  
    This keyword can be used in the following control statements:
      GLOBAL, GROUP, IC, AIC, CIC, ACIC, CRC
  
    2.3.5.xx MGMTCLAS2=
    The MGMTCLAS2 keyword specifies the name of the management
    class for the new SMS managed image copy output data sets that
    are dynamically allocated.
    This keyword is effective for only secondary IC.
     +---------------------------------------------+
     |       MGMTCLAS2=management-class-name       |
     +---------------------------------------------+
    where:
    management-class-name
    is the name of the management class to be used for allocating
    the data set. The name, which is from one to eight characters,
    is defined by the storage administrator at your installation
    site.
    An ACS routine can override the management class that you
    specify in the MGMTCLAS2 keyword.
    This keyword does not have a default.
  
    This keyword can be used in the following control statements:
      GLOBAL, GROUP, IC, CIC, AIC, ACIC, CRC
  
    2.3.5.xx RETPD2=
    The RETPD2 keyword specifies the retention period for the
    output image copy data set.
    This keyword is effective for only secondary IC.
     +---------------------------------------------+
     |       RETPD2=nnnn                           |
     +---------------------------------------------+
    where:
    nnnn
    is the retention period for the output image copy.
    This keyword does not have a default.
  
    This keyword can be used in the following control statements:
      GLOBAL, GROUP, IC, AIC, CIC, ACIC, CRC
  
    2.3.5.xx STORCLAS2=
    The STORCLAS2 keyword specifies the name of the storage class
    for the new SMS managed image copy output data sets that are
    dynamically allocated.
    This keyword is effective for only secondary IC.
     +---------------------------------------------+
     |       STORCLAS2=storage-class-name          |
     +---------------------------------------------+
    where:
    storage-class-name
    is the name of a storage class to be used for allocating the
    data set. The name, which is from one to eight characters, is
    defined by the storage administrator at your installation
    site.
    An ACS routine can override the storage class that you specify
    in the STORCLAS2 keyword.
    This keyword does not have a default.
  
    This keyword can be used in the following control statements:
      GLOBAL, GROUP, IC, CIC, AIC, ACIC, CRC
  
  6.2.4 Dynamic Allocation for the Stacked Data Set
  Add following explanation in this section.
       EXPDT=expdt or RETPD=retpd
  |    EXPDT2=expdt or RETPD2=retpd
       :
       DATACLAS=data-class-name
  |    DATACLAS2=data-class-name
       :
       MGMTCLAS=management-class-name
  |    MGMTCLAS2=management-class-name
       :
       STORCLAS=storage-class-name
  |    STORCLAS2=storage-class-name
  
  A.3.18 FABJ0109E
  Change the explanation as follows.
    FABJ0109E EXPDT= AND RETPD= ARE MUTUALLY EXCLUSIVE
  | Explanation: Both the EXPDT=(or EXPDT2=) and the RETPD=(or
  | RETPD2=) parameters are specified in a control statement, but
  | they are mutually exclusive.
  

APAR Information

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

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

  UK12893

Modules/Macros

• FABJACQG FABJAPIM FABJATRC FABJBLKD FABJCMDB
  FABJCRC0 FABJCRC1 FABJCRC3 FABJCSIF FABJCSTD FABJCTCV FABJCZCV
  FABJDALC FABJDALO FABJDALS FABJDBCM FABJDBC1 FABJDBDN FABJDBD7
  FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRC FABJDBR7 FABJDBR8
  FABJDBR9 FABJDCTL FABJDEMP FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9
  FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSN
  FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDSSB
  FABJFCAI FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDN
  FABJFCD7 FABJFCD8 FABJFCD9 FABJGDGB FABJGLRP FABJICDD FABJIDXN
  FABJIDX7 FABJIDX8 FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC
  FABJMAIN FABJMAS1 FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE
  FABJNTFC FABJNTFI FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM
  FABJPRMD FABJPRM2 FABJPRM3 FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9
  FABJRDB7 FABJRDB8 FABJRDB9 FABJRETC FABJRETD FABJRETM FABJRETP
  FABJRETS FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0 FABJSAS1
  FABJSAS2 FABJSTA  FABJSTMD FABJSTMP FABJSTMS FABJTERM FABJTGEN
  FABJTOI  FABJUIC1 FABJXCR  FABJXHPC FABJXLIM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK12893

     UP06/03/28 P F603

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.