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.
- Log on to VMANAGER.
- Suspend CA VM:Account operation. This ensures that the CA VM:Account files you need to access are up to date.
- Link to the VMACCOUNT CTLDISK (1C0) minidisk to access the following required control files:
- MDISK COSTABLE
- CUSTOMER ACCTLIST
- CUSTOMER MASTER
- PROJECTS ACCTLIST
- PROJECTS MASTER
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