[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

HP OpenVMS DCL Dictionary


Previous Contents Index


SET ACCOUNTING

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

#1

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

#2

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


Previous Next Contents Index