OpenVMS System Management Utilities Reference Manual

/PRIORITY

Selects or rejects records for the specified priority.

Format

/PRIORITY= ([-]priority[,...])

DESCRIPTION

The /PRIORITY qualifier uses the value of the priority field to select records for processing. This field is present in all records except file backward link and file forward link records. For print and batch job records, this field contains the priority of the job in the print or batch queue. For other records, it contains the base process priority.
The /PRIORITY qualifier selects only records that have the specified values in the priority field. If you precede the values with a minus sign, it selects all records except those with the specified values.

Example

$ ACCOUNTING /PRIORITY=3

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for processes with a base priority of 3 and for print and batch jobs with a queue priority of 3.

/PROCESS

Selects or rejects records for the specified types of process.

Format

/PROCESS= ([-]process_type[,...])

KEYWORD

process_type[,...]
Specifies which types of process you want to select or reject. The following table shows the keywords available:

Keyword Type of Process

BATCH Batch process

DETACHED Detached process

INTERACTIVE Interactive process

NETWORK Network process

SUBPROCESS Subprocess of any of the other process types

Keyword	Type of Process
BATCH	Batch process
DETACHED	Detached process
INTERACTIVE	Interactive process
NETWORK	Network process
SUBPROCESS	Subprocess of any of the other process types

DESCRIPTION

The /PROCESS qualifier uses the value of the process type field to select records for processing. This field is present only in records of type IMAGE and type PROCESS. For records of type IMAGE, this field contains the type of the process in which the image was executed.
The /PROCESS qualifier selects only records that match the specified types of process. If you precede the list with a minus sign, it selects all records except those for the specified types of process.
See also the /TYPE qualifier, which selects or rejects specified types of record.

Example

$ ACCOUNTING /TYPE=IMAGE /PROCESS=INTERACTIVE /FULL

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a full report of the resources used by images running in interactive processes.

/QUEUE

Selects or rejects records for print or batch jobs executed by the specified queues.

Format

/QUEUE= ([-]queue_name[,...])

DESCRIPTION

The /QUEUE qualifier uses the value of the queue name field to select records for processing. This field is present in all records except file backward link and file forward link records. For records that contain information about print or batch jobs, it contains the name of the queue that executed the job.
The /QUEUE qualifier selects only records that have the specified values in the queue name field. If you precede the values with a minus sign, it selects all records except those with the specified values.
See also the /JOB and /ENTRY qualifiers.

Example

$ ACCOUNTING /QUEUE=SYS$MYNODE_BATCH

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for jobs executed by the SYS$MYNODE_BATCH queue.

/REJECTED

Copies the rejected records to a new file.
Requires read and write access to the directory in which the specified file is created.

Format

/REJECTED =filespec

DESCRIPTION

The /REJECTED qualifier creates the specified file, then copies the records that do not match your selection criteria to this file in binary format. Use the Accounting utility to process this file later.
If the file specification does not include the device or directory name, your current default device or directory is used. If you omit the file name, the file name of the first input file is used (the first file listed in the parameter to the ACCOUNTING command). If you omit the file type, .REJ is used.

Example

$ ACCOUNTING /TYPE=PRINT /BINARY /OUTPUT=PRINT_INFO.DAT - 
_$ /REJECTED=NOT_PRINT_INFO.DAT

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It creates two files, PRINT_INFO.DAT and NOT_PRINT_INFO.DAT, in the default directory. It copies print job records to PRINT_INFO.DAT and all other records to NOT_PRINT_INFO.DAT.

/REMOTE_ID

Selects or rejects records for DECnet for OpenVMS requests made by the specified remote IDs.

Format

/REMOTE_ID= ([-]remote_id[,...])

DESCRIPTION

The /REMOTE_ID qualifier uses the value of the remote ID field to select records for processing. This field is present in all records except file backward link and file forward link records. For records that contain information about DECnet for OpenVMS requests, this field contains a string that identifies the user who made the request. If the remote process was on an OpenVMS node, this is the user name of the user at the remote node.
The /REMOTE_ID qualifier selects only records that have the specified values in the remote ID field. If you precede the values with a minus sign, it selects all records except those with the specified values.
See also the /NODE and /ADDRESS qualifiers, which select or reject records for DECnet for OpenVMS requests made by nodes with specified names and addresses respectively.

Example

$ ACCOUNTING /NODE=HQ223 /REMOTE_ID=SMITH /FULL

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a full report of all the records for DECnet for OpenVMS requests made by user SMITH at the node HQ223.

/REPORT

Specifies the resources that you want to summarize in a summary report.

Format

/REPORT [=(resource[,...])]

KEYWORD

resource[,...]
Specifies the resources that you want to summarize in the report. Table 2-4 shows the keywords available.

Table 2-4 Resources You Can Summarize in a Summary Report
Keyword Description How Summarized

