HP OpenVMS Systems Documentation

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:

The /PAGE qualifier is not compatible with the /OUTPUT qualifier.

/REMAINING

/NOREMAINING (default)

/SINCE[=time]

For complete information on specifying time values, refer to the OpenVMS User's Manual or the online help topic DCL_Tips (subtopic Date_Time).

/STATISTICS

/NOSTATISTICS (default)

• Number of files searched
• Number of records searched
• Number of characters searched
• Number of records matched
• Number of lines printed
• Buffered I/O count
• Direct I/O count
• Number of page faults
• Elapsed CPU time
• Elapsed time

/STYLE=keyword

The valid keywords for this qualifier are CONDENSED and EXPANDED. Descriptions are as follows:

The keywords CONDENSED and EXPANDED are mutually exclusive. This qualifier specifies which file name format is displayed in the output message, along with the confirmation if requested.

File errors are displayed with the CONDENSED file specification unless the EXPANDED keyword is specified.

Refer to the OpenVMS User's Manual for more information.

/WARNINGS (default)

/NOWARNINGS

NOMATCHES
TRUNCATE
NULLFILE

/WINDOW[=(n1,n2)]

/NOWINDOW (default)

If you specify n1 and n2, the /WINDOW qualifier displays n1 lines above the search string, the search string, and n2 lines below the search string. Either of these numbers can be zero.

If you specify the /WINDOW qualifier without the values n1 and n2, two lines above the search string, the search string, and the two lines below the search string are included in the output.

If you specify the /WINDOW qualifier with a single number (n1), n1 specifies the number of lines to display including the search string. Half the lines precede the matched search string and half follow it. (If n1 is even, one line is added to the lines following the matched search string.)

For example, if you specify /WINDOW=10, nine additional lines are listed along with the line containing the search string. Four lines are listed above the line containing the search string and five lines are listed below it, for a total of 10 lines.

If you specify /WINDOW=0, the file name of each file containing a match (but no records) is included in the output. This specification creates a file (using the /OUTPUT qualifier) that can be inserted into a command file to manipulate the files containing matches.

If you omit the /WINDOW qualifier, only the line containing a match is displayed.

The /WINDOW qualifier displays a line of 30 asterisks to separate each window within a file.

/WRAP

/NOWRAP (default)

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.

Examples

$ SEARCH CABLE.MEM,JOYNER.MEM "MANUAL TITLE"
      

This command searches the files CABLE.MEM and JOYNER.MEM for occurrences of the character string MANUAL TITLE. Each line containing the string is displayed at the terminal. It is necessary to enclose the string in quotation marks because it contains a space character.

$ SEARCH/OUTPUT=RESULTS.DAT/WINDOW=9 DISLIST.MEM NAME
      

The SEARCH command searches the file DISLIST.MEM for occurrences of the character string NAME and sends the output to the file RESULTS.DAT. The four lines preceding and following each occurrence of NAME are included in the output.

$ SEARCH/OUTPUT=ALLSUB.COM/WINDOW=5000 *.COM SUBMIT
      

The SEARCH command searches all command files in the current directory for the string SUBMIT. If a match is found, SEARCH effectively copies the entire command file to the output file, because the window is so large.

$ SEARCH/OUTPUT=COLUMBUS.OH/WINDOW=(3,0)/NOHEAD/MATCH=AND -
_$ *.DAT COLUMBUS,OH
      

The SEARCH command searches all files of type DAT for lines containing both COLUMBUS and OH. When a match is found, the three previous lines (containing blank line, name, and street address) are copied to the new file. The new file COLUMBUS.OH is ready to use, because it does not contain headings and window separators.

$ SEARCH/OUTPUT=SWAP.LIS/FORMAT=PASSALL/NUMBERS/EXACT -
_$ /WINDOW=10000 SWAP.PAS SWAP
      

This SEARCH command produces a listing file with the line numbers at the left margin. The /FORMAT=PASSALL qualifier is specified so that form-feed characters in the source are passed through. The /EXACT qualifier is specified for efficiency (because it is known that the name SWAP in the program statement is always in uppercase). The /WINDOW qualifier is entered so that the entire file is copied to the output file SWAP.LIS.

