PM54604: THIS APAR PROVIDES HPIC V4.2 NEW FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides a new function of HP image Copy V4.2 and also
  fixes some problem that were found by tests.
  

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 provides following 2          *
  *                      enhancements:                           *
  *                                                              *
  *                      1. HP Image Copy Image Copy function    *
  *                         sets the return code 04 ( RC04 ) as  *
  *                         the jobstep return code, when the    *
  *                         process of /START command or UPDATE  *
  *                         DB STOP(QUIESCE) command for DB,     *
  *                         PART or AREA is not completed.       *
  *                                                              *
  *                         HP Image Copy also provides a new    *
  *                         keyword STACMDFAIL for the return    *
  *                         code handling.                       *
  *                         This keyword allows to change the    *
  *                         return code of command failure of    *
  *                         /START command or UPDATE DB          *
  *                         STOP(QUIESCE) command.               *
  *                                                              *
  *                         This enhancement is for FITS         *
  *                         MR0808115655.                        *
  *                                                              *
  *                      2. HP Image Copy provides the           *
  *                         TOSIXCFGRP keyword that is           *
  *                         synonymous with the TOIXCFGR         *
  *                         keyword.                             *
  *                                                              *
  *                      This APAR also fixes following          *
  *                      problem:                                *
  *                                                              *
  *                      The concurrent image copy process of    *
  *                      Image Copy function terminates with     *
  *                      ABEND U3835 ( ABENDU3835 ) for          *
  *                      non-recoverable DBDS when               *
  *                      NOTIFYMODE=COND is specified.           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides following 2 enhancements:
  
  1. HP Image Copy Image Copy function sets the return code 04
     ( RC04 ) as the jobstep return code, when the process of
     /START command or UPDATE DB STOP(QUIESCE) command for DB,
     PART or AREA is not completed.
  
     HP Image Copy also provides a new keyword STACMDFAIL for the
     return code handling.
     This keyword allows to change the return code of command
     failure of /START command or UPDATE DB STOP(QUIESCE) command.
  
     This enhancement is for FITS MR0808115655.
  
  2. HP Image Copy provides the TOSIXCFGRP keyword that is
     synonymous with the TOIXCFGR keyword.
  
  This APAR also fixes following problem:
  
  The concurrent image copy process of Image Copy function
  terminates with ABEND U3835 ( ABENDU3835 ) for non-recoverable
  DBDS when NOTIFYMODE=COND is specified.
  

Problem conclusion

Temporary fix

Comments

