Contents

The VMRMCA has the following syntax:

VMRMCA [filename] [([“Creation Opts”] [“Output”] [“Format”]]
  Creation Opts: [BYgroup groupname] [SETUP groupname ]
[groupname groupmember]
[GRPCOST nn]
[EXTREME]
[MAXOBS nn]
[NOEXCLUDE]
[NOMSG]
  Output: [NOHOLD] [PRINT]
[PRTCLASS class]
[DISTRIB]
Format: [DATEFMT [MMDDYY | DDMONYY | YYMMDD | DDMMYY]] [SORTBY method]
[PAGESIZE nn]
[UPCASE]
[NOOVP]
[NOCOST]
[DETAIL [ NORMAL | ALL | EXTREME ]]
  • filename
    Specifies the filename of the CMS file containing minidisk utilization statistics collected by the VMRMDS utility. The default is VMANAGER CMSDISKS. This file must have a filetype of CMSDISKS.
  • BYgroup
    Allows you to produce reports on minidisk utilization costs for each member of a specified group. The default for groupname is CUSTOMER.
  • SETUP
    Allows you to create a groupname THRESHLD file and an empty groupname USERID file for the specified groupname. No VMRMCA reports are created. To create a MANAGER THRESHLD file, the VMSECURE MANAGER or VMDIRECT MANAGER file must be accessed. You cannot create a DISTRIB THRESHLD file. This option cannot be used with any other option.
  • groupname
    Specifies the name of the group for which files and/or reports are to be created. Valid groupnames are:
    • ACCTCODE
    • ACIGROUP
    • CUSTOMER
    • DEVTYPE
    • DISTCODE
    • MANAGER
    • PROJECT
    • USERID
    • VOLUME
  • groupname groupmember
    Creates a report only for the specified groupmember of the specified groupname. Valid groupname groupmember combinations are:
    • ACCTCODE acctnumber
    • ACIGROUP acigrpname
    • CUSTOMER custname
    • DEVTYPE devtype
    • DISTCODE distcode
    • MANAGER mgrname
    • PROJECT prjtname
    • USERID useridname
    • VOLUME volser
  • GRPCOST nn
    Restricts reporting to group members incurring at least the specified monthly charge.
  • EXTREME
    Overrides exceptions defined in the THRESHLD file for the entire group.
  • MAXOBS nn
    Limits the number of observations appearing in a group report. The lower limit is 15; there is no upper limit. The default is 50. MAXOBS is ignored for group members whose report detail level is ALL.
  • NOEXCLUDE
    Overrides any existing EXCLUDE or INCLUDE files.
  • NOMSG
    Suppresses messages issued by VMRMCA. This option is not recommended because no console log is written containing messages about the VMRMCA session.
  • DATEFMT xxxxxx
    Sets the date format that you want to use. Valid format options are: MMDDYY, DDMONYY, YYMMDD, and DDMMYY.
  • SORTBY method
    Specifies the method for sorting records. If you don't use this option, the default, UNUSED is to sort by decreasing cost of minidisk space. If you specify the NOCOST option (discussed below) and don't specify a SORTBY method, the default is SORTBY method UNUSED by unused minidisk space. You must specify the USERID parameter if you want to sort by user ID.
  • PAGESIZE nn
    Sets the page length. The lower limit is 25; there is no upper limit. The default is 55 lines per page.
  • UPCASE
    Translates the reports into uppercase characters. The default is mixed case. Use this option if your printer does not support mixed case.
  • NOOVP
    Suppresses overprinting of characters used to highlight information in the reports. Minidisks falling outside EXTREME threshold conditions are overprinted for easy identification. If you use a printer that cannot overprint, use this option. The minidisks that fall outside the EXTREME threshold conditions will be identified by a vertical bar (|).
  • NOCOST
    Eliminates monthly minidisk charge information from the reports. This option is in effect automatically if the CA VM:Account MDISK COSTABLE file is not available as input.
  • DETAIL [ NORMAL | ALL | EXTREME ]
    Defines the level of detail that appears on the report. ALL indicates that detail is given for all minidisks selected. NORMAL indicates that detail is given only for minidisks that have been flagged by an exception code. EXTREME indicates that detail is given only for minidisks that have been flagged by extreme condition codes, for example, underutilized minidisks greater than 95 percent full.
  • NOHOLD
    Sets the virtual printer to user NOHOLD status. The default is HOLD.
  • PRINT
    Routes the reports to your virtual printer rather than creating a VMRMCA LISTING file. When combined with DISTRIB, this option sends a print file for each group member.
  • PRTCLASS class
    Defines the virtual printer output class. The default class is R.
  • DISTRIB
    Produces a separate print file for each user ID defined in the groupname USERID file.

Instructions

To ensure accurate results, run VMRMDS immediately before running VMRMCA.

  1. Log on to VMANAGER.
  2. Suspend CA VM:Account operation. This ensures that the CA VM:Account files you need to access are up to date.
  3. Link to the VMACCOUNT CTLDISK (1C0) minidisk to access the following required control files:
    • MDISK COSTABLE
    • CUSTOMER ACCTLIST
    • CUSTOMER MASTER
    • PROJECTS ACCTLIST
    • PROJECTS MASTER
  4. Invoke VMRMCA by entering:

    VMRMCA 
    

Examples

 

  • To create the default VMRMCA reports, enter:

    VMRMCA
    
  • To create a report grouped by account codes for volume VMPK23, enter:

    VMRMCA ( BYGROUP ACCTCODE VOLUME VMPK23
    
  • To create a THRESHLD file for CA VM:Account customers, enter:

    VMRMCA ( SETUP CUSTOMER
    

    No reports are created.

  • To group the reports by CA VM:Secure manager and distribute the reports to each manager's virtual printer, enter:

    VMRMCA ( BY MANAGER DISTRIB
    
  • To specify that you want to look only at DASD volumes that begin with the prefix VMS, group the reports by account code, and override any existing VMRMCA EXCLUDE or VMRMCA INCLUDE files, enter:

    VMRMCA ( VOLUME VMS* BY ACCTCODE NOEXCLUDE
    
  • To build on the previous example, including only VM account codes that begin with the prefix 30 and suppressing the VMRMCA costing feature, enter:

    VMRMCA ( VOLUME VMS* BY ACCTCODE ACCTCODE 30* NOEXCLUDE NOCOST
    
  • To specify that you want to group the reports by the VM account code, restrict the analysis to user IDs with the prefix FIN, limit the number of minidisks appearing in any report to 30, and ignore group members with total monthly minidisk charges less than $5.00, enter:

    VMRMCA ( BY ACCTCODE USERID FIN* MAXOBS 30 GRPCOST $5