HP 3000 Manuals

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