HP OpenVMS Systems Documentation

The /OBJECT_TYPE qualifier is superseded by the /CLASS qualifier.

Restores an ACL from a journal file at the beginning of an editing session.

Format

/RECOVER [=file-spec]

/NORECOVER

Description

The /RECOVER qualifier specifies that the ACL editor must restore the ACL from a journal file. The ACL editor restores the ACL to the state it was in when the last ACL editing session ended abnormally.

By default the journal file is given the name of the object and a .TJL file type. If you specify a more meaningful name for the journal file when you invoke the ACL editor (by using /JOURNAL), specify that file name with the /RECOVER qualifier.

Examples

$ EDIT/ACL/JOURNAL=SAVEACL MYFILE.DAT





  

    

      

      




   .
   .
   .
User creates ACL until system crashes
   .
   .
   .
$ EDIT/ACL/JOURNAL=SAVEACL/RECOVER=SAVEACL MYFILE.DAT
   .
   .
   .
ACL is restored and user proceeds with editing until done
   .
   .
   .
^Z
$




      

The first command in this example starts the ACL editing session and specifies that the ACL editor must save the journal file SAVEACL.TJL if the session ends abnormally. The session proceeds until it is aborted by a system crash.

The next command restores the lost session with the journal file SAVEACL.TJL. To end the session, press Ctrl/Z. The ACL editor saves the edits and deletes the journal file.

2.1 ACCOUNTING Description

You can use ACCOUNTING qualifiers to:

• Produce a number of report formats
• Choose how the reports are organized
• Choose on which resources you want reports

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.

Format

ACCOUNTING [filespec[,...]]

Parameter

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.

Description

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.

Selects or rejects records for the specified account names.

Format

/ACCOUNT= ([-]account[,...])

Description

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.

Examples

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

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

Format

/ADDRESS= ([-]node_address[,...])

Description

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.

Format

/BEFORE [=time]

Description

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-2000 /BEFORE=1-DEC-2000

      

This example produces a brief report of all records time-stamped in the file SYS$MANAGER:ACCOUNTNG.DAT during November 2000.

Copies the selected records to a new file in binary format.

Format

/BINARY

Description

The /BINARY qualifier specifies that records are output in binary format to the file specified by the /OUTPUT qualifier. (/OUTPUT is Alpha-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.

Examples

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

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

Format

/BRIEF (default)

Description

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

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-2000 17:20:08 FILE_BL                      00000000         00000000
7-JAN-2000 17:22:05 PROCESS DETACHED    JONES    516000E1         02DBA002
7-JAN-2000 17:22:10 PROCESS INTERACTIVE JONES    516000DD TWA10:  00000001
7-JAN-2000 17:22:16 PROCESS INTERACTIVE JONES    51600104 TWA11:  0001C0F4
7-JAN-2000 17:22:20 PROCESS DETACHED    JONES    51600103         12DB821C
8-JAN-2000 01:06:36 PROCESS SUBPROCESS  SYSTEM   51600106         10000001
8-JAN-2000 03:09:59 PROCESS BATCH       SYSTEM   5160010F         10030001
8-JAN-2000 09:13:15 LOGFAIL                      51600105         00D3803C
8-JAN-2000 09:14:40 IMAGE   LOGINOUT    JONES    51600110         00000000
8-JAN-2000 09:28:57 PROCESS SUBPROCESS  SMITH    51600119         10000001
8-JAN-200 09:50:18 PROCESS SUBPROCESS  SMITH    5160011A         00000001

Selects or rejects records for print and batch jobs with the specified queue entry numbers.

Format

/ENTRY= ([-]entry_number[,...])

Description

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)

      

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.

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

Format

/FULL

Description

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

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-2000 15:21:23.83 Process ID: 20A0029B Start time: 23-JAN-2000 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
      

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.