PM04417: THIS APAR PROVIDES HPIC V4.1 NEW FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides HPIC V4.1 new function
  

Local fix

• N/A
  

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 IMS GLOBAL command   *
  *                      support and a new optional parameters   *
  *                      for TOIAUTO= keyword:                   *
  *                        For the fifth operand:                *
  *                         - GLOBAL                             *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides IMS GLOBAL command support and a new optional
  parameters for TOIAUTO= keyword:
    For the fifth operand:
     - GLOBAL
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 1
  User's Guide SC18-9409-02 ( SC18940902 ) should be changed as
  follows:
  
  3.0 Operating instructions
  3.4 ICEIN control statement data set
  3.4.3 Option parameters
  3.4.3.77 TOIAUTO keyword
  
  Format
  
  The description is changed as follows:
     ___________________________________________________
    |                                                   |
  | | TOIAUTO=(Y|N|O, EVERY|LAST|NO , DBR|DBD ,         |
  | |          FIRST|SECOND , GLOBAL )                  |
    |___________________________________________________|
    where:
      :
    SECOND
      :
  | GLOBAL indicates that /DBRECOVERY, /DBDUMP, and /START
  | commands are to be issued with the GLOBAL keyword for the
  | database or area, which means these IMS commands apply to all
  | online subsystems sharing the database or area. The default is
  | no GLOBAL parameter specified.
      :
    Considerations
      :
    IMS command process run by IMS Tools Online System Interface
    must meet the following conditions:
    - DBRC=Y is required.
    - Database data set or area must be registered to the DBRC
  |   except in specifying the GLOBAL parameter.
  |
  | If TOIAUTO=Y or O is specified but the target IMS is not
  | online, HP Image Copy continues the processing as TOIAUTO=N.
  |
  | In using the GLOBAL parameter, please note following things:
  | - The IRLM must be active. If IRLM is not active, the command
  |   is rejected. Please refer IMS V10 Command reference for
  |   detail.
  | - /DBR GLOBAL, /DBD GLOBAL and /STA GLOBAL commands are issued
  |   even if the database data set or area are not registered to
  |   the DBRC.
  | - Even if /DBR GLOBAL or /DBD GLOBAL command fails, the
  |   process of Image copy is continued.
  | - If the GLOBAL and the LAST parameters are specified, LAST is
  |   replaced with EVERY.
  
  12.0 Reference: Return codes, abend codes, and messages
  12.3 Messages
  12.3.xx
  
   FABJ4607E /STA COMMAND FAILED FOR DBD/AREA=cccc ON IMS=cccc
   RC=nnnn RSN=nnnn. ISSUE /STA MANUALLY
  |
  | Explanation: An attempt to run the /START command for the DBD
  | or AREA has failed.
  | System action: The DBD or AREA remains offline, and IMS HP
  | Image Copy terminates with RC=8.
  | Programmer Response: Manually issue the /START command for the
  | DBD or AREA. If the problem persists, contact IBM Software
  | Support, and provide the RC and RSN found in the message.
  
  | FABJ4616I /DBR GLOBAL COMMAND FAILED FOR DBD/AREA=cccc ON
  | IMS=cccc RC=nnnn RSN=nnnn.
  |           /DBD GLOBAL COMMAND FAILED FOR DBD/AREA=cccc ON
  | IMS=cccc RC=nnnn RSN=nnnn.
  | Explanation: An attempt to run the /DBR or /DBD command for
  | the DBD or AREA has failed.
  | System action: IMS HP Image Copy continues processing.
  | Programmer Response: Contact IBM Software Support, and provide
  | the RC and RSN found in the message
  
  FABJTOI and FABJSTA have been modified as follows:
  - IMS GLOBAL command can be issued if GLOBAL is specified.
  - IMS GLOBAL command can be issued even if the DBD or AREA is
    not registered when GLOBAL is specified.
  - IMS command is issued only if the authorization for DBD or
    AREA with ACCESS INTENT=EXCLUSIVE or UPDATE.
  
  FABJMAIN has been modified to enable issuing IMS command even if
  the DBD or AREA is not registered when GLOBAL is specified.
  
  FABJBLKD, FABJPARM, FABJTGEN, FABJGLRP and FABJSTMD have been
  modified to support the new operand GLOBAL for TOIAUTO keyword.
  ×**** PE10/06/21 PTF IN ERROR. SEE APAR PM16600  FOR DESCRIPTION
  

APAR Information

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

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

  UK53788

Modules/Macros

• FABJBLKD FABJDMPA FABJDMPB FABJDMPN FABJDMP7
  FABJDMP8 FABJDMP9 FABJGLRP FABJMAIN FABJPARM FABJSTA  FABJSTMD
  FABJTGEN FABJTOI
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK53788

     UP10/01/29 P F001

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.