BUFFERED_IO² Number of buffered I/Os Total

DIRECT_IO² Number of direct I/Os Total

ELAPSED¹, ² Elapsed time Total

EXECUTION² Number of images run by the process Total

FAULTS² Number of hard and soft page faults Total

GETS¹ Number of GETs from the file that was printed Total

PAGE_FILE² Page file usage Maximum

PAGE_READS² Number of hard page faults Total

PAGES¹ Number of pages printed Total

PROCESSOR² Total CPU time used Total

QIOS¹ Number of QIOs to the printer Total

RECORDS Number of accounting file records processed Total

VECTOR_PROCESSOR² Vector CPU time used (see the description of the /FULL qualifier for further details) Total

VOLUMES² Number of volumes mounted Total

WORKING_SET² Working set size Maximum

¹Present in records of type PRINT
²Present in records of type IMAGE, LOGFAIL, PROCESS, and SYSINIT

The RECORDS keyword is the default if you omit either the keywords or the /REPORT qualifier. It gives the total number of records for each summary key value.

**Table 2-4 Resources You Can Summarize in a Summary Report**
Keyword	Description	How Summarized
BUFFERED_IO²	Number of buffered I/Os	Total
DIRECT_IO²	Number of direct I/Os	Total
ELAPSED¹, ²	Elapsed time	Total
EXECUTION²	Number of images run by the process	Total
FAULTS²	Number of hard and soft page faults	Total
GETS¹	Number of GETs from the file that was printed	Total
PAGE_FILE²	Page file usage	Maximum
PAGE_READS²	Number of hard page faults	Total
PAGES¹	Number of pages printed	Total
PROCESSOR²	Total CPU time used	Total
QIOS¹	Number of QIOs to the printer	Total
RECORDS	Number of accounting file records processed	Total
VECTOR_PROCESSOR²	Vector CPU time used (see the description of the /FULL qualifier for further details)	Total
VOLUMES²	Number of volumes mounted	Total
WORKING_SET²	Working set size	Maximum

DESCRIPTION

The /REPORT qualifier specifies the resources that you want to summarize in a summary report. The resources are summarized, either as totals or maximum values, for each summary key value specified by the /SUMMARY qualifier.
When a record is processed that does not contain the specified resource field, a default value of 0 is used. For example, if you use the PAGES keyword to summarize the total pages printed, the value of 0 is used for each record that is not of type PRINT.
Note that the resource usage data stored in records of type IMAGE is a subset of the data stored in records of type PROCESS. For example, the CPU time stored in a record of type PROCESS includes the CPU time used by the images executed by that process. To make sure that you do not count the same resource data twice when you are summarizing process resources by totals, use the /TYPE qualifier to exclude records of type IMAGE.
You cannot use the /REPORT qualifier without the /SUMMARY qualifier.

Examples

```
$ ACCOUNTING /SUMMARY=IMAGE /REPORT=(RECORDS,PROCESSOR) 
```
This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a summary report that shows for each image the number of times it was executed and the total CPU time consumed.
```
$ ACCOUNTING /TYPE=-IMAGE /SUMMARY=USER /REPORT=EXECUTION 
```
This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a summary report that shows the total number of images executed by each user. Notice the use of the /TYPE qualifier to exclude records of type IMAGE to avoid double counting.

/SINCE

Selects all records time-stamped at or after the specified time.

Format

/SINCE [=time]

DESCRIPTION

All records in an accounting file are time-stamped with the time the record was logged in the file.
The /SINCE qualifier selects only the records time-stamped on or after the specified time. You can specify an absolute time, delta time, or a combination of the two. If you omit the time, 00:00 hours on the current day is used.
See also the /BEFORE qualifier, which selects records time-stamped before a specified time.

Example

$ ACCOUNTING /SINCE=5-JAN-1996

This example produces a brief report of all records time-stamped at or after 5-JAN-1996 in the file SYS$MANAGER:ACCOUNTNG.DAT.

/SORT

Sorts the selected records.

Format

/SORT [=([-]sort_field[,...])]

KEYWORD

sort_field[,...]
Specifies the sort key.
The following table shows the keywords available. You can specify up to ten sort fields.

Keyword Sorts on This Field

ACCOUNT Account

ADDRESS Address of the node that made the DECnet for OpenVMS request

BUFFERED_IO Number of buffered I/Os

DIRECT_IO Number of direct I/Os

ELAPSED Elapsed time

ENTRY Print or batch job queue entry number

EXECUTION Number of images run by the process

FAULTS Number of hard and soft page faults

FINISHED Time record was logged in the accounting file

GETS Number of GETs from the file that was printed

IDENT Process identifier (PID)

IMAGE Image name (sorts only on file name portion of the image file specification)

JOB Name of print or batch job

NODE Name of the node that made the DECnet for OpenVMS request

