PK31299: USER= KEYWORD SUPPORT FOR HASH CHECKING.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• HPIC supports exception notification of HDPC by USER=
  keyword. User can specify notification receiving userids in
  ICEIN statement and when HDPC works under HPIC, there
  userids are used as exception notification receivers when
  HDPC finds any pointer, or T2, errors during HASH checking.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: HPIC provides the new keyword USER=.    *
  *                      This keyword is supported in order to   *
  *                      specify the TSO user IDs that IMS High  *
  *                      Performance Pointer Checker for z/OS    *
  *                      Version 2 Release 2 ( FMID=HPC2220 )    *
  *                      will send a notification message, when  *
  *                      pointer error or T2 error is detected.  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  HPIC provides the new keyword USER=. This keyword is supported
  in order to specify the TSO user IDs that IMS High Performance
  Pointer Checker for z/OS Version 2 Release 2 ( FMID=HPC2220 )
  will send a notification message, when pointer error or T2 error
  is detected.
  
  +--------------------------------------------------------------+
  |The USER= keyword is effective when you apply APAR PK31298 to |
  |IMS High Performance Pointer Checker for z/OS Version 2       |
  |Release 2 ( FMID=HPC2220 ) is required.                       |
  +--------------------------------------------------------------+
  

Problem conclusion

Temporary fix

Comments

