REPORT



REPORT

     Displays accounting information for the logon account and
group. Any user may obtain REPORT information about the
user's logon group. You must have account manager (AM)
capability to issue the command for an entire account; or
System Manager (SM) capability to issue the command for the
entire system. (CM)

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 "wild card" characters,
and their capability requirements 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 accounts. This is the
default for system managers and requires SM
capability.

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

You may use wild card 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 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" followed by as many digits
as there are # marks (7 maximum here).

?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

volumesetname Instructs MPE/iX to report accounting information
for the specified volume set. If you omit the
parameter, the request is issued for the home volume
set of the user's logon group and account. Refer to
"OPERATION".

OPERATION

     The REPORT command displays the total resource usage logged
against accounts and groups, and the limits on those
resources. For the standard user, data will be displayed
for their own group(s) only; an account manager may
specify all groups in their account; the system manager
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. Note that it does not account
for disc space taken up by root, account, and group directory
files, any directories and/or files that are not descended
from an MPE/iX account, label tables, transaction management
logs and other internal system objects. 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 ONVS= is used, file space counts are displayed for the
specified volume set(s) only. If a non-system volume is
specified, all other volume names are also displayed, but
their file space counts are displayed as zero even though
they may not be zero.

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.

Caution


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

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

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

This command may be issued from a session, job, program, or
in BREAK. Pressing [Break] aborts the execution of this command.

NOTE

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 will return a corresponding error message

EXAMPLE(S)

     To obtain accounting information for your group, enter the
REPORT command. Accounting information will be displayed
the way the REPORT of the SOPRM account is shown here

REPORT @.SOPRM

ACCOUNT FILESPACE-SECTORS CPU-SECONDS CONNECT-MINUTES
/GROUP COUNT LIMIT COUNT LIMIT COUNT LIMIT
SOPRM 99004 ** 99057 ** 88407 **
/GLOSSARY 1068 ** 542 ** 656 **
/PUB 182 ** 123 ** 1155 **
/SECT1 180 ** 85 ** 429 **
/SECT10 11779 ** 25271 ** 9716 **
/SECT2 390 ** 4123 ** 5302 **
/SECT3 10675 ** 8176 ** 13116 **
/SECT4 2372 ** 225 ** 294 **
/SECT5 46579 ** 27218 ** 25744 **
/SECT6 6008 ** 9324 ** 6638 **
/SECT7 4748 ** 8303 ** 13263 **
/SECT8 1957 ** 6348 ** 3997 **
/SECT9 3195 ** 4570 ** 4213 **

ADDITIONAL INFORMATION

Commands:   VSRESERVE VSRELEASE

Manuals : Volume Management Reference Manual (32650-90045)