RUNCPOOL subcommand — process a CPOOL

Use the RUNCPOOL subcommand to process a cell pool created and managed by the CPOOL macro. Cells are partitioned into the following categories:

Used cells are those that contained current data when a dump was produced.
Available cells are those that were not currently in use when a dump was produced. CPOOL services use the first four bytes in each such cell, but residual data useful for analysis may remain in the other part of such a cell.
Indeterminate cells are those that IPCS cannot place in either of the preceding categories.
The most common reason for this is that the pool was actively being changed during the dumping process, producing a "blurred picture" of this part of the dumped system. Storage overlays and storage missing from a dump may also produce indeterminate cells.

You can specify which categories of cells should be processed.

Establishing categories of cells is done before processing the cells themselves, and an optional report may be formatted that identifies data areas used to manage the cell and data extracted from those data areas.

RUNCPOOL optionally displays each cell.

You can specify additional subcommand, CLIST, or REXX exec processing with the EXEC parameter. For each cell, RUNCPOOL will display the storage, set the value of X to the address of the cell, and then process the EXEC parameter for that cell.

Related subcommands
- RUNARRAY
- RUNCHAIN

Syntax

      RUNCPOOL  cpid-general-value

            [ ASID(asid) ]
            [ DATABLKS | NODATABLKS ]
            [ USED | NOUSED ]
            [ INDETERMINATE | NOINDETERMINATE ]
            [ AVAILABLE | NOAVAILABLE ]
            [ EXEC((clist|rexx-exec|subcommand)) ]
            [ SUMMARY | NOSUMMARY ]

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.

             [ ACTIVE | MAIN | STORAGE          ]
             [ DSNAME(dsname) | DATASET(dsname) ]
             [ FILE(ddname) | DDNAME(ddname)    ]
             [ PATH(path-name)     ]
             [ DISPLAY[(display-options)]   ]
             [ NODISPLAY[(display-options)] ]       
             [ FLAG(severity) ]                
             [ PRINT | NOPRINT ]
             [ TERMINAL | NOTERMINAL ]  
             [ TEST | NOTEST ]  
             [ VERIFY | NOVERIFY ]

Parameters
cpid-general-value

Specifies a fullword cell pool identifier (CPID used in conjunction with the CPOOL macro).

ASID(asid)

Specifies the ASID of a CPOOL in private storage as a positive integer. This may be omitted if the default IPCS address processing parameters specify an ASID.

DATABLKS

NODATABLKS

Controls the formatting of a report that identifies data areas used to control the cell pool and extracts information from them regarding the status of the cell pool.

USED

NOUSED

Specifies whether cells in the pool that are in use are to be included in RUNCPOOL processing.

INDETERMINATE

NOINDETERMINATE

Specifies whether cells known to be in the pool but whose status as used or available cannot be determined are to be included in RUNCPOOL processing.

AVAILABLE

NOAVAILABLE

Specifies whether cells in the pool that are available are to be included in RUNCPOOL processing.

EXEC((clist))

EXEC((rexx-exec))

EXEC((subcommand))

Specifies that a CLIST, a REXX exec, or an IPCS subcommand is to be appended to the RUNCPOOL subcommand invocation. The appended CLIST, REXX exec, or subcommand runs for each control block in the chain. Parameters or keywords can accompany the CLIST, REXX exec, or IPCS subcommand. The symbol X will point to the current cell on the chain before each EXEC invocation.
The RUNCPOOL subcommand generates a return code that consists of its own return code plus the return code from the CLIST, REXX exec, or IPCS subcommand designated on the EXEC parameter. If the CLIST, REXX exec, or IPCS subcommand returns with a serious condition, RUNCPOOL processing ends with the current control block.

SUMMARY

NOSUMMARY

Controls the formatting of a processing summary after normal completion of RUNCPOOL processing. A processing summary is always produced if abnormal conditions force termination of RUNCPOOL.
Return codes
The RUNCPOOL subcommand generates a return code that consists of its own return code plus the return code from a CLIST, REXX exec, or IPCS subcommand if designated by the EXEC parameter. If the CLIST, REXX exec, or IPCS subcommand returns with a serious condition, RUNCPOOL processing ends with the current control block.