REPORT

Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004

Back to Main Index


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:   VSxxxxxx commands

Manuals :   Volume Management Reference Manual (32650-90045)

Back to Main Index