![[Digital logo]](../../IMAGES/DIGITAL-LOGO.GIF){kind=logo}
![[HR]](../../IMAGES/REDBAR.GIF)
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.
Table 2-2 shows the values stored in the account field of login failure and system initialization records.
Table 2-2 Special Account Field Values 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.
Examples
$ ACCOUNTING /ACCOUNT=(SALES, QA)
$ ACCOUNTING /ACCOUNT=(-SALES, QA) /FULL
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.
Example
$ 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.
Example
$ ACCOUNTING /SINCE=1-NOV-1995 /BEFORE=1-DEC-1995
This example produces a brief report of all records time-stamped in the file SYS$MANAGER:ACCOUNTNG.DAT during November 1995.
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. 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.
Examples
$ ACCOUNTING /USER=SMITH /BINARY /OUTPUT=MYDISK:[ACCOUNTING]MYACC.DAT
$ ACCOUNTING /TYPE=PRINT - _$ /BINARY /OUTPUT=PRINT_INFO.DAT /REJECTED=NOT_PRINT_INFO.DAT
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.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 Table 2-3 about each record in the accounting file.
Table 2-3 Information in a Brief Accounting Report Column Description Date/Time When the record was logged in the accounting file. Type The type of the record (see Table 2-5 for details of the different types of 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.
Example
$ 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-1996 17:20:08 FILE_BL 00000000 00000000 7-JAN-1996 17:22:05 PROCESS DETACHED JONES 516000E1 02DBA002 7-JAN-1996 17:22:10 PROCESS INTERACTIVE JONES 516000DD TWA10: 00000001 7-JAN-1996 17:22:16 PROCESS INTERACTIVE JONES 51600104 TWA11: 0001C0F4 7-JAN-1996 17:22:20 PROCESS DETACHED JONES 51600103 12DB821C 8-JAN-1996 01:06:36 PROCESS SUBPROCESS SYSTEM 51600106 10000001 8-JAN-1996 03:09:59 PROCESS BATCH SYSTEM 5160010F 10030001 8-JAN-1996 09:13:15 LOGFAIL 51600105 00D3803C 8-JAN-1996 09:14:40 IMAGE LOGINOUT JONES 51600110 00000000 8-JAN-1996 09:28:57 PROCESS SUBPROCESS SMITH 51600119 10000001 8-JAN-1996 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.
Examples
$ ACCOUNTING /ENTRY=(211,212,213)
$ ACCOUNTING /ENTRY=(-25,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.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, refer to 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.
Examples
$ ACCOUNTING /FULL
INTERACTIVE Process Termination
-------------------------------
Username: FISH UIC: [DOC,FISH]
Account: DOC Finish time: 23-JAN-1996 15:21:23.83
Process ID: 20A0029B Start time: 23-JAN-1996 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 >
$ ACCOUNTING /FULL /OUTPUT=MYACC
Selects or rejects records for the specified processes.
/IDENT= ([-]pid[,...])
The /IDENT qualifier uses the value of the process identifier (PID) field to select records for processing. This field is present in all records except file backward link and file forward link records. For print job records, it contains the PID of the process that submitted the job.The /IDENT qualifier selects only records that have the specified values in the PID field. If you precede the values with a minus sign, it selects all records except those with the specified values.
See also the /OWNER qualifier, which selects or rejects records for subprocesses created by specified processes.
Examples
$ ACCOUNTING /IDENT=(25634,045A6B)
$ ACCOUNTING /IDENT=(-25634,045A6B)
Selects or rejects records for the specified images.
/IMAGE= ([-]image_name[,...])
The /IMAGE qualifier uses the value of the image name field to select records for processing. This field is present only in records of type IMAGE, and contains the name of the image.Note that the system does not track records of type IMAGE by default. To enable the tracking of IMAGE records, use the SET ACCOUNTING command.
The /IMAGE qualifier selects only records that have the specified values in the image name field. If you precede the values with a minus sign, it selects all records except those with the specified values.
Each image name is a string that gives the file name portion of the image file specification. Do not include the device, directory, or file type.
Examples
$ ACCOUNTING /IMAGE=DIRECTORY
$ ACCOUNTING /IMAGE=-DIRECTORY
Selects or rejects records for print and batch jobs with the specified job names.
/JOB= ([-]job_name[,...])
The /JOB qualifier uses the value of the job 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 and batch jobs, it contains the name of the job.The /JOB qualifier selects only records that have the specified values in the job name field. If you precede the values with a minus sign, it selects all records except those with the specified values.
See also the /QUEUE and /ENTRY qualifiers, which select or reject records for print and batch jobs with specified queue names and queue entry numbers.
Examples
$ ACCOUNTING /JOB=(MYJOB1,MYJOB2)
$ ACCOUNTING /JOB=(-MYJOB1,MYJOB2) /FULL
Outputs informational messages.
/LOG
The /LOG qualifier outputs these informational messages to the current SYS$OUTPUT device:
- For each file processed, the name of the file and the number of records selected and rejected from that file
- If you use the /SORT qualifier, the total number of records merged in the sort (this is the total number of records selected from all the files that were processed)
- If you process more than one file, the total number of files that were processed, and the total number of records selected and rejected
Example
$ ACCOUNTING MYFILE1.DAT,MYFILE2.DAT /TYPE=PRINT /SORT=USER /OUTPUT=OUTFILE %ACC-I-INPUT, SYS$SYSROOT:[SYSMGR]MYFILE1.DAT;7, 297 selected, 16460 rejected %ACC-I-INPUT, SYS$SYSROOT:[SYSMGR]MYFILE2.DAT;13,302 selected, 16388 rejected %ACC-I-MERGE, 599 records to be merged %ACC-I-TOTAL, 599 selected, 32848 rejected, 2 input files
This example processes two accounting files. It writes a brief report of all the records for print jobs, sorted in user name order, to an output file and displays informational messages that tell you which files were processed and how many records were selected and rejected.
Selects or rejects records for DECnet for OpenVMS requests made by the specified nodes.
/NODE= ([-]node_name[,...])
The /NODE qualifier uses the value of the remote node 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 DECnet for OpenVMS requests, it contains the name of the node that made the request.The /NODE qualifier selects only records that have the specified values in the remote node name field. If you precede the values with a minus sign, it selects all records except those with the specified values.
Do not include the double colon (::) after the name of the node.
See also the /ADDRESS and /REMOTE_ID qualifiers, which select or reject records for DECnet for OpenVMS requests made by specified node addresses and remote IDs respectively.
Examples
$ ACCOUNTING /NODE=HQ291 /FULL
$ ACCOUNTING /NODE=(-HQ222,HQ223)
Specifies the output file.Requires read and write access to the directory in which the output file is created.
/OUTPUT [=filespec]
The /OUTPUT qualifier creates the specified output file and writes the report or copies the selected records to that file.If you omit the /OUTPUT qualifier, or you use the /OUTPUT qualifier and omit the file specification, the report or selected records are output to the current SYS$OUTPUT device.
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, the default file type is .LIS if you are producing reports, and .DAT if you are copying records.
Examples
$ ACCOUNTING MYFILE1.DAT,MYFILE2.DAT /SORT=USER /BINARY /OUTPUT=.NEW
$ ACCOUNTING MYFILE1.NEW /FULL /OUTPUT=MYDISK:[ACCOUNTING]STAT
Selects or rejects records for subprocesses created by the specified processes.
/OWNER= ([-]owner_pid[,...])
The /OWNER qualifier uses the value of the process owner field to select records for processing. This field is present in all records except file backward link and file forward link records. For a subprocess, this field contains the process identifier (PID) of the process that created it.The /OWNER qualifier selects only records that have the specified values in the process owner field. If you precede the values with a minus sign, it selects all records except those with the specified values.
See also the /IDENT qualifier, which selects or rejects records for specified processes.
Example
$ ACCOUNTING /OWNER=(25634,045A6B)
This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for subprocesses created by processes with a PID of 25634 or 045A6B.
6048P002.HTM OSSG Documentation 26-NOV-1996 12:42:19.01
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.