Document revision date: 30 March 2001

## OpenVMS System Management Utilities Reference Manual

Previous | Contents | Index

## /IDENT

> Selects or rejects records for the specified processes.

### Format

> /IDENT= ([-]pid[,...])

### Description

> 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

#1
    $ ACCOUNTING /IDENT=(25634,045A6B)

> This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for processes with a PID of 25634 or 045A6B.

#2
    $ ACCOUNTING /IDENT=(-25634,045A6B)

> This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records except those for processes with a PID of 25634 or 045A6B.

## /IMAGE

> Selects or rejects records for the specified images.

### Format

> /IMAGE= ([-]image_name[,...])

### Description

> 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

#1
    $ ACCOUNTING /IMAGE=DIRECTORY

> This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for the DIRECTORY.EXE image.

#2
    $ ACCOUNTING /IMAGE=-DIRECTORY

> This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records except those for the DIRECTORY.EXE image.

## /JOB

> Selects or rejects records for print and batch jobs with the specified job names.

### Format

> /JOB= ([-]job_name[,...])

### Description

> 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

#1
    $ ACCOUNTING /JOB=(MYJOB1,MYJOB2)

> This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records for print or batch jobs named MYJOB1 or MYJOB2.

#2
    $ ACCOUNTING /JOB=(-MYJOB1,MYJOB2) /FULL

> This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a full report of all records except those for print or batch jobs named MYJOB1 or MYJOB2.

## /LOG

> Outputs informational messages.

### Format

> /LOG

### Description

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

## /NODE

> Selects or rejects records for DECnet for OpenVMS requests made by the specified nodes.

### Format

> /NODE= ([-]node_name[,...])

### Description

> 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

#1
    $ ACCOUNTING /NODE=HQ291 /FULL

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

#2
    $ ACCOUNTING /NODE=(-HQ222,HQ223)

> This example processes the file SYS$MANAGER:ACCOUNTNG.DAT. It produces a brief report of all records except those for DECnet for OpenVMS requests made by the nodes HQ222 or HQ223.

## /OUTPUT (Alpha Only)

> Specifies the output file.

> Requires read and write access to the directory in which the output file is created.

### Format

> /OUTPUT [=filespec]

### Description

> 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

#1
    $ ACCOUNTING MYFILE1.DAT,MYFILE2.DAT /SORT=USER /BINARY /OUTPUT=.NEW

> This example creates the output file MYFILE1.NEW in the default directory. It processes two accounting files, MYFILE1.DAT and MYFILE2.DAT, sorting their records in user name order, then copies these records to the new output file.

#2
    $ ACCOUNTING MYFILE1.NEW /FULL
    /OUTPUT=MYDISK:[ACCOUNTING]STAT

> This example creates the output file MYDISK:[ACCOUNTING]STAT.LIS, and writes a full report of all the records in MYFILE1.NEW to the new output file.

## /OWNER

> Selects or rejects records for subprocesses created by the specified processes.

### Format

> /OWNER= ([-]owner_pid[,...])

### Description

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

## /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

### 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. The following table shows the keywords available.

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

1Present in records of type PRINT
2Present 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.

### 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

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

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

Previous | Next | Contents | Index

| privacy and legal statement |
6048PRO_003.HTML