IBM Support

PK16733: THIS IS A FORWARD-FIT APAR FROM HPIC V3R2.

A fix is available

Obtain the fix for this APAR.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • This APAR is a 'forward-fit' APAR from HPIC V3R2 which
supports the TASKCTL= parameter.

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 V4R1 provides new keyword TASKCTL= *
*                      that controls maximum number of TASKs   *
*                      in parallel.                            *
*                                                              *
*                      This APAR also includes some fixes of   *
*                      HPIC V4R1.                              *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
HPIC V4R1 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.

The following problems are fixed by this APAR:
- HPIC Concurrent Image Copy process issues incorrect NOTIFY.IC
  command, when FASTIC=COPY is requested for DEDB.
- Image Copy data set can not be registered into DBRC, when
  FASTIC=DUMP is requested for DEDB.
- Some common tasks does not serialize by ENQ/DEQ macro, when
  FASTIC=COPY or FASTIC=DUMP is requested.

    



Problem conclusion


    

  • 



Temporary fix


    

  • 



Comments


    

  • FABJMAIN and FABJINT1 have 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.

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.

FABJBRLS has been modified to receive the parameter for BRLSC
macro of DEDB unauthorization process.

FABJCMDB has been modified to set the correct parameter for
NOTIFY.IC command, when HPIC Concurrent Image Copy process is
processing the DEDB and requested FASTIC=COPY.

FABJDFCN has been modified following things:
- To use the new internal table for TASKCTL= and to update that
  table for controlling the task exclusively.
- To unify the resource name of ENQ/DEQ macro for BRLSC process
  and print of DFSPRINT DD process.
- To register the Image Copy data set of DEDB to DBRC RECON.

FABJFCCN has been modified to unify the resource name of ENQ/DEQ
macro for BRLSC process and print to DFSPRINT process.

FABJFCDN has been modified following things:
- To register the Image Copy data set of DEDB to DBRC RECON.
- To add the ENQ/DEQ macro for print of DFSPRINT DD process.

FABJGLRP has been modified to report the new keyword TASKCTL to
Global Options Report.

FABJMDPN has been modified to register the Image Copy data set
of DEDB to DBRC RECON.

The following modules have been reassembled.
  FABJACQG  FABJATRC  FABJCRC0  FABJCRC1  FABJCRC3  FABJCTCV
  FABJCZCV  FABJDALC  FABJDALO  FABJDALS  FABJDBCM  FABJDBC1
  FABJDBDN  FABJDBD7  FABJDBD8  FABJDBD9  FABJDBF0  FABJDBLK
  FABJDBRC  FABJDBR7  FABJDBR8  FABJDBR9  FABJDCTL  FABJDEMP
  FABJDFC7  FABJDFC8  FABJDFC9  FABJDMP0  FABJDMP7  FABJDMP8
  FABJDMP9  FABJDOPN  FABJDPS7  FABJDPS8  FABJDPS9  FABJDPUT
  FABJDREQ  FABJDRQS  FABJFCAI  FABJFCCM  FABJFCC7  FABJFCC8
  FABJFCC9  FABJFCD7  FABJFCD8  FABJFCD9  FABJINT2  FABJIPRC
  FABJMAS1  FABJMDP7  FABJMDP8  FABJMDP9  FABJMRGE  FABJNTFC
  FABJORCN  FABJORC7  FABJORC8  FABJORC9  FABJRCHK  FABJRCH7
  FABJRCH8  FABJRCH9  FABJRDB7  FABJRDB8  FABJRDB9  FABJRFCN
  FABJRFC7  FABJRFC8  FABJRFC9  FABJRPT0  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: Document Number: SC18-9409-00 ( SC18940900 )
should be changed as follows:

Chapter 2. Operating Instructions
2.3 Input
2.3.4 HPIC Control Statements
2.3.4.1 GLOBAL Statement
    :
  . STORCLAS=
  . STACK=
| . TASKCTL=
  . TOIAUTO=

2.3.5 ICEIN Keywords
|  2.3.5.xx 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-253. When the specified
|    value is '0', it is same meaning of TASKCTL=253.
|    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.

Chapter 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:
    :
  . RESTART
| . TASKCTL
  . TOIAUTO

    



APAR Information




    

  • APAR number
    PK16733
    • 

  • Reported component name
    IMS HP IMAGE CO
    • 

  • Reported component ID
    5655K9600
    • 

  • Reported release
    410
    • 

  • Status
    CLOSED  UR1
    • 

  • PE
    NoPE
    • 

  • HIPER
    NoHIPER
    • 

  • Special Attention
    NoSpecatt / Xsystem
    • 

  • Submitted date
    2005-12-14
    • 

  • Closed date
    2005-12-15
    • 

  • Last modified date
    2006-01-04
    • 





    

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

    • 

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

    
UK10155
    

    • 



Modules/Macros


    

  • FABJACQG FABJATRC FABJBLKD FABJBRLS FABJBRL7
FABJBRL8 FABJBRL9 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 FABJGLRP 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 FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0 FABJSAS2
FABJSTA  FABJSTMD FABJTERM FABJTGEN FABJTMTD FABJTOI  FABJUIC1
FABJXCR  FABJXHPC FABJXLIM

    




Publications Referenced


SC18940900    





Fix information


    

  • Fixed component name
    IMS HP IMAGE CO
    • 

  • Fixed component ID
    5655K9600
    • 



Applicable component levels


    

  • R410  PSY  UK10155
       UP05/12/17  P  F512
    • 



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.
    








      
              
                            

              

              [{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"4.1.0","Line of Business":{"code":"","label":""}}]
              

                          

          
 
        

      

    

      

        

          

            
Document Information


            

            


                        

            Modified date:
            

            14 December 2020
            

            
                      

        


        

        


      

    

  



    

  

  
    
            

          
Page Feedback