• HP Image Copy Image Copy function sets the
  return code 04 ( RC04 ) as the jobstep return code, when the
  process of /START command or UPDATE DB STOP(QUIESCE) command
  for DB, PART or AREA is not completed.
  
  The concurrent image copy process of Image Copy function
  processes normally for non-recoverable DBDS when NOTIFYMODE=COND
  is specified.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 2
  User's Guide SC19-2756-01 ( SC19275601 ) should be changed as
  follows:
  
  Running IMS HP Image Copy
    IMS HP Image Copy control statements and keywords
      ICEIN control statement keywords
        TOIXCFGR keyword
        :
  
        Format
         _____________________________________________
        |                                             |
        |   TOIXCFGR=TOI+xcf-group-name               |
  |     |   TOSIXCFGRP=TOI+xcf-group-name             |
        |_____________________________________________|
  
        TOI
         Is the prefix name of the XCF group name. Always specify
         this prefix 'TOI', when you use IMS Tools Online System
  |      Interface and identify a specific XCF group name.
  
        xcf-group-name
         Indicates the XCF group name. The group name is a 1-5
         alphanumeric character string that the IMS Tools Online
         System Interface prefixes with the characters TOI, to
         produce the XCF group name. This keyword is available
         only through FABJMAIN processing. There is no default.
  
         When you use the DB Sensor function to collect sensor
         data from a full-function database, certain
         considerations apply for the collected data element
         values. For details, see the topic "Considerations for
         collecting sensor data from full-function databases" in
         the IMS Solution Packs: Database Sensor User's Guide.
  
  |        Notes:
  |         - TOSIXCFGRP is synonymous with the TOIXCFGR. The HP
  |           Image Copy reports and messages display TOIXCFGR
  |           even is TOSIXCFGRP is specified.
  |         - TOIXCFGR and TOSIXCFGRP are exclusive in the GLOBAL
  |           statement.
  |         - TOIXCFGR and TOSIXCFGRP are exclusive in the Site
  |           Default Table.
  |         - TOIXCFGR in the site default table can be replaced
  |           by TOSIXCFGRP in the GLOBAL statement.
  |         - TOSIXCFGRP in the site default table can be replaced
  |           by TOIXCFGR in the GLOBAL statement.
  
  
  Running IMS HP Image Copy
    IMS HP Image Copy control statements and keywords
      HPSRETCD control statement
  
      :
      (HPIC)Statement
      :
      :
       The (HPIC) statement contains optional parameters, which
       are specified by the following keywords:
       -CATLGERROR=nn|0
       -COMPWARN=nn|0
       -DBERROR=nn|4
       -DEDBPCER=nn|2
       -EMPTYIDX=nn|8
       -ICDSNOTF=nn|8
       -INDEXCIC=nn|0
       -IOERROR=nn|8
       -PCLOADER=nn|4
       -SPMNERROR=nn|8
       -SPMNWARN=nn|4
  |    -STACMDFAIL=nn|4
       -T2ERROR=nn|2
       -TMSERROR=nn|8
      :
      :
       SPMNERROR=
       If space monitor detects a warning of return code 8, IMS HP
       Image Copy returns the return code specified by this
       parameter. nn is 0 - 99. The default value is 8. This is
       effective when HASH Check of HD Pointer Checker is
       requested.
  
  |    STACMDFAIL=
  |    If IMS HP Image Copy detects a failure of /START command or
  |    UPDATE DB STOP(QUIESCE)command for DB, PART or AREA by IMS
  |    Tools Online System Interface,
  |    HP Image Copy returns the return code specified by this
  |    parameter. nn is 0 - 99. The default value is 4.
  
       T2ERROR=
       Specify the return code that is to be issued when
       a T2 (unknown data) error is detected. nn is 0 - 99. The
       default value is 2. This is effective when HASH Check of
       HD Pointer Checker is requested.
  
  The following modules and macros have been modified for this
  APAR.
  
   FABJCSIF FABJDFCA FABJDFCB FABJDFCN FABJDFC2 FABJDFC9
   FABJDMPA FABJDMPB FABJDMPN FABJDMP2 FABJDMP9 FABJDPSA
   FABJDPSB FABJDPSN FABJDPS2 FABJDPS9 FABJFCCA FABJFCCB
   FABJFCCN FABJFCC2 FABJFCC9 FABJFCDA FABJFCDB FABJFCDN
   FABJFCD2 FABJFCD9 FABJOFL1 FABJPARM FABJRETC FABJRETD
   FABJRETM FABJRETT FABJRPT1 FABJSTA  FABJSTMD FABJTGEN
   FABJTOI2
  
  The following modules have been reassembled.
   FABJASPM FABJDRSN FABJPRM2 FABJPRM3 FABJRETP FABJRETS
   FABJSTMP FABJSTMS
  

APAR Information

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

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

  UK75045

Modules/Macros

•    FABJASPM FABJDFCA FABJDFCB FABJDFC2 FABJDFC9
  FABJDMPA FABJDMPB FABJDMP2 FABJDMP9 FABJDPSA FABJDPSB FABJDPS2
  FABJDPS9 FABJDRSN FABJFCCA FABJFCCB FABJFCC2 FABJFCC9 FABJFCDA
  FABJFCDB FABJFCD2 FABJFCD9 FABJOFL1 FABJPARM FABJPRM2 FABJPRM3
  FABJRETC FABJRETD FABJRETM FABJRETP FABJRETS FABJRPT1 FABJSTA
  FABJSTMD FABJSTMP FABJSTMS FABJTGEN FABJTOI2
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UK75045

     UP11/12/23 P F112

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.