OWNER PID of parent process

PAGE_FILE Peak page file usage

PAGE_READS Number of hard page faults

PAGES Number of pages printed

PRIORITY Base process priority, or print or batch queue priority

PROCESS Type of process

PROCESSOR Total CPU time used

QIOS Number of QIOs to the printer

QUEUE Name of print or batch queue

QUEUED Time print job was queued

STARTED Start time

STATUS Final exit status code

TERMINAL Terminal name

TYPE Type of record

UIC User identification code

USER User name at local node

VECTOR_PROCESSOR Vector CPU time (see the description of the /FULL qualifier for further details)

VOLUMES Number of volumes mounted

WORKING_SET Peak working set size

For each keyword, see the description of the corresponding Accounting utility qualifier or Table 2-5 for details of the types of record in which the corresponding field is present.

Keyword	Sorts on This Field
ACCOUNT	Account
ADDRESS	Address of the node that made the DECnet for OpenVMS request
BUFFERED_IO	Number of buffered I/Os
DIRECT_IO	Number of direct I/Os
ELAPSED	Elapsed time
ENTRY	Print or batch job queue entry number
EXECUTION	Number of images run by the process
FAULTS	Number of hard and soft page faults
FINISHED	Time record was logged in the accounting file
GETS	Number of GETs from the file that was printed
IDENT	Process identifier (PID)
IMAGE	Image name (sorts only on file name portion of the image file specification)
JOB	Name of print or batch job
NODE	Name of the node that made the DECnet for OpenVMS request
OWNER	PID of parent process
PAGE_FILE	Peak page file usage
PAGE_READS	Number of hard page faults
PAGES	Number of pages printed
PRIORITY	Base process priority, or print or batch queue priority
PROCESS	Type of process
PROCESSOR	Total CPU time used
QIOS	Number of QIOs to the printer
QUEUE	Name of print or batch queue
QUEUED	Time print job was queued
STARTED	Start time
STATUS	Final exit status code
TERMINAL	Terminal name
TYPE	Type of record
UIC	User identification code
USER	User name at local node
VECTOR_PROCESSOR	Vector CPU time (see the description of the /FULL qualifier for further details)
VOLUMES	Number of volumes mounted
WORKING_SET	Peak working set size

DESCRIPTION

The /SORT qualifier merges the selected records from each input file (each file listed in the parameter to the ACCOUNTING command) and sorts them using the specified sort key. The records are sorted according to the value of the first sort field in the list, and when two or more records have the same value in this field, they are sorted by the value of the second sort field in the list, and so on.
The records are sorted in ascending order of the sort field value. If the keyword is preceded by a minus sign, the records are sorted in descending order.
When you use the /SORT qualifier, records are rejected if they do not contain the sort field. For example, /SORT=IMAGE rejects all records that are not of type IMAGE, because the image name field is only present in records of type IMAGE. Similarly, /SORT=PAGES rejects all records except those for print jobs.
You cannot use the /SORT qualifier with the /SUMMARY qualifier.

Examples

$ ACCOUNTING /TYPE=PRINT /SORT=USER

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all the records for print jobs and displays them in user name order.
The following is an example of the report that is produced:

 
Date / Time           Type  Subtype Username     ID      Source  Status 
------------------------------------------------------------------------- 
14-JAN-1996 09:53:05  PRINT         BROWN        20A00193        00040001 
13-JAN-1996 13:36:04  PRINT         BROWN        20A00442        00000001 
13-JAN-1996 12:42:37  PRINT         BROWN        20A00442        00000001 
13-JAN-1996 14:43:56  PRINT         DECNET_MAIL  20A00456        00000001 
14-JAN-1996 19:39:01  PRINT         DECNET_MAIL  20A00265        00000001 
14-JAN-1996 20:09:03  PRINT         DECNET_MAIL  20A00127        00000001 
14-JAN-1996 20:34:45  PRINT         DECNET_MAIL  20A00127        00000001 
14-JAN-1996 11:23:34  PRINT         FISH         20A0032E        00040001 
14-JAN-1996 16:43:16  PRINT         JONES        20A00070        00040001 
14-JAN-1996 09:30:21  PRINT         SMITH        20A00530        00040001

```
$ ACCOUNTING MYFILE1.DAT,MYFILE2.DAT /SORT=IMAGE - 
_$ /FULL /REJECTED=NON_IMAGE.DAT 
```
This example processes two files, MYFILE1.DAT and MYFILE2.DAT, to produce a full report of records of type IMAGE, sorted in image name order. It creates the file NON_IMAGE.DAT, and copies all records except those of type IMAGE to that file. Notice that no selection qualifiers are used, and so all records are selected for processing. When the records are sorted, records that do not contain an image name are rejected.

/STATUS

Selects or rejects records with the specified final exit status codes.

Format