$ SEARCH/REMAINING CABLE.LOG FORTRAN
      

The SEARCH command displays all the lines in the CABLE.LOG file that follow the first occurrence of the string FORTRAN.

$ SEARCH OMAHA::DISK1:[EXP]SUB.DAT,DATA.LIS VAX
      

The SEARCH command searches through the files SUB.DAT and DATA.LIS at remote node OMAHA for all occurrences of the string VAX. The list of all records containing the string VAX is displayed at the local terminal.

Defines or changes the session, batch job, or system values or characteristics. See the Description for each command for details.

Format

SET option

Description

The SET command options are described individually in this manual. Table DCLII-15 lists all the SET command options, including those generally reserved for use by system operators and managers.

Table DCLII-15 SET Command Options

Option	Function
ACCOUNTING	Controls the current accounting file.
AUDIT	Provides the management interface to the security auditing system.
BROADCAST	Determines which messages will be broadcast to SYS$OUTPUT.
CACHE/RESET	Resets systemwide I/O caching statistics for the extended file cache (XFC).
CARD_READER	Defines the default ASCII translation mode for a card reader.
CLUSTER/EXPECTED_VOTES	Sets the total expected votes in the OpenVMS Cluster to a value that you specify or, if no value is specified, sets the total votes to a value determined by the system.
COMMAND	Adds commands that are defined in a command description file to your process command set or a command tables file.
CONTROL	Enables or disables interrupts caused by Ctrl/T or Ctrl/Y.
CPU	Changes the user capabilities associated with the specified CPUs.
DAY	Overrides the default day type specified in the user authorization file (UAF).
DEFAULT	Establishes a device and directory as the current default for file specifications.
DEVICE	Defines device characteristics.
DEVICE/SERVED	Lets you make a disk on a local node available to all the nodes on an OpenVMS Cluster.
DIRECTORY	Modifies the characteristics of one or more directories.
DISPLAY	Redirects the output of a DECwindows application.
ENTRY	Changes the current status or attributes of a job not currently executing in a queue.
FILE	Modifies the characteristics of one or more files.
HOST	Connects your terminal (through the current host processor) to another processor, called the remote processor.
HOST/DTE	Connects your system to a remote system by way of an outgoing terminal line.
HOST/DUP	Connects your terminal to a storage controller through the appropriate bus for that controller.
HOST/HSC	Connects your terminal to a remote HSC50 disk and tape controller through the computer interconnect (CI) bus.
HOST/LAT	Connects your terminal to a specified service available in the local area network (LAN), establishing one session for communication between your terminal and that service.
HOST/RLOGIN	Allows you to log in to a remote host over a TCP/IP connection and start an interactive terminal session by accessing the RLOGIN application.
HOST/TELNET	Connects you to a remote host over a TCP/IP connection by invoking the TELNET application.
HOST/TN3270	Connects you to a remote IBM host over a TCP/IP connection, causing the local keyboard to emulate an IBM 3279-class terminal keyboard by invoking the TN3270 terminal emulator.
KEY	Changes the current keypad state setting.
LOGINS	Allows or disallows users to log in to the system.
MAGTAPE	Defines characteristics of a magnetic tape device.
MESSAGE	Overrides or supplements system messages.
NETWORK	Registers the attributes of a network service.
ON	Controls whether the command interpreter checks for an error condition following the execution of commands in a command procedure.
OUTPUT_RATE	Sets the rate at which output is written to a batch job log file.
PASSWORD	Lets users change their own passwords; lets system managers change the system password.
PREFIX	Allows you to set a prefix control string for verified command lines.
PRINTER	Defines printer characteristics.
PROCESS	Defines execution characteristics of the current process.
PROMPT	Defines the DCL prompt.
PROTECTION/DEFAULT	Establishes the default protection to be applied to all files subsequently created.
QUEUE	Changes the current status or attributes of the specified queue.
RESTART_VALUE	Establishes a test value for restarting portions of batch jobs.
RIGHTS_LIST	Lets users modify the process rights list; lets privileged users modify the system rights list.
RMS_DEFAULT	Provides default multiblock and multibuffer count values to be used by RMS for file operations.
SECURITY	Modifies the security profile of an object.
SERVER	Controls starting, stopping, and restarting of the security, ACME, and Registry servers.
SHADOW	Changes the characteristics of shadow sets created using Volume Shadowing for OpenVMS.
SYMBOL	Controls access to local and global symbols in command procedures.
TERMINAL	Defines terminal characteristics.
TIME	Resets the system clock to the specified value.
VERIFY	Controls whether the command interpreter displays lines in command procedures as it executes them.
VOLUME	Modifies the characteristics of one or more Files-11 volumes.
WORKING_SET	Changes the current working set limit or quota.

