lsps Command

Purpose

Displays the characteristics of a paging space.

Syntax

lsps { -s | [ -c | -l ] { -a | -t { lv | nfs | ps_helper} | PagingSpace } }

Description

The lsps command displays the characteristics of a paging space. The lsps command displays characteristics such as the paging-space name, physical-volume name, volume-group name, size, percentage of the paging space used, whether the space is active or inactive, and whether the paging space is set to automatic. The PagingSpace parameter specifies the paging space whose characteristics are to be shown.

For NFS paging spaces, the physical-volume name and volume-group name will be replaced by the host name of the NFS server and the path name of the file that is used for paging.

If the -t flag is specified, the argument will be assumed to be a third-party helper executable. If the helper executable is present in the /sbin/helpers/pagespace path then it will be spawned passing all the arguments and with the -l flag to specify the lsps command. The helper executable must take care of displaying the characteristics of the page space. If the helper program doesn’t exist in /sbin/helpers/pagespace directory, the lsps command will display the usage error. The helper executable must exit with a 0 if successful and a non-zero if it fails.

You can use the File Systems application in Web-based System Manager (wsm) to change file system characteristics. You could also use the System Management Interface Tool (SMIT) smit lsps fast path to run this command.

Flags

Item Description
-a Specifies that the characteristics of all paging spaces are to be given. The size is given in megabytes.
-c Specifies that the output should be in colon format. The colon format gives the paging space size in logical partitions.
-l Specifies that the output should be in list format.
-s Specifies that the summary characteristics of all paging spaces are to be given. This information consists of the total paging space in megabytes and the percentage of paging space currently assigned (used). If the -s flag is specified, all other flags are ignored.
Note: There is a paging space limit of 64 GB per device.
Note: Setting the environment variable PSALLOC=early causes the use of early paging space algorithm. In this case, the value the -s flag specifies is different from the value returned for a single paging space or when using the -a flag for all the paging spaces. The value the -s flag displays is the percentage of paging space allocated (reserved), whether the paging space has been assigned (used) or not. Therefore, the percentage reported by the -s flag is usually larger than that reported by the -a flag when PSALLOC is set to early.
-t Specifies the characteristics of the paging space. One of the following variables is required:
lv
Specifies that the characteristics of only logical volume paging spaces are to be given.
nfs
Specifies that the characteristics of only NFS paging spaces are to be given. The heading of the output will be changed to display the host name of the NFS server and the path name of the file that resides on the server that is being used for NFS paging.
ps_helper
Name of the helper program for a third party device.

Examples

  1. To list the characteristics of all paging spaces, enter:

    lsps  -a

    This displays the characteristics for all paging spaces and provides a listing similar to the following listing:

    Page Space   PhysicalVolume  Volume Group    Size   %Used  Active  Auto  Type  Chksum
    hd6           hdisk0          rootvg         512MB    1     yes     yes   lv     8
  2. To display the characteristics of paging space myps using the helper program foo enter the following commad:
    lsps -t foo myps

    This displays the characteristics for all paging spaces and provides a listing similar to the following listing:

    Page Space      Physical Volume   Volume Group    Size %Used Active  Auto  Type
    myps             mydisk            myvg            512MB     1    yes   yes    lv

Files

Item Description
/etc/swapspaces Specifies the paging space devices and their attributes.