| Previous | Contents | Index |
The Accounting utility (ACCOUNTING) produces reports of system resource use.
You can use ACCOUNTING qualifiers to:
You can use the reports to learn more about how the system is used and
how it performs.
2.2 ACCOUNTING Usage Summary
Produces reports of resource use.
ACCOUNTING [filespec[,...]]
filespec[,...]
Specifies the accounting files you want to process.Each file specification can include the percent (%) and asterisk (*) wildcard characters. If it does not include the device or directory, your current default device or directory is used. If it does not include the file name or file type, the values ACCOUNTNG and DAT are used respectively.
If you do not specify a file, the command processes the file SYS$MANAGER:ACCOUNTNG.DAT.
Use this DCL command to run the Accounting utility:
$ ACCOUNTING [filespec[,...]]
You are returned to DCL level when the command has finished processing the specified accounting files.
By default, the command directs its output to the current SYS$OUTPUT device. If you want to direct the output to a file, use the /OUTPUT qualifier.
Requires READ access to the accounting files you specify, and to the directories containing them.
This section describes and provides examples of each ACCOUNTING qualifier. The following table summarizes the ACCOUNTING qualifiers:
| Qualifier | Description |
|---|---|
| /ACCOUNT | Selects or rejects records for the specified account names |
| /ADDRESS | Selects or rejects records for DECnet for OpenVMS requests made by the specified nodes |
| /BEFORE | Selects all records time-stamped before the specified time |
| /BINARY | Copies the selected records to a new file in binary format |
| /BRIEF | Produces a brief report of the selected records |
| /ENTRY | Selects or rejects records for print and batch jobs with the specified queue entry numbers |
| /FULL | Produces a full report of the selected records |
| /IDENT | Selects or rejects records for the specified processes |
| /IMAGE | Selects or rejects records for the specified images |
| /JOB | Selects or rejects records for print and batch jobs with the specified job names |
| /LOG | Outputs informational messages |
| /NODE | Selects or rejects records for DECnet for OpenVMS requests made by the specified nodes |
| /OUTPUT | Specifies the output file (Alpha and Integrity servers) |
| /OWNER | Selects or rejects records for subprocesses created by the specified processes |
| /PRIORITY | Selects or rejects records for the specified priority |
| /PROCESS | Selects or rejects records for the specified types of process |
| /QUEUE | Selects or rejects records for print or batch jobs executed by the specified queues |
| /REJECTED | Copies the rejected records to a new file |
| /REMOTE_ID | Selects or rejects records for DECnet for OpenVMS requests made by the specified remote IDs |
| /REPORT | Specifies the resources that you want to summarize in a summary report |
| /SINCE | Selects all records time-stamped at or after the specified time |
| /SORT | Sorts the selected records |
| /STATUS | Selects or rejects records with the specified final exit status codes |
| /SUMMARY | Produces a summary report of the selected records |
| /TERMINAL | Selects or rejects records for interactive sessions at the specified terminals |
| /TITLE | Specifies the title shown on the first line of a summary report |
| /TYPE | Selects or rejects the specified types of record |
| /UIC | Selects or rejects records for the specified UICs |
| /USER | Selects or rejects records for the specified user names |
| /WIDE | Changes the width of Buffered I/O and Direct I/O fields in a report from 8 to 10 characters |
Selects or rejects records for the specified account names.
/ACCOUNT= ([-]account[,...])
The /ACCOUNT qualifier uses the value of the account field to select records for processing. This field is present in all records except file backward link and file forward link records.The /ACCOUNT qualifier selects only records that have the specified values in the account field. If you precede the values with a minus sign, it selects all records except those with the specified values.
The following table shows the values stored in the account field of login failure and system initialization records:
Value Description <batch> Batch job login failure <det> Detached process login failure <login> Interactive login failure <net> Network login failure <start> System startup Note that when you specify these account field values as qualifier values, you must enclose them in quotes. Like all DCL commands, the ACCOUNTING command converts strings to uppercase unless they are enclosed in quotes.
| #1 |
|---|
$ ACCOUNTING /ACCOUNT=(SALES, QA)
|
This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for the account names SALES and QA.
| #2 |
|---|
$ ACCOUNTING /ACCOUNT=(-SALES, QA) /FULL
|
This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a full report of all records except for the account names SALES and QA.
Selects or rejects records for DECnet for OpenVMS requests made by the specified nodes.
/ADDRESS= ([-]node_address[,...])
The /ADDRESS qualifier uses the value of the remote node address 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, it contains the address of the node that made the request.The /ADDRESS qualifier selects only records with the specified values in the remote node address 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 /REMOTE_ID qualifiers, which select or reject records for DECnet for OpenVMS requests made by specified node names and remote IDs respectively.
$ ACCOUNTING /ADDRESS=19656
|
This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for DECnet for OpenVMS requests made by the node with the address 19656. (The decimal equivalent of this address is 19.200.)
Selects all records time-stamped before the specified time.
/BEFORE [=time]
All records in an accounting file are time-stamped with the time the record was logged in the file.The /BEFORE qualifier selects only the records time-stamped before the specified time. You can specify an absolute time, a 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 /SINCE qualifier, which selects records time-stamped at or after a specified time.
$ ACCOUNTING /SINCE=1-NOV-2002 /BEFORE=1-DEC-2002
|
This example produces a brief report of all records time-stamped in the file SYS$MANAGER:ACCOUNTNG.DAT during November 2002.
Copies the selected records to a new file in binary format.
/BINARY
The /BINARY qualifier specifies that records are output in binary format to the file specified by the /OUTPUT qualifier. (/OUTPUT is Alpha- and Integrity servers-only, however.) Use the Accounting utility to process this file later.See also the /BRIEF, /FULL, and /SUMMARY qualifiers, which process the selected records to produce a report.
You cannot use the /BINARY qualifier with the /BRIEF, /FULL, or /SUMMARY qualifiers.
| #1 |
|---|
$ ACCOUNTING /USER=SMITH /BINARY /OUTPUT=MYDISK:[ACCOUNTING]MYACC.DAT
|
This example creates the file MYDISK:[ACCOUNTING]MYACC.DAT. It processes the file SYS$MANAGER:ACCOUNTNG.DAT, copying all records for the user SMITH to the new file in binary format.
| #2 |
|---|
$ ACCOUNTING /TYPE=PRINT -
_$ /BINARY /OUTPUT=PRINT_INFO.DAT /REJECTED=NOT_PRINT_INFO.DAT
|
This example creates two files in the default directory, PRINT_INFO.DAT and NOT_PRINT_INFO.DAT. It processes the file SYS$MANAGER:ACCOUNTNG.DAT, copying print records to PRINT_INFO.DAT and other records to NOT_PRINT_INFO.DAT. These records are in binary format.
Produces a brief report of the selected records.
/BRIEF (default)
The /BRIEF qualifier is the default. It produces a brief 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. (Note that /OUTPUT is Alpha- and Integrity servers-only.)Each line of a brief report corresponds to a record in the accounting file. It does not show resources used, but gives the information shown in the following table about each record in the accounting file:
Column Description Date/Time When the record was logged in the accounting file. Type The type of the record. Subtype For records of type IMAGE, this is the name of the image (the file name portion of its file specification). For records of type PROCESS, it is the type of the process (BATCH, DETACHED, INTERACTIVE, NETWORK, or SUBPROCESS). User name The user name. For login failures where the user did not give a valid user name, this is shown as <login>. ID The process identifier (PID). For print jobs, this is the PID of the process that submitted the job. Source The terminal associated with an interactive process or, for DECnet for OpenVMS requests, the name of the node that issued the request. Status The final exit status code, expressed as a hexadecimal value. To translate the final exit status code into the equivalent message text, use the F$MESSAGE lexical function, and precede the status code with %X, as in this example:
$ MESSAGE = F$MESSAGE(%X00000001) $ SHOW SYMBOL MESSAGE MESSAGE = "%SYSTEM-S-NORMAL, normal successful completion"See also the /BINARY qualifier, which copies the selected records to a file, and the /FULL and /SUMMARY qualifiers, which produce full and summary reports of the selected records.
You cannot use the /BRIEF qualifier with the /BINARY, /FULL, or /SUMMARY qualifiers.
$ ACCOUNTING
|
This example produces a brief report of all records in the file SYS$MANAGER:ACCOUNTNG.DAT.
This is an example of the report that is produced:
Date / Time Type Subtype Username ID Source Status -------------------------------------------------------------------------- 7-JAN-2002 17:20:08 FILE_BL 00000000 00000000 7-JAN-2002 17:22:05 PROCESS DETACHED JONES 516000E1 02DBA002 7-JAN-2002 17:22:10 PROCESS INTERACTIVE JONES 516000DD TWA10: 00000001 7-JAN-2002 17:22:16 PROCESS INTERACTIVE JONES 51600104 TWA11: 0001C0F4 7-JAN-2002 17:22:20 PROCESS DETACHED JONES 51600103 12DB821C 8-JAN-2002 01:06:36 PROCESS SUBPROCESS SYSTEM 51600106 10000001 8-JAN-2002 03:09:59 PROCESS BATCH SYSTEM 5160010F 10030001 8-JAN-2002 09:13:15 LOGFAIL 51600105 00D3803C 8-JAN-2002 09:14:40 IMAGE LOGINOUT JONES 51600110 00000000 8-JAN-2002 09:28:57 PROCESS SUBPROCESS SMITH 51600119 10000001 8-JAN-2002 09:50:18 PROCESS SUBPROCESS SMITH 5160011A 00000001 |
Selects or rejects records for print and batch jobs with the specified queue entry numbers.
/ENTRY= ([-]entry_number[,...])
The /ENTRY qualifier uses the value of the queue entry number 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 unique entry number assigned to the job in the print or batch queue.The /ENTRY qualifier selects only records that have the specified values in the queue entry number 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 /QUEUE qualifiers, which select or reject records for print and batch jobs with specified job and queue names.
| #1 |
|---|
$ ACCOUNTING /ENTRY=(211,212,213)
|
This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for print or batch jobs with a queue entry number of 211, 212, or 213.
| #2 |
|---|
$ ACCOUNTING /ENTRY=(-25,50)
|
This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records except those for print or batch jobs with a queue entry number of 25 or 50.
Produces a full report of the selected records.
/FULL
The /FULL qualifier produces a full 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. (Note that /OUTPUT is Alpha- and Integrity servers-only.)Full reports display one screen of information for each selected record. The information displayed, and the way that it is laid out, depend on the type of the record and the data it contains.
The first line shows the event that caused the record to be logged in the accounting file. For example, for a record that was logged when an interactive process terminated, the first line shows INTERACTIVE Process Termination.
For subprocesses, the Owner ID field shows the process identifier (PID) of the parent process.
For records that contain information about DECnet for OpenVMS requests, the three Remote fields identify the remote user and remote node.
The Processor time field shows the total CPU time used. This includes any vector CPU time used. The Vector CPU time field is shown only if vector CPU time has been used.
Vector CPU time is the time that the process was scheduled on a vector-present CPU while that process was a vector consumer. Note that:
- When a process is a vector consumer, it accrues vector CPU time when it is scheduled, even if it does not issue any vector instructions.
- Processes that are scalar consumers or marginal vector consumers do not accrue vector CPU time, even when they are scheduled on vector-present CPUs.
The privilege is shown as two hexadecimal numbers that represent the first and last 32 bits of the 64-bit privilege mask. To translate the privilege bit mask into privileges, see the definitions of the symbols that begin PRV$V_ in the $PRVDEF macro in the STARLET library. For example, the $PRVDEF macro defines the PRV$V_READALL symbol to equate to 35. This means that READALL privilege is represented by bit 35 set in the privilege mask.
If you are processing only one file and you are displaying it on your screen, when you do not want to look at any more records, press Ctrl/Z to return to the DCL prompt.
See also the /BINARY qualifier, which copies the selected records to a file, and the /BRIEF and /SUMMARY qualifiers, which produce brief and summary reports of the selected records.
You cannot use the /FULL qualifier with the /BINARY, /BRIEF, or /SUMMARY qualifiers.
| #1 |
|---|
$ ACCOUNTING /FULL
|
This example displays a full report of all the records in the file SYS$MANAGER:ACCOUNTNG.DAT. This example screen shows a record that was logged when an interactive process terminated. The interactive process was created when the user JONES at the node HQ222 entered a SET HOST command to connect to the local node.
INTERACTIVE Process Termination ------------------------------- Username: FISH UIC: [DOC,FISH] Account: DOC Finish time: 23-JAN-2002 15:21:23.83 Process ID: 20A0029B Start time: 23-JAN-2002 15:19:08.28 Owner ID: Elapsed time: 0 00:02:15.55 Terminal name: RTA2: Processor time: 0 00:00:04.14 Remote node addr: 63576 Priority: 4 Remote node name: HQ222 Privilege <31-00>: 00108000 Remote ID: JONES Privilege <63-32>: 00000000 Queue entry: Final status code: 00000001 Queue name: Job name: Final status text: %SYSTEM-S-NORMAL, normal successful completion Page faults: 2043 Direct IO: 159 Page fault reads: 68 Buffered IO: 228 Peak working set: 852 Volumes mounted: 0 Peak page file: 5512 Images executed: 10 Vector CPU time: 0 00:00:0.54 Press RETURN for Next Record >
| #2 |
|---|
$ ACCOUNTING /FULL /OUTPUT=MYACC
|
This example creates the output file MYACC.LIS in the default directory. It processes the file SYS$MANAGER:ACCOUNTNG.DAT, writing a full report of all records to the new output file.
| Previous | Next | Contents | Index |