• FABJMAIN, FABJINT1, FABJDMPN, and FABUITCT have been modified to
  pass the TSO user IDs specified by USER= keyword to HPPC.
  
  FABJPARM, FABJPRM2, FABJSTMD, FABJSTMP, FABJTGEN, and FABJBLKD
  have been modified to support the new keyword USER=.
  
  FABJGLRP has been modified to report the new keyword USER to
  Global Options Report.
  
  FABJMSGC has been modified to add the FABJ0423I message.
  
  The following modules have been reassembled.
    FABJACQG  FABJAPIM  FABJATRC  FABJCMDB  FABJCRC0  FABJCRC1
    FABJCRC3  FABJCTCV  FABJCZCV  FABJDALC  FABJDALO  FABJDALS
    FABJDBCM  FABJDBC1  FABJDBDN  FABJDBD7  FABJDBD8  FABJDBD9
    FABJDBF0  FABJDBLK  FABJDBRC  FABJDBR7  FABJDBR8  FABJDBR9
    FABJDCTL  FABJDEMP  FABJDFCN  FABJDFC7  FABJDFC8  FABJDFC9
    FABJDMP0  FABJDMP7  FABJDMP8  FABJDMP9  FABJDOPN  FABJDPSN
    FABJDPS7  FABJDPS8  FABJDPS9  FABJDPUT  FABJDREQ  FABJDRQS
    FABJFCAI  FABJFCCM  FABJFCCN  FABJFCC7  FABJFCC8  FABJFCC9
    FABJFCDN  FABJFCD7  FABJFCD8  FABJFCD9  FABJGDGB  FABJICDD
    FABJIDXN  FABJIDX7  FABJIDX8  FABJIDX9  FABJINT2  FABJINT3
    FABJIPRC  FABJMAS1  FABJMDPN  FABJMDP7  FABJMDP8  FABJMDP9
    FABJMRGE  FABJNTFC  FABJNTFI  FABJORCN  FABJORC7  FABJORC8
    FABJORC9  FABJPRM3  FABJRCHK  FABJRCH7  FABJRCH8  FABJRCH9
    FABJRDB7  FABJRDB8  FABJRDB9  FABJRETC  FABJRETM  FABJRFCN
    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 Operating Instructions
   2.3 Input
    2.3.4 HPIC Control Statements
     2.3.4.1 GLOBAL Statement
    The GLOBAL statement contains the following keywords:
      :
    . UNIT2=
  | . USER=
    . VIC=
      :
  
    2.3.5 ICEIN Keywords
  
    Table 10. ICEIN keywords
    +-------------------------+--------------------------+-------+
    |             |Parameters |                          |       |
    |             +-+-+-+-+-+-+                          |       |
    |             |G|G|I|C|R|C|                          |       |
    |   Keyword   |L|R|C|I|C|R|          Meaning         |Related|
    |             |O|O| |C|V|C|                          |keyword|
    |             |B|U| | | | |                          |       |
    |             |A|P| | | | |                          |       |
    |             |L| | | | | |                          |       |
    +-------------+-+-+-+-+-+-+--------------------------+-------+
           :            :                   :                :
    +-------------+-+-+-+-+-+-+--------------------------+-------+
    |UNIT2=       |O|O|O| | | |Specifies the UNIT        |       |
    |unitname|    | | | | | | |parameter for the         |       |
    |(unitname,   | | | | | | |secondary image copy data |       |
    |unitcount)   | | | | | | |set.                      |       |
    +-------------+-+-+-+-+-+-+--------------------------+-------+
  | |USER=*NO|    |O| | | | | |Specifies TSO user IDs    |HDPC=Y |
  | |user_id|     | | | | | | |that the HD Pointer       |       |
  | |(user_id1    | | | | | | |Checker utility will send |       |
  | | ,user_id2,  | | | | | | |a notification message to |       |
  | |.... )       | | | | | | |the TSO users, when       |       |
  | |             | | | | | | |pointer error or T2 error |       |
  | |             | | | | | | |is detected.              |       |
    +-------------+-+-+-+-+-+-+--------------------------+-------+
    |VIC=         |O|O|O| | | |Requests the Virtual Image|       |
    |             | | | | | | |Copy data set for the     |       |
    |             | | | | | | |primary index and the     |       |
    |             | | | | | | |secondary index data set. |       |
    +-------------+-+-+-+-+-+-+--------------------------+-------+
  
  |  2.3.5.XX USER=
  | The USER keyword specifies TSO user IDs that the HD Pointer
  | Checker utility will send a notification message to the TSO
  | users, when pointer error or T2 error is detected.
  |
  | +---------------------------------------------------------+
  | | USER=*NO|user_id|(user_id1 ,user_id2,.... )             |
  | +---------------------------------------------------------+
  |
  | where:
  |  *NO
  |    Notification message will not be sent to the TSO user. This
  |    is the default.
  |
  |  user_id or (user_id1 ,user_id2,.... )
  |    Specify up to 20 TSO user IDs. If the specified TSO user is
  |    not logged on to TSO or is disconnected from the terminal,
  |    the message will be discarded.
  |
  |    This keyword can also specify the special value *JOBUSR as
  |    one of these user IDs. This value will be converted to the
  |    user ID of the submitter of a JOB.
  |
  |    If an incorrect TSO user ID is specified, HD Pointer
  |    Checker will attempt to send the notification message to
  |    the TSO user and the message will be discarded.
  |
  | SUMMARY DD statement is required in order to send a
  | notification messages.
  |
  | This keyword can be used in the following control statements:
  |     GLOBAL
  
  3 Site Default Generation Utility
   3.2 Generating a Site Default Table
    3.2.2 Input
    The keywords for the Site Default Generation utility are as
    follows:
      :
    . UNIT=
  | . USER=
    . VIC=
      :
  
  A.0 Appendix A. Return Codes, Abend Codes, and Messages
   A.3 Messages
  
  The message FABJ0423I is added.
  | FABJ0423I  KEYWORD USER= IS IGNORED BECAUSE OF UNSUPPORTED
  | LEVEL OF HPPC
  |
  | Explanation: The keyword USER= is ignored.
  |
  | System Action: FABJMAIN continues the process.
  |
  | Programmer Response: Check your release level and maintenance
  | level of High Performance Pointer Checker for z/OS.
  

APAR Information

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

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

  UK18467

Modules/Macros

• FABJACQG FABJAPIM FABJATRC FABJBLKD FABJCMDB
  FABJCRC0 FABJCRC1 FABJCRC3 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 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 FABJMSGC FABJNTFC FABJNTFI
  FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJPRM3
  FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8 FABJRDB9
  FABJRETC FABJRETM FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0
  FABJSAS1 FABJSAS2 FABJSTA  FABJSTMD FABJSTMP FABJTERM FABJTGEN
  FABJTOI  FABJUIC1 FABJXCR  FABJXHPC FABJXLIM FABUITCT
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK18467

     UP06/10/06 P F610

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.