Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-PAGING-CONFIGURATION

&pagelevel(3)&pagelevel

Show paging files

Component:

BS2000

Functional area:

System control and optimization

Domain:

SYSTEM-MANAGEMENT
SYSTEM-TUNING

Privileges:

STD-PROCESSING
TSOS
OPERATING
SW-MONITOR-ADMINISTRATION

Routing code:

R

Function

The SHOW-PAGING-CONFIGURATION command supplies information about paging files. The information is output to SYSOUT. An unused paging file cannot be displayed unless the pubset it belongs to has been imported.

The command supports structured output in S variables (see "Output in S variable").

Privileged functions

Only users with the TSOS, OPERATING or SW-MONITOR-ADMINISTRATION privilege can request to display all available information (INFORMATION =*ALL/*SUMMARY).

When command processing is complete, privileged users are sent message EMM2850, indicating how much virtual address space is available and the minimum amount required.

Format

SHOW-PAGING-CONFIGURATION                                                                                                            

VOLUME = *USED / *ALL / *NONE / *UNUSED / *PUBSET(...) / list-poss(256): <vsn 1..6>


*PUBSET(...)



|

PUBSET = list-poss(256): <cat-id 1..4>

, INFORMATION = *STD / *ALL / *SUMMARY

Operands

VOLUME = *USED / *ALL / *NONE / *UNUSED / *PUBSET(...) / list-poss(256): <vsn 1..6>
Specifies the paging files about which information is to be output.

VOLUME = *USED
Supplies information for paging files which are currently being used.

VOLUME = *ALL
Supplies information for both used and unused paging files.

VOLUME = *NONE
Supplies no information about any paging files, neither used not unused.

If INFORMATION=*SUMMARY is specified, the privileged user receives the message EMM2850 which outputs the size of the virtual address space and the minimum required virtual address space.

VOLUME = *UNUSED
Supplies information for paging files which are currently not being used.

Unused paging files cannot be displayed unless the associated pubset has been imported. When VOLUME=*ALL or *UNUSED is used to obtain information, message EMM2314 therefore informs the user that unused paging files cannot always be displayed.

VOLUME = *PUBSET(...)
Supplies information for paging files on the volumes of the specified SF pubsets.

PUBSET = list-poss(256): <cat-id 1..4>
Specifies the SF pubsets via their catalog number. A maximum of 256 catalog IDs can be specified.

VOLUME = list-poss(256): <vsn 1..6>
Identifies the disk to search for paging files by its volume serial number (VSN). Up to 256 disks can be listed.

INFORMATION = *STD / *ALL / *SUMMARY
Selects the range of information to write to SYSOUT.

INFORMATION = *STD
For paging files, the volume, pubset and size values are displayed.

INFORMATION = *ALL
This operand value is reserved for privileged users. Outputs all available information.

INFORMATION = *SUMMARY
This operand value is reserved for privileged users. Outputs a general overview of the specified objects (SUMMARY data). When VOLUME=*NONE is specified, the information output is restricted to message EMM2850 being output which contains the size of the virtual address space or the minimum required address space. 

Return codes

(SC2)

SC1

Maincode

Meaning/Guaranteed messages


0

CMD0001

Command without error


32

EMM2800

Internal error
Guaranteed messages: EMM2818, EMM2828


64

EMM2801

Pubset or volume have been specified repeatedly
Guaranteed message: EM2860


64

EMM2802

The specified pubset is unknown and cannot be identified in the given configuration 
Guaranteed message: EM2841


64

EMM2804

No used or unused paging files exist 
Guaranteed messages: EMM2863, EMM2865, EM2869


64

EMM2805

It cannot be determined whether a paging file exists on the specified volume or pubset 
Guaranteed messages: EM2824, MM2867, EM2868


128

EMM2807

Operation cannot be performed due to lack of resources
Guaranteed message: EMM2829

When lists are specified, command processing is aborted in the event of an error with a return code of EMM2800 or EMM2807. In all other cases, processing continues.

Note

If disks of type D3435 are being used for pubsets with PAMKEY usage (Format=K in the DECLARE-PUBSET statement), the actual usable disk area is 25% greater than the value specified in the SIZE operand of the CREATE-PAGING-FILE command. For an unused paging file, the size specified in the CREATE-PAGING-FILE command is displayed; for a used paging file on disks of this type, the actually used extended size is displayed. In the output the paging files used which have this extended size are marked with a “*” after the VSN. The message EMM2317 is output to provide further information.

Key to output data

The output data is in four parts:

  1. List of used paging files (VOLUME=*USED) under the following header:

    LIST OF THE USED PAGING-FILES:

  2. List of unused paging files (VOLUME=*UNUSED) under the following header:

    LIST OF THE FOUND AND UNUSED PAGING-FILES

Parts which are not requested are not displayed.

If a part for which no data is available is requested, an appropriate return code and a message are supplied in response to the request.

If disks are specified explicitly and there are no paging files or partitions on them or the paging files on them cannot be read, appropriate return code and message are supplied in response to the request. 

Example of a list of found and used paging files

/show-paging-conf inf=*all 

LIST OF THE USED PAGING-FILES :
  VOLUME  CAT-ID        SIZE       FREESIZE     UTILIZATION  REDUCTION  R
  PAG7.0   PAG7      3000.00 MB     3000.00 MB    *MEDIUM    *NOT-REQ   N
  SQGB.0 * SQGB       500.00 MB      499.99 MB    *LOW       *NOT-REQ   N
  SQGB.1 * SQGB       500.00 MB      500.00 MB    *LOW       *NOT-REQ   N
  -----------------------------------------------------------------------
  SUMMARY            4000.00 MB     3999.99 MB
%  EMM2317 THE SIZE OF VOLUME(S) - MARKED WITH * - IS INCREASED BY 25%, 
BECAUSE THE PAM-KEYS ARE USED AS PAGING-AREA
%  EMM2850 THE SIZE OF THE PAGING AREA IS: 0004000.00 MB; THE RESERVED SIZE 
OF THE PAGING AREA IS: 0000798.64 MB
Key

Field name

Meaning

VOLUME

Volume serial number (VSN) of the disk on which the paging file is located.

CAT-ID

User ID of the pubset on which the paging file is located.

SIZE

Size of the paging file in MBytes.

FREESIZE

Size of the unused area of the paging file in MB. This size provides an indication of how long it will take to reduce the paging file on the volume (the greater the unused space, the quicker the reduction).
The information is only output when the INFORMATION=*ALL operand is specified.

UTILIZATION

Provides information on the specifications defined with the UTILIZATION operand in the EXTEND-PAGING-AREA or MODIFY-PAGING-AREA-ATTRIBUTES command. UTILIZATION=*LOW is set for the paging files which were added to the paging area at system initialization.
The information is only output when the INFORMATION=*ALL operand is specified.

REDUCTION

Provides information on the specifications defined with the LATER-REDUCTION operand in the EXTEND-PAGING-AREA command. REDUCTION=*NOT-REQ is set for the paging files which were added to the paging area at system initialization.
The information is only output when the INFORMATION=*ALL operand is specified.

R

Provides information on whether the used paging file is reduced at the time of the call (Y: file is reduced; N: file is not reduced).
The information is only output when the INFORMATION=*ALL operand is specified. 

SUMMARY

The line contains the size of the paging area available and of the paging area not used.
If the command is issued with the *SUMMARY operand, only this line, complemented by a header line, is output.

Table 135: Output of found, unused paging files

With INFORMATION=*ALL, this list is followed by information about any asynchronous reduction jobs currently in progress for paging files. 

Example of a list of found and unused paging files

/show-paging-conf vol=*unused,inf=*all 

 LIST OF THE FOUND AND UNUSED PAGING-FILES :
  VOLUME  CAT-ID        SIZE                  RESTRICTION
  A1N.00   A1N        180.00 MB                  NONE
  A1N.01   A1N        180.00 MB                  NONE
  A1K.01   A1K        350.00 MB                  NONE
  A1K.03   A1K        350.00 MB                  NONE
  A2N.00   A2N        180.00 MB                  NONE
  A2N.01   A2N        180.00 MB                  NONE
  CK36.0   CK36       100.00 MB                  NONE
  -----------------------------------------------------------------------
  SUMMARY            1520.00 MB
%  EMM2314 UNUSED PAGING-FILES CANNOT BE FOUND AT ANY TIME
%  EMM2850 THE SIZE OF THE PAGING AREA IS: 0001800.00 MB; THE RESERVED SIZE 
OF THE PAGING AREA IS: 0000608.67 MB
Key

Field name

Meaning

VOLUME

Volume serial number (VSN) of the disk on which the paging file is located.

CAT-ID

User ID of the pubset on which the paging file is located.

RESTRICTION

Only with the INFORMATION=*ALL operand.
Usage restrictions of the corresponding paging file:

  • NONE: no restriction
  • UNUSEABLE:
    This paging file cannot be used in the paging area. The possible cause of this restriction is that the paging file was not created with the CREATE-PAGING-FILE command. It is basically possible to create a paging file (name: SYS.PAGING.<vsn>) with the CREATE-FILE command. However, one or more of the following causes can make this file unusable as a paging area:

    • The file is located on an impermissible medium, e.g. a shared pubset.

    • The file does not have all the attributes required for a paging file. It should therefore certainly be created using the CREATE-PAGING-FILE command.

SUMMARY

The line contains the total size of the unused paging files found. If the command is issued with the *SUMMARY operand, only this line, complemented by a header line, is output.

Table 136: Output of found, unused paging files

With INFORMATION=*ALL, this list is followed by information about any asynchronous deletion jobs currently in progress for paging files on disk. 

Output in S variable

The INFORMATION operand identifies the S variables which are to be created. The values *STD, *ALL and *SUMMARY are possible for INFORMATION.

Notation used in command

Abbreviated form used in table

INFORMATION=*STD (with the privilege STD-PROCESSING)

1

INFORMATION=*STD (privileged user)

2

INFORMATION=*ALL

3

INFORMATION=*SUMMARY

4

Output information

Name of the S variable

T

Contents                    

Condition

total number of the unused paging files found

varname(*LIST).NUM-UNUSED-VOL

I

<integer 1..4096>

1, 2, 3, 4

total number of the used paging files found

varname(*LIST).NUM-USED-VOL

I

<integer 1..4096>

1, 2, 3, 4

total size of the unused paging files in MBytes

varname(*LIST).SUM-UNUSED-SIZE

I

<integer 1..2097152>

1, 2, 3, 4

total size of the free areas of the paging files in MBytes

varname(*LIST).SUM-USED-FREE-SIZE

I

<integer 1..2097152>

3, 4

total size of the paging files in MBytes

varname(*LIST).SUM-USED-SIZE

I

<integer 1..2097152>

1, 2, 3, 4

Pubset catalog ID

varname(*LIST).UNUSED(*LIST).CAT-ID

S

<cat-id 1..4>

1, 2, 3

Usage restriction of the paging file

varname(*LIST).UNUSED(*LIST).RESTRICT

S

*NONE
*UNUSABLE

3

Size of the unused paging file in MBytes

varname(*LIST).UNUSED(*LIST).SIZE

I

<integer 1..2097152>

1, 2, 3

VSN of the volume with the paging file

varname(*LIST).UNUSED(*LIST).VOL

S

<vsn 1..6>

1, 2, 3

Pubset catalog ID

varname(*LIST).USED(*LIST).CAT-ID

S

<cat-id 1..4>

1, 2, 3

Size of the free areas of the paging file in MBytes

varname(*LIST).USED(*LIST).FREE-SIZE

I

<integer 1..2097152>

3

Indicates whether there is currently a reduction of the paging file in progress

varname(*LIST).USED(*LIST).REDUCE

S

*NO
*YES

3

Probability for the reduction of the paging file (setting LATER-REDUCTION)

varname(*LIST).USED(*LIST).REDUCT

S

*REQUESTED
*NOT-REQUESTED

3

Size of the paging file in MBytes

varname(*LIST).USED(*LIST).SIZE

I

<integer 1..2097152>

1, 2, 3

I/O load of the paging file

varname(*LIST).USED(*LIST).UTIL

S

*HIGH
*LOW
*MEDIUM

3

VSN of the volume with the paging file

varname(*LIST).USED(*LIST).VOLUME

S

<vsn 1..6>

1, 2, 3

Powered by Atlassian Confluence and Scroll Viewport.