PM79078: SPACE MONITOR ENHANCEMENT FOR A NEW CONTROL STATEMENT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Space Monitor provides the new functions:
  - A new control statement that can be specified in a keyword
    format.
  - Data set names are not needed in new control statements.
    The data set names are retrieved from RECON or DFSMDA.
  
  This enhancement addresses the market requirement MR021210648.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS High Performance Pointer Checker for *
  *                 z/OS Version 3 Release 1 (FMID=HPC2310)      *
  *                 users who use Space Monitor(SPMN).           *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables SPMN to specify       *
  *                      keyword-style control statements and    *
  *                      get the database data sets name         *
  *                      automatically.                          *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  By this APAR, SPMN can support the following functions:
  
  - A keyword-style control statement that can be specified in
    FABKCTL that is a new dataset. For example, the following
    control statements can be specified in the FABKCTL data set.
  
    //FABKCTL  DD *
     PROC USER=(USER001,USER002),TOSIXCFGRP=TOIZZZZ,IMSID=SYSA
     OPTION THRESHOLDS=(EXTENTS=14,DSSIZE%=98)
    *    Non-HAL FFDB
       DATABASE DB=HDAM,DD=*ALL
         OPTION THRESHOLDS=DSSIZE%=90
    *    HALDB
       DATABASE DB=DPHS5100,PART=*ALL
         OPTION THRESHOLDS=(FREESPC%=20)
    *    DEDB
       DATABASE DB=DEDB1,AREA=*ALL
     END
  
  - SPMN can get database data set or area data set names from
    RECON or DFSMDA.
  

Problem conclusion

Temporary fix

Comments

• The following modules and macros are modified to support new
  functions:
  
  FABKACTL FABKADBS FABKADEF FABKAOPS FABKAPRS FABKARCA FABKARCN
  FABKAWK  FABKCOLL FABKMGTB FABKSPMD FABKSPMN FABKTGEN FABKURTO
  FABPARCA FABPLINK FABPMPC0 FABPSTMP FABPSTMS FABUARCA HPC2310J
  
  For detail information about this functional enhancement,
  see documentation updates " Update 13" dated December 2012
  in "Updates to IMS High Performance Pointer Checker V3.1
  User's Guide" page in IMS Tools library site:
    http://www-01.ibm.com/software/data/db2imstools/
    imstools-library.html
  
  In addition to the documentation updates in the above page,
  the following messages are newly added.
  
  Documentation Changes:
  
  Note: The section numbers are those of the BookManager (BKMGR)
  book.
  
  The documentation is modified as follows:
  ==============================================================
    IMS High Performance Pointer Checker for z/OS, V3R1,
    User's Guide (SC19240101)
  ==============================================================
  --------------------------------------------------------------
  8.0     Troubleshooting
  8.1     Messages and codes
  8.1.4   Space Monitor
  8.1.4.3 Messages
  --------------------------------------------------------------
  <<The following messages are added:>>
  
  |FABK8001E STATEMENT FORMAT ERROR
  |
  |Explanation: An error was detected in the specifications of
  |          statements.
  |System Action: Space Monitor ends with a return code of 8.
  |Programmer Response: Correct the error and rerun the job.
  
  |FABK8002E parm-name IS INVALID AS STATEMENT PARAMETER
  |
  |Explanation: An incorrect word parm-name was specified for the
  |          statement in the FABKCTL data set.
  |System Action: Space Monitor ends with a return code of 8.
  |Programmer Response: Correct the error and rerun the job.
  
  |FABK8003E parm-name PARAMETER IS INVALID FOR ctl-stmt-name
  |          STATEMENT
  |Explanation: An incorrect parameter(parm-name) was specified
  |          for the statement(ctl-stmt-name).
  |System Action: Space Monitor ends with a return code of 8.
  |Programmer Response: Correct the error and rerun the job.
  
  |FABK8004E THE NUMBER OF parm-name PARAMETERS EXCEEDS THE LIMIT,
  |          MAX IS nnn
  |Explanation: Too many parameters(parm-name) were specified. The
  |          parameter in error is shown on the messages. The
  |          maximum number of specifications for the parameter is
  |          nnn.
  |System Action: Space Monitor ends with a return code of 8.
  |User Response: Correct the error and rerun the job.
  
  |FABK8005E parm-name PARAMETER IS REQUIRED FOR ctl-stmt-name
  |          STATEMENT
  |Explanation: A required parameter(parm-name) is missing for the
  |          control statement(ctl-stmt-name).
  |System Action: Space Monitor ends with a return code of 8.
  |User Response: Specify the required parameter for the control
  |          statement, and rerun the job.
  
  |FABK8006E THE NUMBER OF OPERANDS FOR parm-name PARAMETER
  |          EXCEEDS THE LIMIT, MAX IS nnn
  |
  |Explanation: Too many parameter values were specified for the
  |          parameter(parm-name). The maximum number of parameter
  |          values is nnn.
  |System Action: Space Monitor ends with a return code of 8.
  |User Response: Correct the error and rerun the job.
  
  |FABK8007E LENGTH ERROR IN n-th OPERAND OF PARAMETER: parm-name
  |
  |Explanation: The length of the n-th parameter value for the
  |          parameter(parm-name) was not correct.
  |System Action: Space Monitor ends with a return code of 8.
  |Programmer Response: Correct the error and rerun the job.
  
  |FABK8008E n-th OPERAND IS REQUIRED FOR PARAMETER: parm-name
  |
  |Explanation: The n-th operand was not specified for the
  |          parameter(parm-name).
  |System Action: Space Monitor ends with a return code of 8.
  |Programmer Response: Specified the missing parameter value.
  |          Rerun the job.
  &#215;**** PE14/04/13 FIX IN ERROR. SEE APAR PI15904  FOR DESCRIPTION
  

APAR Information

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

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

  UK90612

Modules/Macros

• FABKACTL FABKADBS FABKADEF FABKAOPS FABKAPRS
  FABKARCA FABKARCN FABKCOLL FABKMGTB FABKSPMN FABKTGEN FABKURTO
  FABPARCA FABPLINK FABPMPC0 FABPSTMP FABPSTMS HPC2310J
  

Fix information

• Fixed component name

  IMS POINTER CHE

• Fixed component ID

  5655E0900

Applicable component levels

• R310 PSY UK90612

     UP12/12/27 P F212

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.