CREATE-PAGING-FILE

Create paging file on disk

Component:	BS2000
Functional area:	System control and optimization
Domain:	SYSTEM-MANAGEMENT SYSTEM-TUNING
Privileges:	OPERATING TSOS
Routing code:	R

Function

System support can use the CREATE-PAGING-FILE command to create a paging file on a magnetic disk or on any volume of an SF pubset. It creates a paging file of a specified size.

Format

CREATE-PAGING-FILE                                                                                                                              

VOLUME= *PUBSET(...) / list-poss(256): <vsn 1..6>
	*PUBSET(...)
		|	PUBSET = list-poss(256): <cat-id 1..4>
,SIZE = <integer 1..2097152 Mbyte>

Operands

VOLUME = *PUBSET(...)
Specifies one or more SD pubsets. A paging file of the specified size is to be created on each volume of the specified SF pubsets.

PUBSET = list-poss(256): <cat-id 1..4> 
Specifies the SF pubsets on which the paging files are to be created by their catalog ID.

VOLUME = list-poss(256): <vsn 1..6>
Identifies the magnetic disk on which the paging file of the specified size is to be created by its by volume serial number (VSN). Up to 256 disks can be listed.

SIZE = <integer 1..2097152 Mbyte > 
Specifies the size in megabytes of the paging file which is to be created on the disk.

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without error
1	0	CMD0001	Warning: A paging file of the specified size already exists on the magnetic disk. Guaranteed message: EMM2811
	32	EMM2800	The function cannot be executed because of an internal error. Guaranteed messages: EMM2818, EMM2828
	64	EMM2802	The specified pubset or the specified magnetic disk is unknown and cannot be identified in the given configuration. Guaranteed messages: EM2841, EMM2817
	64	EMM2803	Creating the paging file is not permitted for the specified pubset or the specified magnetic disk, the pubset is a shared pubset, the pubset has not been imported. Guaranteed messages: EMM2812, EM2816, EM2820
	64	EMM2805	Operation not permissible: A paging file of a different size already exists on the magnetic disk, the storage space is insufficient, the pubset has not been imported, the SM pubset has not been imported completely, the pubset has not been entered in the MRSCAT. Guaranteed messages: EMM2811, EMM2814, EMM2815, EMM2825, EMM2838, EM2824
	128	EMM2807	The function cannot be executed because of a lack of resources Guaranteed messages: EMM2819, EMM2829

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

Notes

Before issuing the command, make sure that the space required for the paging file is available on the disk. For performance reasons, a contiguous area is preferable. Otherwise, the paging file will consist of various extents.

It may be possible to make enough contiguous space by repositioning files on the disk.

The pubset the disk belongs to must have been imported. It may not be a shared pubset.

The paging file is not backed up by ARCHIVE or HSMS.

Example

Creating a 32-megabyte paging file on a disk with the volume serial number 2OSW.0:

/CREATE-PAGING-FILE VOLUME=2OSW.0,SIZE=32