IBM Support

PK04599: SPACE MONITOR UTILITY IS INTEGRATED INTO THE HD POINTER CHECKER STEP

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 enhances HD Pointer Checker
to call the Space Monitor utility program
FABKSPMN internally.

Local fix

  •

Problem summary

  • ****************************************************************
* USERS AFFECTED: -IBM IMS High Performance Pointer Checker    *
*                  for z/OS Version 2 Release 1 (FMID=HPC2210) *
*                  users                                       *
*                 -IMS High Performance Image Copy (HPIC)      *
*                    Version 3 Release 1 or 2                  *
*                    (FMID=H1J0310 or H1J0320) users           *
*                    who invoke the single-step HASH checking  *
*                    option of HD Pointer Checker.             *
*                 -IMS Parallel Reorganization for z/OS (IPR)  *
*                    Version 3 Release 1  (FMID=H25N310) users *
*                    who invoke the single-step HASH checking  *
*                    option of HD Pointer Checker with HPIC.   *
****************************************************************
* PROBLEM DESCRIPTION: The Space Monitor utility is integrated *
*                      into the HD Pointer Checker.            *
****************************************************************
* RECOMMENDATION: Apply the maintenance for this APAR.         *
****************************************************************
By applying this APAR, Space Monitor can be called from
HD Pointer Checker. Space Monitor reports and
the warning for threshold messages are generated in HD
Pointer Checker.

This new function is supported in the following environment:
- HD Pointer Checker running as a stand alone job.
- HD Pointer Checker running as the single-step HASH checking
  option
  from IMS High Performance Image Copy (HPIC)
  Version 3 Release 1 (FMID=H1J0310) or
  Version 3 Release 2 (FMID=H1J0320).

Note that Space Monitor cannot be called in HD Pointer Checker
if HD Pointer Checker is run as the multiple-step HASH checking
option with HPIC,
or if HD Pointer Checker running as the single-step HASH
checking option conjunction with HPIC be called in HD Pointer
Checker from IMS Parallel Reorganization for z/OS (IPR)
HASH checking Version 3 Release 1  (FMID=H25N310)

Problem conclusion

  •

Temporary fix

  •

Comments

  • Documentation Changes:

The documentation is modified as follows:

The section numbers are of the the BookMgr (BKM) file.

==============================================================
  IMS High Performance Pointer Checker for z/OS, V2R1,
  User's Guide Vol.1 (SC18725701)
==============================================================

2.0       HD Pointer Checker

==============================================================
2.1.1.4 Restrictions
Add the following statements to the bottom of this section.
--------------------------------------------------------------
|Space Monitor can be called in the HD Pointer Checker
|program when :
| - The HD Pointer checker FABPMAIN program is submitted
|   with TYPE=ALL or TYPE=SCAN.
| - HD Pointer Checker is run as the single-step HASH checking
|   option
|   with IMS High Performance Image Copy (HPIC)
|   Version 3 Release 1 or Version 3 Release 2.
|
|Note that Space Monitor cannot be called in HD Pointer Checker
|if HD Pointer Checker is run as the multiple-step HASH checking
|option with HPIC,
|or if HD Pointer Checker running as the single-step HASH
|checking option conjunction with HPIC
|from IMS Parallel Reorganization for z/OS (IPR)
|Version 3 Release 1  (FMID=H25N310)

2.1.1.1.7 Space Monitor
Add the following statements as a new section 2.1.1.1.7.
--------------------------------------------------------------
2.1.1.1.7 Space Monitor
|HD Pointer Checker can call the Space Monitor utility and
|process the following functions:
|- Monitor and log data set space utilization
|- Describe space utilization
|For the details of the Space Monitor functions, see
|IMS High Performance Pointer Checker
|for z/OS Version 2 User's Guide Volume 2.
|
|Space Monitor functions are called when the SPMNIN and
|SPMNSPDT DD statements are specified for FABPMAIN JCL.
|For more details, see 2.1.5.1.2 DD Statements.

==============================================================
2.1.4.1 Data Flow
Add the following statement in this section.
--------------------------------------------------------------
|The Space Monitor process can be run inside or outside
|the HD Pointer Checker program.

