REDUCE-PAGING-AREA

Reduce paging area

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

Function

This command removes one or more paging files from the paging area. A paging file can either be specified via the volume on which it is located or via the catalog ID of the pubset. The specification via pubset is only possible for SF pubsets. The specification refers to all paging files on the volumes of the respective SF pubset.

Format

REDUCE-PAGING-AREA                                                                                                                            

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

Operands

VOLUME = *PUBSET(...) / list-poss(256): <vsn 1..6>
Specifies the paging files to be removed.

VOLUME = *PUBSET(...)
Specifies one or more SF pubsets. All paging files on the volumes of the specified SF pubsets are removed.

PUBSET = list-poss(256): <cat-id 1..4>
Specifies the SF pubsets via their catalog number.

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

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command execution started without error
	32	EMM2800	The function cannot be continued owing to an internal error executing a particular object Guaranteed messages: EMM2818, EMM2828
	64	EMM2802	The specified pubset is unknown and cannot be identified in the given configuration  Guaranteed message: EM2841
	64	EMM2805	The MRSCAT entry of the pubset is missing  Guaranteed message: EMM2824
	128	EMM2807	The function cannot be continued due to lack of resources executing a particular object 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 EMM2807.

Notes

• Paging area reduction is rejected if it would cause virtual address space saturation.

• Processing of the command may take a number of minutes. For that reason, it is not executed in the calling task but is delegated to a server task created especially for the purpose. The job completion message is delivered to the calling task asynchronously. If the calling task terminates before the completion message is delivered, the message is sent to the console instead.

• If more than one volume is specified (explicitly or by specifying a pubset) when the command is issued, a separate job is started for each volume.

Examples

Reducing the paging area by the paging file on the disk with the volume serial number 2OSW.0:

/REDUCE-PAGING-AREA VOLUME=2OSW.0