Kernel-Managed Swap Facility (KMSF) Manual

NSKCOM Command Reference

Kernel-Managed Swap Facility (KMSF) Manual—425824-005

4-2

ADD Command

The ADD command creates a swap file to be used by a specific processor and adds an

entry for the swap file to the configuration file, ZSYSCFG. You can specify attribute

values for the swap file when you enter the ADD command. If you do not specify

attributes, the swap file is created using the active default values.

After entering the ADD command, enter the START command to enable use of the

swap file. To modify a swap file once it has been added, use the ALTER command.

This command can be issued only by super-group users (255, n).

filename

is the name of the swap file to be added. The variable filename is specified as:

$volume.subvolume.filename.

CPU cpu-num

identifies number of the processor that will swap to the swap file.

attribute value

optionally sets the value of an attribute of the swap file. The attribute can be EXT,

MAXEXTENTS, SIZE, THRESHOLD, or FORMAT. For the set of attributes EXT,

MAXETENTS, and SIZE, it is not necessary to specify values for all three

attributes. If two of these attributes are specified or assumed (see the ASSUME

Command on page 4-8), the third value is calculated.

The values are specified as follows:

EXT[ENT[s]] disk-pages-per-extent

specifies the number of disk pages per extent.

This value must be a multiple of the processor memory page size

(16 kilobytes). If you specify less than what is required, the value is rounded up

to the required value.

The default disk pages per extent is 512 (1 megabyte) for G-series RVUs and

1024 (2 megabytes) for H-series RVUs. The minimum is 8 pages, but using the

minimum value is not recommended.

For Format 1 files, you can specify a value up to 65504. However, because of

32-bit addressing, Format 1 files are limited to a maximum size of

2047 megabytes, where:

2047 megabytes = EXTENTS * MAXEXTENTS * 2048 bytes.

The maximum value for Format 2 files is 65536.

ADD SWAPF[ILE] filename CPU cpu-num [ , attribute value ]...