 |
HP OpenVMS DCL Dictionary
HP OpenVMS DCL Dictionary
SET WORKING_SET
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
| #1 |
$ 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.
| #2 |
$ 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.
SHOW
Displays information about the current status of a process, the system,
or devices in the system.
Format
SHOW option
Description
The SHOW command options are described individually in this manual.
Table DCLII-21 lists all the SHOW command options.
Table DCLII-21 SHOW Command Options
| Option |
Displays |
|
ACCOUNTING
|
Resources the current accounting file is tracking
|
|
AUDIT
|
Security auditing characteristics in effect on the system
|
|
BROADCAST
|
Message classes for which broadcast is enabled
|
|
CLUSTER
|
OpenVMS Cluster activity and performance
|
|
CPU
|
Current state of the attached processor
|
|
DEFAULT
|
Current default device and directory
|
|
DEVICES
|
Status of devices in the system
|
|
DEVICE/SERVED
|
Status of devices served by the MSCP server on an OpenVMS Cluster system
|
|
DISPLAY
|
Node where the output from a DECwindows application running on the
current node will be displayed
|
|
ENTRY
|
Information about a user's batch and print jobs or about specific job
entries
|
|
ERROR
|
Error count for the CPU, memory, and physical devices
|
|
INTRUSION
|
Contents of the intrusion database
|
|
KEY
|
Key definitions created by the DEFINE/KEY command
|
|
LICENSE
|
Software product licenses active on the current node as well as list of
the names attached to a license (known as the RESERVE list)
|
|
LOGICAL
|
Current logical name assignments
|
|
MEMORY
|
Availability and usage of memory resources
|
|
NETWORK
|
Information about network services registered on a node
|
|
PRINTER
|
Printer characteristics
|
|
PROCESS
|
Attributes of the current process, including privileges, resource
quotas, memory usage, priority, and accounting information
|
|
PROTECTION
|
Current default protection applied to files
|
|
QUEUE
|
Names and types of queues that are available on the system as well as
any current jobs belonging to your process
|
|
QUEUE/CHARACTERISTICS
|
Characteristic names and numbers that have been defined for system
queues
|
|
QUEUE/FORM
|
Form names and numbers that have been defined for system queues
|
|
QUEUE/MANAGERS
|
Information about the queue manager(s) on the system or OpenVMS Cluster
|
|
QUOTA
|
Current disk quota authorized for and used by a specific user on a
specific disk
|
|
RMS_DEFAULT
|
Current default multiblock and multibuffer counts used by OpenVMS
Record Management Services (RMS) for file operations
|
|
SECURITY
|
Name, class, and profile of a security object
|
|
SERVER
|
Information about the servers
|
|
SHADOW
|
Status of a specified shadow set on the system.
|
|
STATUS
|
Status of the current job, including accumulated CPU time, open file
count, and count of I/O operations
|
|
SYMBOL
|
Current symbol definitions
|
|
SYSTEM
|
List of all processes in the system
|
|
TERMINAL
|
Device characteristics of a terminal
|
|
[DAY]TIME
|
Current date and time
|
|
TRANSLATION
|
Current logical name assignment
|
|
USERS
|
Information about users currently on the system
|
|
WORKING_SET
|
CURRENT working set size limit and quota
|
|
ZONE
|
Current state of a VAXft system
|
SHOW ACCOUNTING
Shows what resources the current accounting file is tracking.
Format
SHOW ACCOUNTING
Parameters
None.
Description
Each node on your system has its own current accounting file. You can
see what resources this file is tracking using the SHOW ACCOUNTING
command.
There are two occasions when the resources used by a process are not
tracked, despite the output of the SHOW ACCOUNTING command:
- When you use the RUN (Process) command with the /NOACCOUNTING
qualifier.
- When you use the $CREPRC system service with the PRC$M_NOACNT
status flag.
Similarly, there is one occasion when the resources used by an image
are always tracked, despite the output of the SHOW ACCOUNTING command:
- When you install an image using the /ACCOUNTING qualifier of the
Install utility.
The SHOW ACCOUNTING command produces a screen display (see the
Example). The keywords in the display (in uppercase) fall into two
categories:
- Keywords that show which types of resource are being tracked:
| Keyword |
Type of Resource |
|
IMAGE
|
Resources used by an image
|
|
LOGIN_FAILURE
|
Resources used by an unsuccessful attempt to log in
|
|
MESSAGE
|
(Unformatted resource record written to the accounting file by a call
to the $SNDJBC system service)
|
|
PRINT
|
Resources used by a print job
|
|
PROCESS
|
Resources used by a process
|
- Keywords that show which types of process are being tracked. When
the resources for processes or images are tracked, these keywords show
the process type:
| Keyword |
Type of Process |
|
BATCH
|
Batch process
|
|
DETACHED
|
Detached process
|
|
INTERACTIVE
|
Interactive process
|
|
NETWORK
|
Network process
|
|
SUBPROCESS
|
Subprocess (the parent process can be a batch, detached, interactive,
or network process)
|
Qualifier
/OUTPUT[=filespec]
Requires read (R) and write (W) access to the directory in
which the specified file is created.
Controls the output destination of the command. By default, the output
is the current SYS$OUTPUT device. To send the output to a file, use the
/OUTPUT qualifier followed by the file specification.
If the file specification does not include the file name or file type,
the defaults SHOW and .LIS are used respectively.
Example
|
$ SHOW ACCOUNTING
Accounting is currently enabled to log the following activities:
PROCESS any process termination
IMAGE image execution
INTERACTIVE interactive job termination
LOGIN_FAILURE login failures
NETWORK network job termination
PRINT all print jobs
|
The keywords in this example show that the local node is tracking the
resources used by each:
- Interactive and network process
- Image running in an interactive or network process
- Login failure
- Print job
SHOW AUDIT
Displays the security auditing characteristics in effect on the system.
Requires the SECURITY privilege.
Format
SHOW AUDIT
Parameters
None.
Description
The SHOW AUDIT command displays the current state of security auditing
for the system. The display can include the state of the audit journal,
the characteristics of the audit server, and the events for which
auditing is enabled. If no auditing has been enabled, the display
reports that security alarms and audits are currently disabled.
SHOW AUDIT and SET AUDIT provide the principal management interface to
the security auditing system.
Qualifiers
/ALL
Displays all available auditing information including the following:
- Location of the system security audit log file
- Security events enabled for auditing
- Location of the security archive file
- Audit server characteristics, such as the action taken if the
audit server runs out of memory.
/ALARM
Displays the categories of events that are currently enabled; these
events will generate messages on any operator's terminal accepting
security class messages.
/ARCHIVE
Displays the name and location of the security archive file (if
archiving is enabled).
/AUDIT
Displays the categories of events that are currently enabled to write
messages to the system security audit log file.
/EXACT
Use with the /PAGE=SAVE and /SEARCH qualifiers to specify a search
string that must match the search string exactly and must be enclosed
with quotation marks (" ").
If you specify the /EXACT qualifier without the /SEARCH qualifier,
exact search mode is enabled when you set the search string with the
Find (E1) key.
/HIGHLIGHT[=keyword]
Use with the /PAGE=SAVE and /SEARCH qualifiers to specify the type of
highlighting you want when a search string is found. When a string is
found, the entire line is highlighted. You can use the following
keywords: BOLD, BLINK, REVERSE, and UNDERLINE. BOLD is the default
highlighting.
/JOURNAL
Displays characteristics of the system audit journal.
/OUTPUT[=filespec]
Controls where the output of the command is sent. If you do not enter
the /OUTPUT qualifier or if you enter it without a file specification,
the output is sent to the default output stream or device for the
current process, which is identified by the logical name SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file specification
(for example, only a directory name), SET AUDIT assigns the file name
SHOW with the default file type of .LIS. The file specification cannot
include the asterisk (*) and the percent sign (%) wildcard characters.
/PAGE[=keyword]
/NOPAGE (default)
Controls the display of information on the screen.
You can use the following keywords with the /PAGE qualifier:
|
CLEAR_SCREEN
|
Clears the screen before each page is displayed.
|
|
SCROLL
|
Displays information one line at a time.
|
|
SAVE[=
n]
|
Enables screen navigation of information, where
n is the number of pages to store.
|
The /PAGE=SAVE qualifier allows you to navigate through screens of
information. The /PAGE=SAVE qualifier stores up to 5 screens of up to
255 columns of information. When you use the /PAGE=SAVE qualifier, you
can use the following keys to navigate through the information:
| Key Sequence |
Description |
|
Up arrow key, Ctrl/B
|
Scroll up one line.
|
|
Down arrow key
|
Scroll down one line.
|
|
Left arrow key
|
Scroll left one column.
|
|
Right arrow key
|
Scroll right one column.
|
|
Find (E1)
|
Specify a string to find when the information is displayed.
|
|
Insert Here (E2)
|
Scroll right one half screen.
|
|
Remove (E3)
|
Scroll left one half screen.
|
|
Select (E4)
|
Toggle 80/132 column mode.
|
|
Prev Screen (E5)
|
Get the previous page of information.
|
|
Next Screen (E6), Return, Enter, Space
|
Get the next page of information.
|
|
F10, Ctrl/Z
|
Exit. (Some utilities define these differently.)
|
|
Help (F15)
|
Display utility help text.
|
|
Do (F16)
|
Toggle the display to oldest/newest page.
|
|
Ctrl/W
|
Refresh the display.
|
The /PAGE qualifier is not compatible with the /OUTPUT qualifier.
/SEARCH="string"
Use with the /PAGE=SAVE qualifier to specify a string that you want to
find in the information being displayed. Quotation marks are required
for the /SEARCH qualifier, if you include spaces in the text string.
You can also dynamically change the search string by pressing the Find
key (E1) while the information is being displayed. Quotation marks are
not required for a dynamic search.
/SERVER
Displays audit server characteristics.
/WRAP
/NOWRAP (default)
Use with the /PAGE=SAVE qualifier to limit the number of columns to the
width of the screen and to wrap lines that extend beyond the width of
the screen to the next line.
The /NOWRAP qualifier extends lines beyond the width of the screen and
can be seen when you use the scrolling (left and right) features
provided by the /PAGE=SAVE qualifier.
Example
|
$ SHOW AUDIT/ALL
List of audit journals:
Journal name: SECURITY
Journal owner: (system audit journal)
Destination: SYS$COMMON:[SYSMGR]SECURITY.AUDIT$JOURNAL
Monitoring: enabled
Warning thresholds, Block count: 100 Duration: 2 00:00:00.0
Action thresholds, Block count: 25 Duration: 0 00:30:00.0
Security auditing server characteristics:
Database version: 4.4
Backlog (total): 100, 200, 300
Backlog (process): 5, 2
Server processing intervals:
Archive flush: 0 00:01:00:00
Journal flush: 0 00:05:00:00
Resource scan: 0 00:05:00:00
Final resource action: purge oldest audit events
Security archiving information:
Archiving events: none
Archive destination:
System security alarms currently enabled for:
ACL
Authorization
INSTALL
Time
Audit: illformed
Breakin: dialup,local,remote,network,detached
Login: batch,dialup,local,remote,network,subprocess,detached
Logfailure: batch,dialup,local,remote,network,subprocess,detached,server
System security audits currently enabled for:
ACL
Mount
Authorization
INSTALL
Time
Audit: illformed
Breakin: dialup,local,remote,network,detached
Login: batch,dialup,local,remote,network,subprocess,detached,server
Logfailure: batch,dialup,local,remote,network,subprocess,detached,server
Logout: batch,dialup,local,remote,network,subprocess,detached,server
FILE access:
Failure: read,write,execute,delete,control
|
The SHOW AUDIT command in this example displays the auditing settings
after a system installation. See the SET AUDIT/ENABLE command for
descriptions of the individual audit items.
SHOW BROADCAST
Displays the message classes that are currently affected by the SET
BROADCAST command.
Format
SHOW BROADCAST
Parameters
None.
Description
The SHOW BROADCAST command tells which classes of messages are being
screened from your terminal by the SET BROADCAST command. If some
messages are enabled by the SET BROADCAST command, but these messages
will not be displayed because your terminal is set NO BROADCAST, an
informational message is displayed.
Qualifier
/OUTPUT[=filespec]
/NOOUTPUT
Controls where the output of the command is sent. If you do not enter
the qualifier, or if you enter the /OUTPUT qualifier without a file
specification, the output is sent to the current process default output
stream or device, identified by the logical name SYS$OUTPUT.
If you enter the /OUTPUT qualifier with a partial file specification
(for example, specifying only a directory), SHOW is the default file
name and .LIS is the default file type. The asterisk (*) and the
percent sign (%) wildcard characters are not allowed.
If you enter the /NOOUTPUT qualifier, output is suppressed.
Examples
| #1 |
$ SET BROADCAST=ALL
$ SET TERMINAL/NOBROADCAST
$ SHOW BROADCAST
Broadcasts are enabled for all classes
Terminal is set "No Broadcast", no broadcast messages
will be displayed.
|
The display in this example shows that all message classes are enabled
for broadcast, but that these messages will not be received because the
terminal is set NO BROADCAST.
| #2 |
$ SHOW BROADCAST
Broadcasts are currently disabled for:
MAIL
|
The SHOW BROADCAST display in this example indicates that SET
BROADCAST=NOMAIL is in effect.
| #3 |
$ SET BROADCAST=(NOALL,USER1)
$ SET TERMINAL/NOBROADCAST
$ SHOW BROADCAST
Broadcasts are currently disabled for:
GENERAL
PHONE
MAIL
QUEUE
SHUTDOWN
URGENT
DCL
OPCOM
USER2
USER3
USER4
USER5
USER6
USER7
USER8
USER9
USER10
USER11
USER12
USER13
USER14
USER15
USER16
Terminal is set "No Broadcast", no broadcast messages
will be displayed.
|
This example shows the display you see when messages from USER1 are
enabled, but will not be received, because the terminal is set NO
BROADCAST.
| #4 |
$ SET BROADCAST=NONE
$ SHOW BROADCAST
Broadcasts are disabled for all classes
|
This example shows the display you see when SET BROADCAST=NONE is in
effect.
|