==============================================================
2.1.5.1.2 DD Statements
Add the following statements to the bottom of this section.
--------------------------------------------------------------
|DD statements to call Space Monitor
|
|If the SPMNIN and SPMNSPDT DD statements are specified for
|TYPE=ALL or TYPE=SCAN of FABPMAIN JCL, HD Pointer Checker calls
|Space Monitor internally.
|
|The SPMNMBR DD statement cannot be specified for the FABPMAIN
|JCL.
|Only SPMNIN can be used.
|
|For details of each DD statement, see 3.2 Operating
|Instructions in IMS High Performance Pointer Checker
|for z/OS Version 2 User's Guide Volume 2.

==============================================================
2.1.6     Input
2.1.6.3.4, which had been added by PK00511, is also modified,
because new keyword parameters SPMNWARN and SPMNERROR are
added by this APAR.
--------------------------------------------------------------

   (HDPC)
    _                   _
   |    T2ERROR=nn|2     |
   |   ,DBERROR=nn|4     |
   |   ,PROCERROR=nn|8   |
|  |   ,SPMNWARN=nn|4    |
|  |   ,SPMNERROR=nn|8   |
   |_                   _|

|  SPMNWARN=
|    If space monitor detects warning returun code 4,
|    HD Pointer Checker returns the return code specified by
|    this parameter.
|    The original return code is 4.
|
|    nn is 0 to 99. The default value is 4.
|
|  SPMNERROR=
|    If space monitor detects warning returun code 8,
|    HD Pointer Checker returns the return code specified by
|    this parameter.
|    The original return code is 8.
|
|    nn is 0 to 99. The default value is 8.
|
|  SPMNWARN and SPMNERROR are effective when they are specified
|  in the FABPMAIN TYPE=ALL or TYPE=SCAN JCL.
|
|  If multiple conditions for nonzero return code occurr,
|  HD Pointer checker returns the highest return code.

==============================================================
2.1.7     Output
Add the following statements to the bottom of this section.
--------------------------------------------------------------
|If input DD statements SPMNIN and SPMNSPDT are specified,
|additional output data sets are generated by Space Monitor.
|For output DD statements of Space Monitor, see
|3.2 Operating Instructions in IMS High Performance
|Pointer Checker for z/OS Version 2 User's Guide Volume 2.

==============================================================
2.1.7.1.2 Format
Add the following statements to the bottom of this section.
--------------------------------------------------------------
|If Space Monitor is called, the result of Space Monitor
|is shown by the WTO message displayed after the HD Pointer
|Checker's end message.
|
|FABP0001I******************************************************
|FABP0001I
|FABP0001I HD POINTER CHECKER ENDED NORMALLY
|FABP0001I
|FABP0001I******************************************************
|FABP0007I SPACE MONITOR ENDED NORMALLY
|
|Figure 17.1 HD Pointer Checker Job Log with Space Monitor

==============================================================
APPENDIX1.13.1.3   Messages
Add new messages FABP0007I, FABP0008W, FABP0009E, and
FABP2041E.

The return codes described below are original values, and
they are converted to the value specified in the HPSRETCD
control statement.
--------------------------------------------------------------
 | FABP0007I SPACE MONITOR ENDED NORMALLY
 |
 | Explanation:
 |   This message is generated when Space Monitor
 |   ended successfully.
 |
 | System Action:
 |   HD Pointer Checker ends the job with RC=0.
 |
 | Programmer Response:
 |   None.
 |
 | Problem Determination:
 |   None.

 | FABP0008W SPACE MONITOR ENDED WITH WARNINGS
 |
 | Explanation:
 |   Either Space Monitor encountered minor error conditions or
 |   one or more threshold warning messages
 |   were generated in the Space Monitor Exception Report.
 |
 | System Action:
 |   HD Pointer Checker ends the job with RC=4.
 |
 | Programmer Response:
 |   See the other message generated by Space Monitor
 |   to determine the nature and causes of the errors detected.
 |   If necessary, correct the problem and rerun the job.
 |
 | Problem Determination:
 |   None.

 | FABP0009E SPACE MONITOR ENDED WITH ERRORS
 |
 | Explanation:
 |   Either Space Monitor encountered major error conditions or
 |   one or more error messages were generated
 |   in the Space Analysis by the Data Set Report.
 |   This message is shown in the HPSRETCD statement report.
 |
 | System Action:
 |   HD Pointer Checker ends the job with RC=8.
 |
 | Programmer Response:
 |   See the other message generated by Space Monitor
 |   to determine the nature and causes of the errors detected.
 |   Correct the problem and rerun the job.
 |
 | Problem Determination:
 |   None.

 | FABP2041E SPECIFIED SPMNMBR DD IS INCORRECT
 |
 | Explanation:
 |   The SPMNMBR DD statement is not supported in
 |   HD Pointer Checker.
 |
 | System Action:
 |   HD Pointer Checker ends the job with RC=08.
 |
 | Programmer Response:
 |   None.
 |
 | Problem Determination:
 |   Specify a valid DD name, and rerun the utility.

