PK09767: NEW KEYWORD TASKCTL IS SUPPORTED

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The TASKCTL keyword is supported in order to specify the maximum
  number of subtasks to be processed in parallel within a HPIC
  step.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 3 Release 2 users ( FMID=H1J0320 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: IMS High Performance Image Copy for     *
  *                      z/OS Version 3 Release 2 provides new   *
  *                      keyword TASKCTL= that controls maximum  *
  *                      number of TASKs in parallel.            *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  IMS High Performance Image Copy for z/OS Version 3 Release 2
  provides new keyword parameter TASKCTL= that controls maximum
  number of tasks in parallel. When you specify the number for IC
  tasks in the TASKCTL= keyword, HPIC schedules the specified
  number of tasks in parallel.
  

Problem conclusion

Temporary fix

Comments

• FABJMAIN has been modified to build the new internal table for
  TASKCTL= .
  
  FABJPARM and FABJPRM2 have been modified to check the keyword
  TASKCTL= and create a control block.
  
  FABJINT1 has been modified to build the new internal table for
  TASKCTL= .
  
  FABJSTMD has been modified to be able to specify TASKCTL= in the
  ICEIN.
  
  FABJTGEN has been modified to be able to specify the TASKCTL
  keyword for the Site Default Generation Utility.
  
  FABJICDD has been modified to set the contents of the new
  internal table for TASKCTL= .
  
  FABJDMPN has been modified to control the stack process for
  TASKCTL= .
  
  FABJDPSN has been modified to use the new internal table for
  TASKCTL= and to update that table for controlling the task
  exclusively.
  
  FABJBLKD has been modified to add new areas for TASKCTL= .
  
  FABJTMTD has been modified to generate the new internal table
  for the Image Copy function and the process with ICTYPE=B of IPR
  Version 3 Release 1.
  
  The following modules have been reassembled.
    FABJACQG  FABJATRC  FABJCMDB  FABJCRC0  FABJCRC1  FABJCTCV
    FABJCZCV  FABJDALC  FABJDALO  FABJDBCM  FABJDBC1  FABJDBD7
    FABJDBD8  FABJDBD9  FABJDBF0  FABJDBLK  FABJDBR7  FABJDBR8
    FABJDBR9  FABJDCTL  FABJDEMP  FABJDMP0  FABJDMP7  FABJDMP8
    FABJDMP9  FABJDOPN  FABJDPS7  FABJDPS8  FABJDPS9  FABJDPUT
    FABJDREQ  FABJDRQS  FABJINT2  FABJIPRC  FABJMAS1  FABJMDP7
    FABJMDP8  FABJMDP9  FABJMRGE  FABJNTFC  FABJORC7  FABJORC8
    FABJORC9  FABJRCH7  FABJRCH8  FABJRCH9  FABJRDB7  FABJRDB8
    FABJRDB9  FABJRPT0  FABJSAS2  FABJUIC1  FABJXLIM
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 3 Release 2
  User's Guide SC18-7617-01 ( SC18761701 ) should be changed as
  follows:
  
  2.0 Operating Instructions
  2.3 Input
  2.3.4.1 GLOBAL Statement
      :
    . STORCLAS=
    . |STACK=
  | . TASKCTL=
    . UNIT=
  
  2.3.5 ICEIN Keywords
  |  2.3.5.59 TASKCTL=
  | The TASKCTL keyword specifies the maximum number of IC subtask
  | in parallel.
  | +-----------------------------------------------------------+
  | | TASKCTL=nnn                                               |
  | +-----------------------------------------------------------+
  
  | where:
  |  nnn
  |    is the maximum number of IC subtasks in parallel.
  |    The valid value of nnn is 0-254.When the specified
  |    value is '0', it is same meaning of TASKCTL=254.
  |    When the specified DBDS is HALDB and database is flagged
  |    as ONLINE REORG CAPABLE in DBRC, HPIC automatically
  |    determines ACTIVE DBDS and uses a active DBDS ddname as
  |    input.
  
  | This keyword does not have a default.
  
  | Note:
  | When you specified TASKCTL= in GLOBAL statement and
  | GRPLIM= in GROUP statement, the total maximum task numbers
  | is depends on total number of process in parallel. If the
  | total numbers of process in GRPLIM in parallel is less than
  | the number of TASKCTL=, the number of tasks in parallel is
  | total of GRPLIM number. But if the total numbers of process is
  | bigger than TASKCTL= number, total tasks in parallel follows
  | TASKCTL= number.
  | For example:
  |   GLOBAL TASKCTL=10
  |   GROUP  GRPLIM=6,CAGRP=CAG1
  |   GROUP  GRPLIM=6,CAGRP=CAG2
  | In this case, 6 tasks are assigned for CAG1 group, and
  | 4 tasks are assigned to CAG2 group.
  | If the all tasks for CAG1 is finished before CAG2 process,
  | the task number for CAG2 is not increased.
  
  | This keyword can be used in the following control statements:
  |     GLOBAL
  
  | This keyword can be defined in site default table.
  
  3.0 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:
      :
    . SPACE
  | . TASKCTL
    . UNIT
  

APAR Information

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

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

  UK06153

Modules/Macros

• FABJACQG FABJATRC FABJBLKD FABJCMDB FABJCRC0
  FABJCRC1 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDBCM FABJDBC1
  FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRC
  FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDEMP FABJDMPN FABJDMP0
  FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSN FABJDPS7 FABJDPS8
  FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJICDD FABJINT1 FABJINT2
  FABJIPRC FABJMAIN FABJMAS1 FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9
  FABJMRGE FABJNTFC FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM
  FABJPRM2 FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8
  FABJRDB9 FABJRPT0 FABJSAS2 FABJSTMD FABJTERM FABJTGEN FABJTMTD
  FABJUIC1 FABJXLIM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R320 PSY UK06153

     UP05/08/12 P F508

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.