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. 3 Example $ ACCOUNTING /SINCE=5-JAN-2000 This example produces a brief report of all records time-stamped at or after 5-JAN-2000 in the file SYS$MANAGER:ACCOUNTNG.DAT. 2 /SORT Sorts the selected records. Format /SORT[=([-]sort_field[,...])] 3 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_ Vector CPU time (see the description of the PROCESSOR /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 the table in the /TYPE qualifier section for details of the types of record in which the corresponding field is present. 3 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. 3 Examples 1.$ 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 example shows the report that is produced: Date / Time Type Subtype Username ID Source Status ------------------------------------------------------------------------- 4-JAN-2000 09:53:05 PRINT BROWN 20A00193 00040001 13-JAN-2000 13:36:04 PRINT BROWN 20A00442 00000001 13-JAN-2000 12:42:37 PRINT BROWN 20A00442 00000001 13-JAN-2000 14:43:56 PRINT DECNET_MAIL 20A00456 00000001 14-JAN-2000 19:39:01 PRINT DECNET_MAIL 20A00265 00000001 14-JAN-2000 20:09:03 PRINT DECNET_MAIL 20A00127 00000001 14-JAN-2000 20:34:45 PRINT DECNET_MAIL 20A00127 00000001 14-JAN-2000 11:23:34 PRINT FISH 20A0032E 00040001 14-JAN-2000 16:43:16 PRINT JONES 20A00070 00040001 14-JAN-2000 09:30:21 PRINT SMITH 20A00530 00040001 2.$ 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. 2 /STATUS Selects or rejects records with the specified final exit status codes. Format /STATUS=([-]status_code[,...]) 3 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. Each status-code must be a hexadecimal number of eight digits or less. 3 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. 2 /SUMMARY Produces a summary report of the selected records. Format /SUMMARY[=(summary_item[,...])] 3 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. 3 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. 3 Examples 1.$ 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-2000 15:55 VAX/VMS Accounting Report To: 15-JAN-2000 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 2.$ 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-2000 15:55 VAX/VMS Accounting Report To: 15-JAN-2000 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 2 /TERMINAL Selects or rejects records for interactive sessions at the specified terminals. Format /TERMINAL=([-]terminal_name[,...]) 3 Description The /TERMINAL qualifier uses the value of the terminal 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 interactive sessions, this field contains the name of the terminal associated with the session. The /TERMINAL qualifier selects only records that have the specified values in the terminal name field. If you precede the values with a minus sign, it selects all records except those with the specified values. Give the terminal name as the standard device name and include the colon (:). 3 Example $ ACCOUNTING /TERMINAL=TTB3: This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for interactive sessions at the terminal TTB3. 2 /TITLE Specifies the title shown on the first line of a summary report. Format /TITLE=title 3 Description The /TITLE qualifier specifies the title shown in the center of the first line of summary reports. The title is truncated if it is too long. For reports displayed on your screen, the title is truncated if it is longer than (W-56) characters, where W is the width (in characters) of your screen. 3 Example $ ACCOUNTING /SUMMARY=IMAGE /TITLE="June Accounting Report" This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a summary report that shows the number of times each image was executed. The title "June Accounting Report" appears at the top of the report. 2 /TYPE Selects or rejects the specified types of record. Format /TYPE=([-]record_type[,...]) 3 Keyword record_type[,...] Specifies the types of record that you want to select or reject. The following table shows the keywords available. Type of Keyword Record Description of Record FILE FILE_BL File backward link. This is the first record in the accounting file. It is logged when the file is created, and contains the name of the previous accounting file. FILE_FL File forward link. This is the last record in the file. It is logged when the file is closed, and contains the name of the next accounting file. IMAGE IMAGE Image termination. It contains details of the resources used by the image. LOGFAIL LOGFAIL Failed attempt to log in. It contains details of the resources used by the login attempt. PRINT PRINT Print job termination. It contains details of the resources used by the print job. PROCESS PROCESS Process termination. It contains details of the resources used by the process. Note that this includes the resources used by the images executed by that process. SYSINIT SYSINIT System booted. It contains details of resources used to boot the system. UNKNOWN Record not recognized as one of the other types in this table. USER USER Record logged by a program calling the $SNDJBC system service to send an accounting message. 3 Description All records in an accounting file contain a type field that contains the type of the record. The /TYPE qualifier selects the specified types of record. If you precede the list with a minus sign, it selects all records except those specified. See also the /PROCESS qualifier, which selects or rejects records for particular types of process. 3 Example $ ACCOUNTING /TYPE=PRINT This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for print jobs. $ ACCOUNTING /TYPE=-PRINT This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records except those for print jobs. 2 /UIC Selects or rejects records for the specified UICs. Format /UIC=([-]uic[,...]) 3 Description The /UIC qualifier uses the value of the UIC field to select records for processing. This field is present in all records except file backward link and file forward link records. It contains the value [SYSTEM] for login failure records where the user did not give a valid user name. The /UIC qualifier selects only records that have the specified values in the UIC field. If you precede the values with a minus sign enclosed in parentheses and followed by a comma, all records except those with the specified values are selected. You can specify the UIC in numeric or alphanumeric format, and can use the asterisk (*) wildcard character. 3 Examples 1.$ ACCOUNTING /UIC=([360,*],[ADMIN,COTTON]) This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for users in group number 360 or users whose UIC is [ADMIN,COTTON]. 2 /USER Selects or rejects records for the specified user names. Format /USER=([-]user name[,...]) 3 Description The /USER qualifier uses the value of the user name field to select records for processing. This field is present in all records except file backward link and file forward link records. It contains the value for login failure records where the user did not give a valid user name. The /USER qualifier selects only records that have the specified values in the user name field. If you precede the values with a minus sign, it selects all records except those with the specified values. 3 Examples 1.$ ACCOUNTING /USER=SMITH This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for the user SMITH. 2.$ ACCOUNTING /USER=(-SMITH,JONES) This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all the records except for those of the users SMITH and JONES. 2 /WIDE Changes the width of Buffered I/O and Direct I/O fields in a report from 8 to 10 characters. When used with the /BRIEF qualifier, it increases the SOURCE field length to 9 characters resulting in a total display width of 81 characters for both interactive and non-interactive processes. By default, the display of the SOURCE field is truncated to 8 characters, which results in a total display width of 80 characters. Format /WIDE 3 Description This qualifier corrects a problem that users have had with ACCOUNTING reports: the Buffered I/O and Direct I/O fields were too small and displayed asterisks (*) when numbers exceeded 8 characters. The /WIDE qualifier changes the widths of the Buffered I/O and Direct I/O fields in reports to 10 characters. When used with the /BRIEF qualifier, it displays the trailing colon of long device names in the SOURCE field. The /WIDE qualifier in conjunction with /BRIEF qualifier is used to display 9 characters of the SOURCE field. The /WIDE qualifier extends the width of display to 81 characters irrespective of the current terminal width and the type of process, that is, whether the process is interactive, non-interactive, or batch process. 3 Examples 1.$ ACCOUNTING /PROC=BATCH /TYP=PROC - /REPORT=(RECORDS,PROCESSOR,DIRECT_IO,BUFFER) - /SUMM=MONTH /SIN=1-JAN /WIDE MM TOTAL PROCESSOR DIRECT BUFFERED RECORDS TIME I/O I/O ------------------------------------------------------ 01 2043 19 06:52:40.97 532675222 551986091 02 1767 9 00:14:34.00 183290432 420000532 ------------------------------------------------------ Without the /WIDE qualifier, the Direct I/O or Buffered I/O fields print ***** if the field overflows. With the /WIDE qualifier, these fields print correctly. 2.$ ACCOUNTING /SINCE/WIDE/BRIEF Date / Time Type Subtype Username ID Source Status -------------------------------------------------------------------------------- 3-FEB-2011 19:03:59 PROCESS INTERACTIVE SYSTEM 00001314 MBA9997: 00002BD4 3-FEB-2011 19:03:59 PROCESS INTERACTIVE SYSTEM 00001315 MBA10000: 00002BD4 3-FEB-2011 19:03:59 PROCESS INTERACTIVE SYSTEM 00001316 MBA10003: 00002BD4 If the /WIDE qualifier is not in conjunction with /BRIEF qualifier, the ":" in the SOURCE field is not displayed when the number of characters in the field exceeds 8 characters. With the /WIDE qualifier, it displays the complete SOURCE field for large devices.