Controls the current accounting file.

Requires OPER (operator) privilege.

Format

SET ACCOUNTING

Parameters

None.

Description

Each node on your system has its own current accounting file. You can control what resources this file tracks, and start up a new version of this file using the SET ACCOUNTING command.

There are two occasions when the resources used by a process are not tracked, despite the SET 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 SET ACCOUNTING command:

• When you install an image using the /ACCOUNTING qualifier of the Install utility.

For more information on how to use the SET ACCOUNTING command, refer to the HP OpenVMS System Manager's Manual.

Qualifiers

/DISABLE[=(keyword[,...])]

Prevents the tracking of the resources specified by the keywords.

Table DCLII-16 lists the keywords you can use to specify the type of resource.

Table DCLII-16 SET ACCOUNTING Keywords for Resource Types

Keyword	Type of Resource
IMAGE	Resources used by an image
LOGIN_FAILURE	Resources used by an unsuccessful attempt to log in
MESSAGE	Unformatted 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

You do not need to stop the tracking of all processes and images. You can prevent resources being tracked for specific types of process and for images running in these types of process.

Table DCLII-17 lists the keywords you can use to specify the type of process.

Table DCLII-17 SET ACCOUNTING Keywords for Process Types

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, network, or interactive process)

If the system is no longer tracking any resources, /DISABLE closes the current accounting file.

If you use the /DISABLE qualifier and omit the keywords, the current accounting file does not track any resources, and the system closes the file.

/ENABLE[=(keyword[,...])]

Enables the tracking of the specified resources, and opens the current accounting file if it is not already open. The /ENABLE qualifier uses the same keywords as the /DISABLE qualifier.

Use the keywords shown in Table DCLII-16 to specify the types of resource that you want the local node to track in its current accounting file.

If the resources used by processes or images are being tracked, you can use the keywords shown in Table DCLII-17 to enable the tracking of these resources for specified types of process and for images running in those types of process.

If you use the /ENABLE qualifier and omit the keywords, the current accounting file tracks all resources.

/LOG

Writes information to the current SYS$OUTPUT device as the command executes.

/NEW_FILE

Closes the current accounting file, and starts up a new version of it.

The name of the new file depends on whether the logical name ACCOUNTNG is defined in your system logical name table.

If this logical name is not defined, the SET ACCOUNTING command opens the file SYS$MANAGER:ACCOUNTNG.DAT.

If this logical name is defined, the command opens the file that this logical name points to. If you omit the directory, SYS$MANAGER is the default, and if you omit the file type, .DAT is the default.

The /NEW_FILE qualifier writes a record to the end of the old file that contains a forward pointer to the new file, and a record to the beginning of the new file that contains a backward pointer to the old file. These records contain the names of the new and old files respectively.

Examples

$ SET ACCOUNTING /DISABLE /ENABLE=(PROCESS,BATCH,INTERACTIVE)
$ SET ACCOUNTING /ENABLE=IMAGE

      

This example tells the system to track the resources used only by batch and interactive processes, and by images running in batch and interactive processes. It illustrates the cumulative effect of /ENABLE and /DISABLE qualifiers, and of SET ACCOUNTING commands.

The /DISABLE qualifier prevents the tracking of all resources. The /ENABLE qualifier then tells the system to track the resources used by batch and interactive processes. The second SET ACCOUNTING command tells the system to track the resources used by images.

$ SET ACCOUNTING /NEW_FILE
$ RENAME SYS$MANAGER:ACCOUNTNG.DAT;-1 WEEK_24_RESOURCES.DAT

      

This example closes the current accounting file, opens a new version of it, and changes the name of the old file to WEEK_24_RESOURCES.DAT.