PK43727: XTASKCTL PARMS TO BE OVERRIDDEN WITH THE SITE DEFAULT MODULE

APAR status

• Closed as new function.

Error description

• The ITASKCTL parm currently cannot be overriden with the SITE
  Default module.  This APAR is to add new function to allow it,
  along with the OTASKCTL and ATASKCTL parms.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of High Performance Fast Path      *
  *                 Advanced Tool Version 3 Release 1.           *
  *                 (FMID: H31A310)                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Fast Path Advanced Tool (FPA) allows    *
  *                      you to register the xTASKCTL keywords   *
  *                      as site defaults.                       *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR allows users to register the following keywords as
  site defaults:
     Command   Keywords
     --------  -------------------
     ANALYZE   ATASKCTL
     CHANGE    ITASKCTL, OTASKCTL
     EXTRACT   ITASKCTL
     RELOAD    ITASKCTL
     UNLOAD    ITASKCTL
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Fast Path Utilities for z/OS, V3R1, Vol.1
  High Performance Fast Path Reorganization Tool, User's Guide
  (SC18-9869-00) should be changed as follows:
  
  - Replace description of "parameter" and "Default:"
    in A.5 ATASKCTL as follows:
  
  Before:
  parameter
     You must specify this parameter in the following manner:
     Specify a value from 1 to 2048.
     - For the ANALYZE command, specify a value less than or
       equal to the number of input areas.
     - For the CHANGE command with PTRCHKLVL=QUICK or FULL,
       specify a value less than or equal to the OTASKCTL value.
     - For the RELOAD command with PTRCHKLVL=QUICK or FULL,
       specify a value less than or equal to the ITASKCTL value.
     If you specify a value that is greater than these values,
     it will be replaced by an appropriate value and message
      HFPC0008I will be issued.
  Default:
      ANALYZE
           The number of input areas.
      CHANGE
           OTASKCTL value.
      RELOAD
           ITASKCTL value.
  
  After:
  parameter
     AREA
       The number of input areas. AREA cannot be specified for
       the CHANGE command with PTRCHKLVL=QUICK or FULL, and for
       the RELOAD command with PTRCHKLVL=QUICK or FULL,
     nnnn
       Specify a value from 1 to 2048.
       You must specify this parameter in the following manner:
       - For the ANALYZE command, specify a value less than or
         equal to the number of input areas.
       - For the CHANGE command with PTRCHKLVL=QUICK or FULL,
         specify a value less than or equal to the OTASKCTL value.
       - For the RELOAD command with PTRCHKLVL=QUICK or FULL,
         specify a value less than or equal to the ITASKCTL value.
       If you specify a value that is greater than these values,
       it will be replaced by an appropriate value.
  Default:
      ANALYZE
           AREA
      CHANGE
           OTASKCTL value.
      RELOAD
           ITASKCTL value.
      This keyword can be specified for the site default for the
      ANALYZE command.
  
  
  - Replace description of "parameter" and "Default:"
    in A.45 ITASKCTL and A.57 OTASKCTL as follows:
  
  Before:
  parameter
     Specify a value from 1 to 2048. Specify a value less than
     or equal to the number of input areas. If you specify a
     value that is greater than the number of input areas,
     it will be replaced by the number of input areas and
     message HFPC0008I will be issued.
     In case of the CHANGE command in the REORG mode,
     the following value is set:
         (ITASKCTL + OTASKCTL)/2 (the value is rounded off)
  Default:
      The number of input areas.
  
  After:
  parameter
     AREA
       The number of input areas.
     nnnn
       Specify a value from 1 to 2048. Specify a value less than
       or equal to the number of input areas. If you specify a
       value that is greater than the number of input areas,
       it will be replaced by the number of input areas.
       In case of the CHANGE command in the REORG mode,
       the following value is set:
         (ITASKCTL + OTASKCTL)/2 (the value is rounded off)
  Default:
      AREA
      This keyword can be specified for the site default.
  
  - The following keywords are added for each command in F.3
    "Keywords that can be registered as site defaults in a site
     default table".
       Command   Keywords
       --------  -------------------
       ANALYZE   ATASKCTL
       CHANGE    ITASKCTL, OTASKCTL
       EXTRACT   ITASKCTL
       RELOAD    ITASKCTL
       UNLOAD    ITASKCTL
  

APAR Information

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

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

  UK25487

Modules/Macros

•    HFPCAPR0 HFPCCCT0 HFPCCDT0 HFPCDEF0 HFPCFCT0
  HFPCTSK0 HFPUMVT0 HFPZCCT  HFPZMVT  H31A310J
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R310 PSY UK25487

     UP07/05/26 P F705