HP OpenVMS Systems Documentation

HP OpenVMS DCL Dictionary

Redefines the default working set size for the process, or sets an upper limit to which the working set size can be changed by an image that the process executes. Working set limits cannot be set to exceed those defined in the user authorization file (UAF).

Specify the value of n as a number of 512-byte pagelets on Alpha or 512-byte pages on VAX. Note that the OpenVMS system rounds up this value to the nearest CPU-specific page so that the actual amount of physical memory allowed may be larger than the specified amount on Alpha.

Format

SET WORKING_SET

Parameters

None.

Description

The SET WORKING_SET command enables the user to change the working set size within the authorized limits. A process's working set is the collection of physical pages to which an executing image can refer. Each user is assigned a default working set size to be associated with the process created during login. The maximum size to which any process can increase its working set is defined in the user authorization file (UAF).

Qualifiers

/ADJUST (default)

/NOADJUST

Controls whether the system can automatically adjust the size of the process working set.

/EXTENT=n

Specifies the maximum number of physical pages that can be resident in the working set during image execution.

The extent value must be greater than the minimum working set defined at system generation, and it must be less than or equal to the authorized extent defined in the UAF.

If you specify a value greater than the authorized extent, the command sets the working set limit at the maximum authorized value.

/LIMIT=n

Specifies the size to which the working set is to be reduced at image exit.

If you specify a value greater than the current quota, the quota value is also increased.

/LOG

/NOLOG (default)

Determines whether confirmation of the SET WORKING_SET command is displayed.

/QUOTA=n

Specifies the maximum number of physical pages that any image executing in the process context can request. An image can set the working set size for the process by calling the $ADJWSL (Adjust Working Set Limit) system service.

If you specify a quota value that is greater than the authorized quota, the working set quota is set to the authorized quota value.

Examples

$ SHOW WORKING_SET
 Working Set      /Limit=  150  /Quota=  700            /Extent= 700
 Adjustment enabled    Authorized Quota=  700  Authorized Extent= 700
$ SET WORKING_SET/QUOTA=1000
%SET-I-NEWLIMS, new working set: Limit = 150 Quota = 700 Extent = 700

      

The SHOW WORKING_SET command in this example displays the current limit, quota, and extent, as well as the authorized quota and authorized extent. The SET WORKING_SET command attempts to set a quota limiting the maximum number of pages any image can request that is greater than the authorized quota. Note from the response that the quota was not increased.

$ SHOW WORKING_SET
 Working Set      /Limit=  150  /Quota=  350            /Extent= 350
 Adjustment enabled    Authorized Quota=  350  Authorized Extent= 350
$ SET WORKING_SET/LIMIT=100
%SET-I-NEWLIMS, new working set: Limit = 100 Quota = 350 Extent = 350
$ SHOW WORKING_SET
 Working Set      /Limit=  100  /Quota=  350            /Extent= 350
 Adjustment enabled    Authorized Quota=  350  Authorized Extent= 350

      

The SET WORKING_SET command in this example sets the working set size for any image in the process to 100.