PK53858: TOIAUTO= NOW PROVIDES NONFEOV OPTION AND HPIC USES /DBD COMMAND INSTEAD OF /DBR FOR FF DB

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The following functionality has been added to
  the TOIAUTO command:
  this is defualt for TOIAUTO=Y. OLDS switches every
  time a /DBR or /DBD command is issued.
  TOIAUTO=(Y,LAST)   /DBR and /DBD use NONFEOV option, except for
  the last command that's issued.
  TOIAUTO=(Y,NO) /DBR and /DBD use NONFEOV option for every
  command. Hence the log is not swithced in HPIC processing.
  Also, TOSI has been changed to use /DBD for Full Function IMS
  data bases.
  

Local fix

• No Work Around.
  

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 a new optional       *
  *                      parameters for TOIAUTO= keyword:        *
  *                        For the second operand:               *
  *                         - EVERY                              *
  *                         - LAST                               *
  *                         - NO                                 *
  *                        For the third operand:                *
  *                         - DBR                                *
  *                         - DBD                                *
  *                                                              *
  *                      This APAR fixes following problems:     *
  *                      - HPIC Image Copy function can not      *
  *                        confirm the area stop status of DEDB, *
  *                        when TOIAUTO=Y or O is requested.     *
  *                      - HPIC Create Image Copy function       *
  *                        terminates with ABEND S0C6            *
  *                        ( ABEND0C6 ) at FABJMAIN + X'D4C4',   *
  *                        when FASTIC=(,COPY) is processed with *
  *                        NOTIFY=Y.                             *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides a new optional parameters for TOIAUTO=
  keyword.
  
  The new parameters for the second operand indicate when to
  switch the IMS log to the next OLDS:
   - EVERY
      specified to indicate that the log is to be switched to next
      OLDS and a checkpoint is to be taken every time the database
      is stopped. This is the default.
   - LAST
      specified to indicate that the log is to be switched to next
      OLDS and a checkpoint is to be taken when the last IMS
      command is issued to stop the database.
   - NO
      specified to indicate that the log is not to be switched to
      next OLDS and a checkpoint is not to be taken when the
      database is stopped.
  
  The new parameters for the third operand indicate which command
  is to be issued for full-function DB and HALDB, /DBRECOVERY or
  /DBDUMP.
   - DBR
      specified to issue /DBRECOVERY command to stop full-function
      DB and HALDB. This is the default.
   - DBD
      specified to issue /DBDUMP command to stop full-function DB
      and HALDB.
  
  These new parameters are to be specified only in TOIAUTO=
  keyword of GLOBAL statement.
  These new parameters are ignored on following conditions:
   - Specified in TOIAUTO= keyword of AIC/IC/GROUP statement.
   - TOIAUTO=N is specified.
  
  This APAR fixes following problems:
  - HPIC Image Copy function can not confirm the area stop status
    of DEDB, when TOIAUTO=Y or O is requested.
    By this APAR, HPIC uses /DIA AREA to checks whether DEDB area
    has been stopped or not.
  
  - HPIC Create Image Copy function terminates with ABEND S0C6
    ( ABEND0C6 ) at FABJMAIN + X'D4C4', when FASTIC=(,COPY) is
    processed with NOTIFY=Y. Because HPIC sets a timestamp of
    runtime to incorrect field in the work area, then the
    HPIC instructions are overwritten.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 1
  User's Guide SC18-9409 ( SC189409 ) should be changed as
  follows:
  
  3.0 Operating instructions
   3.4 ICEIN control statement data set
    3.4.3 Option parameters
     3.4.3.71 TOIAUTO=
  
  Add following explanation in this section.
     +---------------------------------------------------------+
  |  |    TOIAUTO=Y|N|O | (Y|O,EVERY|LAST|NO,DBR|DBD)          |
     +---------------------------------------------------------+
    where:
    Y
      :
    N
      :
    O
      :
  | EVERY
  |  indicates that the log is to be switched to next OLDS and a
  |  checkpoint is to be taken every time the database is stopped.
  |  This is the default.
  |
  | LAST
  |  indicates that the log is to be switched to next OLDS and a
  |  checkpoint is to be taken only when the last IMS command is
  |  issued to stop the database.
  |
  | NO
  |  indicates that the log is not to be switched to next OLDS and
  |  a checkpoint is not to be taken when the database is stopped.
  |
  | DBR
  |  indicates that /DBRECOVERY command is to be issued to stop
  |  full-function DB and HALDB and DEDB. This is the default.
  |
  | DBD
  |  indicates that /DBDUMP command is to be issued to stop
  |  full-function DB and HALDB. When specified to DEDB, this
  |  option is ignored.
  |
  
  FABJPARM, FABJSTMD, FABJTGEN and FABJBLKD have been modified to
  accept new parameters.
  
  FABJGLRP has been modified to report new parameters for TOIAUTO=
  keyword.
  
  FABJTOI and FABJSTA have been modified to build IMS command
  according to the new parameters. If log is not needed to switch,
  'NOFEOV' option parameter is specified to IMS command.
  
  FABJDBIM has been modified to save new information to search for
  the last command of an IMSID.
  
  FABUITCT has been modified to save DBIMBLK entry address
  corresponds to the TCT entry.
  
  FABJFCCN has been modified to not get a timestamp of runtime in
  Create Image Copy and Recovery processing.
  
  The following modules have been reassembled.
    FABJACQG, FABJAPIM, FABJASPM, FABJATRC, FABJCMDB, FABJCRC0,
    FABJCRC1, FABJCRC3, FABJCTCV, FABJCZCV, FABJDALC, FABJDALO,
    FABJDALS, FABJDBAL, FABJDBCM, FABJDBC1, FABJDBDA, FABJDBD7,
    FABJDBD8, FABJDBD9, FABJDBF0, FABJDBLK, FABJDBRA, FABJDBR7,
    FABJDBR8, FABJDBR9, FABJDCTL, FABJDDIM, FABJDEMP, FABJDFCA,
    FABJDFC7, FABJDFC8, FABJDFC9, FABJDMP0, FABJDMPA, FABJDMP7,
    FABJDMP8, FABJDMP9, FABJDOPN, FABJDPSA, FABJDPS7, FABJDPS8,
    FABJDPS9, FABJDPUT, FABJDREQ, FABJDRQS, FABJDRSN, FABJFCAI,
    FABJFCCA, FABJFCC7, FABJFCC8, FABJFCC9, FABJFCCM, FABJFCDA,
    FABJFCD7, FABJFCD8, FABJFCD9, FABJGDGB, FABJGLRP, FABJICDD,
    FABJIDXA, FABJIDX7, FABJIDX8, FABJIDX9, FABJINT1, FABJINT2,
    FABJINT3, FABJIPRC, FABJMAIN, FABJMAS1, FABJMDPA, FABJMDP7,
    FABJMDP8, FABJMDP9, FABJMRGE, FABJNTFC, FABJNTFI, FABJNTFS,
    FABJORCA, FABJORC7, FABJORC8, FABJORC9, FABJPRM2, FABJPRM3,
    FABJRCHA, FABJRCH7, FABJRCH8, FABJRCH9, FABJRDBA, FABJRDB7,
    FABJRDB8, FABJRDB9, FABJRETC, FABJRETM, FABJRFCA, FABJRFC7,
    FABJRFC8, FABJRFC9, FABJRPT0, FABJRPT1, FABJSAS1, FABJSAS2,
    FABJTERM, FABJUIC1, FABJXCR,  FABJXHPC, FABJXLIM
  

APAR Information

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

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

  UK30199

Modules/Macros

• FABJACQG FABJAPIM FABJASPM FABJATRC FABJBLKD
  FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC
  FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDN
  FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBIM FABJDBLK FABJDBRA
  FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP
  FABJDFCA FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPA FABJDMPN
  FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSA FABJDPSN
  FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN
  FABJFCAI FABJFCCA FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9
  FABJFCDA FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJGDGB FABJGLRP
  FABJICDD FABJIDXA FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9 FABJINT1
  FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1 FABJMDPA FABJMDPN
  FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJNTFC FABJNTFI FABJNTFS
  FABJORCA FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2
  FABJPRM3 FABJRCHA FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDBA
  FABJRDB7 FABJRDB8 FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCN
  FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2
  FABJSTA  FABJSTMD 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 UK30199

     UP07/12/28 P F712

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.