REPORT [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation
MPE/iX Commands Reference Manual Volume I
REPORT
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 (32650-90045)
MPE/iX 5.0 Documentation