Document revision date: 30 March 2001

## OpenVMS DCL Dictionary

Previous | Contents | Index

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.

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

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

Previous | Next | Contents | Index

| privacy and legal statement |
9996PRO_064.HTML