PH12098: IMS HP IMAGE COPY ALLOW TO USE ENCRYPTED VSAM DATABASE

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• IMS HP Image Copy allow to use Encrypted VSAM database
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 2 users ( FMID=H1J0420 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables IMS High Performance  *
  *                      Image Copy to use encrypted VSAM        *
  *                      databases and to allocate encrypted     *
  *                      image copy data sets dynamically.       *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables IMS High Performance Image Copy to use
  encrypted VSAM databases and to allocate encrypted image copy
  data sets dynamically.
  

Problem conclusion

• This APAR enables IMS High Performance Image Copy to use
  encrypted VSAM databases and to allocate encrypted image copy
  data sets dynamically.
  *********************
  ***** Important *****
  *********************
  - Dump process of Advanced Image Copy (FASTIC=(opt,DUMP)) can
    not use for encrypted VSAM database process
  - HASH Check is not supported with Copy process of Advanced
    Image Copy (FASTIC=(opt,COPY)), when database is encrypted.
  - Offload stack of Copy process of Advanced Image Copy
    (FASTIC=(opt,COPY)), can not be used, when database is
    encrypted.
  - Logical copy process of Create Copy function (CRC) can not
    be used if the input image copy data set is encrypted Fast
    Replication format.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS High Performance Image Copy for z/OS Version 4
  Release 2 User's Guide (SC19-2756-02)
  ----------------------------------------------------------------
  > Running IMS HP Image Copy
  >> Control statements and keywords
  >>> ICEIN control statement keywords
  The following new topic has been added:
  KEYLABEL keyword
  Use this keyword to specify the encryption key label for
  encrypting dynamically allocated image copy data sets. The key
  label can be up to 64 bytes.
  
  Statements that support this keyword
  - GLOBAL statement
  - GROUP statement
  - IC/AIC statement
  - CIC/ACIC statement
  
  Site default option
  supported
  
  Format
  KEYLABEL='keylabel'
  
  keylabel
  Specify the encryption key label for image copy data set if you
  want to overwrite the one which defined in dataclas of SMS data
  management class. The key label can be up to 64 bytes.
  The key label string must be enclosed a pair of single
  quotations.
  
  >> Messages and codes
  The following new messages have been added:
  
  FABJ0012E SINGLE QUOTATIONS OF KEYLABEL OPERAND MUST BE SET AT
            FIRST AND LAST POSITION
  Explanation: The operand specified for the indicated keyword is
  not enclosed by single quotation marks. The operand for this
  keyword must be enclosed in a pair of single quotation marks.
  System action: Program FABJMAIN stops processing with a return
  code of 16.
  User response: See "ICEIN control statement keywords" and
  correct the keyword or the statement and rerun the job
  
  FABJ0013E THE VALUE OF keyword KEYWORD MUST BE SPECIFIED WITHIN
            2 LINES
  Explanation: The value specified for the indicated keyword must
  not span more than two lines.
  System action: Program FABJMAIN stops processing with a return
  code of 16.
  User response: Correct the value for the indicated keyword and
  rerun the job.
  
  FABJ0310E WHEN INPUT DATABASE IS ENCRYPTED, HPIC CANNOT USE
            DFSMSDSS DUMP COMMAND PROCESS
            DBD=xxxxxxxx DD/AREA=xxxxxxxx
  Explanation: One of input database data sets that is processed
  in the DUMP process of Advanced Image Copy is encrypted. The
  DUMP process does not support encrypted data sets.
  
  System action: FABJMAIN stops processing with a RC=8.
  User response: Modify the control statements so that the
  encrypted database data set is excluded from the job or use
  other image copy process.
  
  FABJ0311E WHEN INPUT DATABASE IS EXTENDED ADDRESSABILITY
            ATTRIBUTE, HPIC CANNOT CREATE IMAGE COPY
            DBD=dbd_name AREA=area_name [ADS=ads_name]
  Explanation: DEDB area data set has been allocated with the
  EXTENDED ADDRESSABILITY attribute. DEDB area data sets with this
  attribute cannot be processed by IMS HP Image Copy.
  System action: FABJMAIN stops processing with a RC=8.
  User response: Review the allocation attributes of the area data
  set and, if necessary, reallocate the area data set without the
  EXTENDED ADDRESSABILITY attribute.
  

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:

  UI64516

Modules/Macros

• FABJACQG FABJAPIM FABJASPM FABJATRC FABJCATS FABJCCAT FABJCMDB
  FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO
  FABJDALS FABJDAPI FABJDBAL FABJDBC1 FABJDBCM FABJDBD2 FABJDBD3
  FABJDBD4 FABJDBD5 FABJDBD9 FABJDBDA FABJDBDB FABJDBF0 FABJDBLK
  FABJDBR2 FABJDBR3 FABJDBR4 FABJDBR5 FABJDBR9 FABJDBRA FABJDBRB
  FABJDCTL FABJDDIM FABJDEMP FABJDFC2 FABJDFC3 FABJDFC4 FABJDFC5
  FABJDFC9 FABJDFCA FABJDFCB FABJDMP0 FABJDMP2 FABJDMP3 FABJDMP4
  FABJDMP5 FABJDMP9 FABJDMPA FABJDMPB FABJDOPN FABJDPS2 FABJDPS3
  FABJDPS4 FABJDPS5 FABJDPS9 FABJDPSA FABJDPSB FABJDPUT FABJDREQ
  FABJDRQS FABJDRSN FABJFCAI FABJFCC2 FABJFCC3 FABJFCC4 FABJFCC5
  FABJFCC9 FABJFCCA FABJFCCB FABJFCCM FABJFCD2 FABJFCD3 FABJFCD4
  FABJFCD5 FABJFCD9 FABJFCDA FABJFCDB FABJFDMP FABJGDGB FABJGLRP
  FABJICDD FABJIDX2 FABJIDX3 FABJIDX4 FABJIDX5 FABJIDX9 FABJIDXA
  FABJIDXB FABJIGWI FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJISDD
  FABJLINK FABJMAIN FABJMAS1 FABJMDP2 FABJMDP3 FABJMDP4 FABJMDP5
  FABJMDP9 FABJMDPA FABJMDPB FABJMRGE FABJMSGC FABJMSUL FABJNTFC
  FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJOINT FABJORC2
  FABJORC3 FABJORC4 FABJORC5 FABJORC9 FABJORCA FABJORCB FABJPARM
  FABJPRM2 FABJPRM3 FABJRCH2 FABJRCH3 FABJRCH4 FABJRCH5 FABJRCH9
  FABJRCHA FABJRCHB FABJRDB2 FABJRDB3 FABJRDB4 FABJRDB5 FABJRDB9
  FABJRDBA FABJRDBB FABJRETC FABJRETM FABJRFC2 FABJRFC3 FABJRFC4
  FABJRFC5 FABJRFC9 FABJRFCA FABJRFCB FABJRPT0 FABJRPT1 FABJSAS1
  FABJSAS2 FABJSDBK FABJSTA  FABJSTMD FABJSTMP FABJSTMS FABJTERM
  FABJTFSI FABJTGEN FABJTGET FABJTOI  FABJTOI2 FABJUIC1 FABJWCRD
  FABJXCR  FABJXHPC FABJXLIM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UI64516

     UP19/08/03 P F908 ¢

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.