/STATUS= ([-]status_code[,...])

DESCRIPTION

The /STATUS qualifier uses the value of the final status code field to select records for processing. This field is present in all records except records of type USER, file backward link records, and file forward link records.
The /STATUS qualifier selects only records that have the specified values in the final status code field. If you precede the values with a minus sign, it selects all records except those with the specified values.
See the description of the /BRIEF qualifier for details of how to convert a final exit status code to the equivalent message text.

Example

$ ACCOUNTING /STATUS=10D38064

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records with a final exit status code of 10D38064.

/SUMMARY

Produces a summary report of the selected records.

Format

/SUMMARY [=(summary_item[,...])]

KEYWORD

summary_item[,...]
Specifies the summary key. The following table lists keywords:

Keyword Description

ACCOUNT Account

DATE Date

DAY Day of month (1--31)

HOUR Hour of day (0--23)

IMAGE Image name (file name portion of image file specification)

JOB Name of print or batch job

MONTH Month of year (1--12)

NODE Name of the node that issued the DECnet for OpenVMS request

PROCESS Process type

QUEUE Print or batch job queue name

TERMINAL Terminal name

TYPE Record type

UIC User identification code

USER User name

WEEKDAY Day of week (0=Sunday, 1=Monday, and so on)

YEAR Year

If you omit these keywords, the user name is used as the summary key.

Keyword	Description
ACCOUNT	Account
DATE	Date
DAY	Day of month (1--31)
HOUR	Hour of day (0--23)
IMAGE	Image name (file name portion of image file specification)
JOB	Name of print or batch job
MONTH	Month of year (1--12)
NODE	Name of the node that issued the DECnet for OpenVMS request
PROCESS	Process type
QUEUE	Print or batch job queue name
TERMINAL	Terminal name
TYPE	Record type
UIC	User identification code
USER	User name
WEEKDAY	Day of week (0=Sunday, 1=Monday, and so on)
YEAR	Year

DESCRIPTION

The /SUMMARY qualifier produces a summary report of the selected records. The report is directed to the current SYS$OUTPUT device, unless you use the /OUTPUT qualifier to write it to a file.
Summary reports give statistical summaries of the resources specified by the /REPORT qualifier for each value of the summary key specified by the /SUMMARY qualifier. If you omit the /REPORT qualifier, the summary report gives the total number of records processed for each summary key value.
The first line of the summary report shows the time span of the data processed (when the first and last records processed were logged in the input files), with a title in the middle. You can use the /TITLE qualifier to specify your own title.
The next few lines of the report are column headings. There is one column for each summary_item, then one column for each resource specified by the /REPORT qualifier. The columns are laid out in the same left-to-right sequence as the equivalent keywords in the /SUMMARY and /REPORT qualifiers.
The rest of the report uses one line for each summary key value. It gives a summary of the resources associated with that summary key value. The data is sorted in ascending order of the summary key value.
See also the /BINARY qualifier, which copies the selected records to a file, and the /BRIEF and /FULL qualifiers, which produce brief and full reports of the selected records.
You cannot use the /SUMMARY qualifier with the /BINARY, /BRIEF, or /FULL qualifiers.

Examples

$ ACCOUNTING /TYPE=PRINT /SUMMARY=USER /REPORT=(PAGES,RECORDS)

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It processes all the print job records and produces a summary report that shows, for each user, the total number of pages printed and the number of records that were added together to produce this total. This is an example of the report that is produced:

 
From: 12-JAN-1996 15:55  VAX/VMS Accounting Report  To: 15-JAN-1996 15:17 
 
Username         Pages    Total 
               Printed  Records 
------------------------------- 
BROWN              115        2 
CROW                 3        1 
CUTHBERT            20        4 
FOSTER              46        1 
SMITH               50        3 
WHITE               50        7

$ ACCOUNTING /SUMMARY=IMAGE /REPORT=(PROCESSOR,RECORDS)

This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a summary report that shows the total CPU time used by each image. This is an example of the report that is produced:

 
From: 12-JAN-1996 15:55  VAX/VMS Accounting Report  To: 15-JAN-1996 15:17 
Image name     Processor        Total 
                  Time        Records 
------------------------------------- 
               0 00:09:09.83       51 
ACC            0 00:01:36.72       99 
AUTHORIZE      0 00:00:04.17        8 
CDU            0 00:00:33.25       21 
COPY           0 00:00:05.97       30 
DELETE         0 00:00:02.79       12 
DIRECTORY      0 00:00:09.67       38 
DUMP           0 00:00:04.51        3 
EDT            0 00:00:05.85        7 
LOGINOUT       0 00:04:03.48       75 
NETSERVER      0 00:00:00.63       23 
SHOW           0 00:00:04.80       22

  6048P003.HTM
  OSSG Documentation
  26-NOV-1996 12:42:20.52

Legal