HP OpenVMS Systems Documentation

The SET VOLUME command in this example specifies that 25 directories are to be maintained in system space for ready access for the volume DKA0. The command also assigns the user name MANAGER to the volume and displays the volume specification after the volume is modified.

$ SET VOLUME/REBUILD/LOG NODE$DKA2:
%SET-I-MODIFIED, _NODE$DKA2: modified
      

The SET VOLUME command in this example causes a rebuild operation to begin on the volume that is mounted on NODE$DKA2. The /LOG qualifier directs the SET VOLUME command to display a notification message.

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.

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
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

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

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.

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

$ 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.

$ SHOW BROADCAST
Broadcasts are currently disabled for:
    MAIL
      

The SHOW BROADCAST display in this example indicates that SET BROADCAST=NOMAIL is in effect.

$ 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.

$ 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.