==============================================================
  IMS High Performance Pointer Checker for z/OS, V2R1,
  User's Guide Vol.2 (SC18725701)
==============================================================

3.0       Space Monitor

==============================================================
3.2.1     Job Control Language
This APAR adds changes to enable dynamically allocations for
Work data sets and output data sets.
The following descriptions are changed.
--------------------------------------------------------------
|The data sets specified by DD statements in table 6.1 are
|allocated dynamically, if they are not specified
|on the JCL statement.
|
|The UNIT and SPACE parameter values are described
|in table 6.1.
|If space is not available in the specified UNIT,
|code the DD statements in the JCL.
|
|If DUMMY is specified on the DD statement, the report
|is not generated.
|Do not specify DUMMY on the DD statement, unless you want
|to suppress generation of the report.
|
| Table 6.1 DDs for which dynamic allocation is available
| +------------+----------------------------------+
| |DDNAME      | Dynamic allocation parameters    |
| +------------+----------------------------------+
| |SPMNCREC    | UNIT=SYSALLDA,SPACE=(CYL,(10,1)) |
| +------------+----------------------------------+
| |SPMNCVOL    | UNIT=SYSALLDA,SPACE=(CYL,(10,1)) |
| +------------+----------------------------------+
| |SORTIN      | UNIT=SYSALLDA,SPACE=(CYL,(10,1)) |
| +------------+----------------------------------+
| |SORTWK01-03 | UNIT=SYSALLDA,SPACE=(CYL,(10,1)) |
| |            | for each                         |
| +------------+----------------------------------+
| |SPMNPRT     | SYSOUT=*                         |
| +------------+----------------------------------+
| |SPMNANAL    | SYSOUT=*                         |
| +------------+----------------------------------+
| |SPMNSUMM    | SYSOUT=*                         |
| +------------+----------------------------------+
| |SPMNDASD    | SYSOUT=*                         |
| +------------+----------------------------------+
| |SPMNLGND    | SYSOUT=*                         |
| +------------+----------------------------------+
| |SPMNGRAF    | SYSOUT=*                         |
| +------------+----------------------------------+
| |SPMNPRTW    | SYSOUT=*                         |
| +------------+----------------------------------+
| |SPMNMSG     | SYSOUT=*                         |
| +------------+----------------------------------+
| |SYSOUT      | SYSOUT=*                         |
| +------------+----------------------------------+

=================================================
APPENDIXE. Messages and Codes
Add new message FABK3562E:
-------------------------------------------------
| FABK3562E DYNAMIC ALLOCATION(/DEALLOCATION) FAILED FOR
| ddname RC=xx CC=yyyy
|
|Explanation:
|  An attempt to dynamically allocate or deallocate the ddname
|  data set failed.
|  xx is the hexadecimal return code, and yyyy is the hexadecima
|  hexadecimal error reason code.
|System action:
|  Space Monitor ends with an abend code of 3562.
|Problem determination:
|  None.
|Programmer response:
|  For the return code and reason code of SVC 99,
|  see OS/390 MVS Programming: Authorized Assembler
|  Services Guide, or its higher version.

APAR Information

  • APAR number

    PK04599

  • Reported component name

    IMS POINTER CHE

  • Reported component ID

    5655E0900

  • Reported release

    210

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2005-04-21

  • Closed date

    2005-06-16

  • Last modified date

    2005-08-30

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

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

    UK04514

Modules/Macros

  •    FABGPMSG FABKEALC FABKGRUP FABKLIST FABKMGTB
FABKSPMN FABPHEXM FABPHPT  FABPJCTL FABPJDEF FABPLINK FABPMAIN
FABPMSGT FABPUCB0 HPC2210J

Publications Referenced
SC18725701 SC18725800

Fix information

  • Fixed component name

    IMS POINTER CHE

  • Fixed component ID

    5655E0900

Applicable component levels

  • R210 PSY UK04514

       UP05/06/17 P F506

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.

[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89G","label":"IMS HP Pointer Checker"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"210"}]

Document Information

Modified date:
02 April 2021

Page Feedback