HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 6 Command Definitions P-R

REPORT

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Displays accounting information for the logon account and group. Any user may obtain REPORT information about the user's logon group. (Compatibility Mode)

Syntax

REPORT [groupset] [,listfile] [;ONVS=[volumesetname]]

Parameters

groupset

Specifies the accounts and groups for which information is to be listed. The permissible entries, some of which use wildcard characters, and their capability requirements such as account manager (AM) and/or system manager (SM) are listed below:

group

Reports on the specified group in the logon account. This is the default for standard users, who may specify only their logon group.

@

Reports on all groups in the logon account. This is the default for account managers, but may be executed by users with AM or SM capability.

group.acct

Reports on the specified group in the specified account. This requires SM capability.

@.acct

Reports on all groups in the specified account. This requires AM capability (if it is the logon account) or SM capability for any account.

@.@

Reports on all groups in all account totals. This is the default for system managers and requires SM capability.

ONVS= should always be used when @.@ is used as the groupset parameter.

group.@

Reports on specified group in any account. This requires SM capability.

You may use the wildcard characters, @, #, and ? to specify a set of names.

@

Specifies zero or more alphanumeric characters. Used by itself, it specifies all possible combinations of such characters. Used with other characters, it indicates all the possible names that include the specified characters (@ABC@ = all names that include ABC anywhere in the name).

#

Specifies one numeric character (A###@ = all names that begin with A followed by any three digits, followed by any combination of zero to three alphanumeric characters).

?

Specifies one alphanumeric character (A?# = all the three-character names that begin with A, followed by an alphanumeric, followed by a digit.)

The characters may be used as follows:

n@

Report on all groups starting with the character "n".

@n

Report on all groups ending with the character "n".

n@x

Report on all groups starting with the character "n" and ending with the character "x".

n##``...#

Report on all groups starting with the character "n".

?n@

Report on all groups whose second character is "n".

n?

Report on all two-character groups starting with the character "n".

?n

Report on all two-character groups ending with the character "n".

These characters, when placed appropriately in the groupset parameter, may also be used to report on accounts.

listfile

Actual file designator of the output file to which information is to be written. The default is $STDLIST, but output may be redirected with a FILE equation as follows:

  FILE LIST1;DEV=LP
REPORT, *LIST1
volume- setname

Instructs MPE/iX to report account information for the specified volume set. If this parameter is omitted, the default is the MPE/iX system volume set. Refer to "Operation Notes."

Operation Notes

The REPORT command displays the total resource usage logged against accounts and groups, and the limits on those resources. For standard users, data is displayed for their own group(s) only; account managers may specify all groups in their account; system managers may specify any or all groups in any or all accounts.

The information includes usage counts and limits for permanent file space (in sectors), CPU-time (in seconds), and session connect-time (in minutes). The file space usage count reflects the number of sectors used at the time the REPORT command is issued. However, CPU-time and connect-time usage appear as they were immediately before the beginning of the current session. CPU-time and connect-time contain non-zero values only when the MPE/iX system volume set is specified (either in the ONVS= parameter or by default when ONVS= is not used). CPU-time and connect-time are displayed as zero for non-system volume sets.

If you specify the ONVS= parameter, REPORT displays file space counts for the specified volume set(s) only. If you specify a non-system volume, all other volume names are also displayed, but their file space counts are displayed as zero even though they may not be zero. You should always specify ONVS= when @.@ is the groupset parameter.

If data for the MPE/iX system volume set is requested (either with or without the ONVS= parameter), file space counts are displayed for all volume sets (both system and non-system). However, the account total display reflects only file space in the MPE/iX system volume set.

If you specify volume-related commands or parameters for a volume set that is not currently mounted, or for an account that does not exist, MPE/iX returns an error message.

MPE/iX uses a naming convention for volume sets that differs from the MPE V/E naming convention for private volumes. As a convenience to established Hewlett-Packard users, MPE/iX does, however, accept the naming convention that was used for MPE V/E private volumes. Refer to the VSRESERVE or VSRELEASE commands in this chapter.

For information on migrating files from MPE V/E private volumes to MPE XL mountable volume sets, please refer to the chapter on DIRMIG in the Migration Process Guide (30367-60003).

NOTE: The REPORT does not produce the same output as DISCFREE because REPORT does not account for disk space taken up by objects such as directory files and label tables. To determine how much space is taken up by other objects, issue the FSCHECK TOTALEXTENTS command.

Use

This command may be issued from a session, job, program, or in BREAK. Pressing Break aborts the execution of this command. Account manager (AM) capability is required to issue the command for an entire account, or system manager (SM) capability to issue the command for the entire system.

Example

To obtain the display of account information for the group, SOPRM, enter:

  REPORT SOPRM
ACCOUNT FILESPACE-SECTORS CPU-SECONDS CONNECT-MINUTES
/GROUP COUNT LIMIT COUNT LIMIT COUNT LIMIT
SOPRM 13599 ** 30144 ** 17258 **
/GLOSSARY 1068 ** 542 ** 656 **
/PUB 182 ** 123 ** 1155 **
/SECT1 180 ** 85 ** 429 **
/SECT10 11779 ** 25271 ** 9716 **
/SECT2 390 ** 4123 ** 5302 **

Related Information

Commands

VSCLOSE, VSOPEN, VSRELEASE, VSRESERVE, VSRESERVESYS, VSTORE, VSUSER, RESETACCT, DISKUSE, DISCFREE Utility, LISTFILE

Manuals

Volume Management Reference Manual

Feedback to webmaster