Page set information (PAGEINFO) on z/OS®

Use the PAGEINFO function to extract page set information from one or more page sets, specified by DDnames in the range CSQP0000 through CSQP0099, for the source data sets from which page set information is required.

Page set management (PAGEINFO)

Keywords and parameters

There are no keywords or parameters.

Example

In Figure 1, page set information is required from two existing page sets.

Figure 1. Sample JCL showing the use of the PAGEINFO function

//PAGEINFO EXEC PGM=CSQUTIL 
//STEPLIB  DD   DISP=SHR,DSN=thlqual.SCSQANLE
//         DD   DISP=SHR,DSN=thlqual.SCSQAUTH
//CSQP0001 DD   DISP=OLD,DSN=page set.existing.name1
//CSQP0006 DD   DISP=OLD,DSN=page set.existing.name6
//SYSPRINT DD   SYSOUT=*
//SYSIN    DD    
* Extract page set information for 2 existing page sets (CSQS0001 and CSQS0006)
 PAGEINFO
/*

where:

CSQP0001, CSQP0006: Are the DDnames of the source data sets from which you want to extract page set information.

Information returned from PAGEINFO might include:

Page set number
Number of pages in a page set
Queue manager associated with a page set
Utility status information
Page set recovery RBA for each page set
System recovery RBA for all the page sets reported on by the PAGEINFO function

Usage notes

You cannot use PAGEINFO on the page sets of a queue manager that is running.
Failure of this function does not prevent other CSQUTIL functions from being attempted.
If you attempt to use the PAGEINFO function after the queue manager has terminated abnormally, the page sets might not have been closed properly. If a page set has not been closed properly, you cannot successfully run the PAGEINFO function against it. To avoid this problem, run the AMS VERIFY command before using the PAGEINFO function. The AMS VERIFY command might produce error messages. However, it does close the page sets properly so that the PAGEINFO function can complete successfully.
For more information about the AMS VERIFY command, see the z/OS DFSMS Access Method Services for VSAM manual.
The system recovery RBA relates only to those page sets processed; it does not relate to the whole queue manager unless all the page sets for the queue manager are included. If the page sets are from more than one queue manager, no system recovery RBA can be determined.