6. DATA SOURCES › 6.1 Data Collection and Transport to CA MICS › 6.1.1 Data Collector Operations › 6.1.1.3 CA MICS VMS System Usage Data Collection (DEXSUS)
6.1.1.3 CA MICS VMS System Usage Data Collection (DEXSUS)
The CA MICS VMS System Usage collection routine is a DCL
routine called DEXSUS.COM. This section explains the
execution options and typical operation of the DEXSUS.COM
routine under VMS. Chapter 8 of this guide explains how to
install the DEXSUS.COM routine on your VMS system.
The DEXSUS.COM routine collects three types of information
about disk devices from the following VMS utilities:
- SHOW DEVICE/FULL
- DISKQUOTA
- ANALYZE/DISK_USAGE
You can control the operation of each of these utilities with
the options described below. The options allow you to select
which disk devices are measured by each of the three
utilities. You can select or exclude certain devices. You
can also select which utilities to run. Standard operation
of the DEXSUS routine is to collect all three types of disk
information on all active, mounted disk devices on the
system, as determined by the command SHOW DEV D /MOUNTED.
The DEXSUS routine writes all the data it collects to a
single file named DEXSUS.DAT.
To start DEXSUS.COM, enter:
@DEXSUS
Options (VMS global symbol assignments)
DEXSUSDF - default directory for DEXSUS.COM operation
DEXSUSO1 - default options for SHOW DEV in DEXSUS.COM
DEXSUSL1 - disk select list for: SHOW/DEV/FULL
DEXSUSL2 - disk select list for: DISKQUOTA
DEXSUSL3 - disk select list for: ANALYZE/DISK
DEXSUSX1 - disk exclude list for: SHOW/DEV/FULL
DEXSUSX2 - disk exclude list for: DISKQUOTA
DEXSUSX3 - disk exclude list for: ANALYZE/DISK
DEXSUSV1 - volume set switch for: SHOW/DEV/FULL
DEXSUSV2 - volume set switch for: DISKQUOTA
DEXSUSV3 - volume set switch for: ANALYZE/DISK
DEXSUSS1 - shadow master switch for: SHOW/DEV/FULL
DEXSUSS2 - shadow master switch for: DISKQUOTA
DEXSUSS3 - shadow master switch for: ANALYZE/DISK
DEXSUSL - disk select list: L1, L2, L3 default
DEXSUSX - disk exclude list: X1, X2, X3 default
DEXSUSV - volume set switch: V1, V2, V3 default
DEXSUSS - shadow master switch: S1, S2, S3 default
The DEXSUSDF option sets the default directory for DEXSUS.COM
operation. Temporary files and the completed DEXSUS.DAT
output file are written to this directory.
The DEXSUSO1 option sets the criteria for the SHOW DEVICE
command that determines the full list of active, mounted disk
devices on the system. The default value is "D /MOUNTED",
causing the SHOW DEV D /MOUNTED command to determine which
disk devices to measure.
The DEXSUSLn and DEXSUSXn options allow you to control the
collection of data from each of the three disk measurement
utilities. For each type of disk data collection source,
you can list a specific set of disk devices to select or
exclude from the list of all active disks. The DEXSUS
routine recognizes the presence of these lists, and limits
collection activities accordingly.
The DEXSUSVn and DEXSUSSn options control the collection of
data from Volume Sets and Shadow Sets by each of the three
disk measurement utilities. By default, only Volume 1 of
Volume Sets and only Shadow Masters in Shadow Sets are
measured. This is indicated by a setting of "Y" (or "YES")
for the DEXSUSVn and DEXSUSSn options. This means that other
volumes in these sets are normally excluded from measurement.
You can include all volumes in Volume Sets or Shadow Sets for
each of the three disk measurement utilities by setting the
appropriate DEXSUSVn and DEXSUSSn exclusion options to "N"
(or "NO").
If you assign a value to DEXSUSx, then DEXSUSx1, DEXSUSx2,
and DEXSUSx3 will all default to the value of DEXSUSx.
However, if you also assign a value to DEXSUSx1, DEXSUSx2,
or DEXSUSx3, then this assigned value overrides the default
assigned to DEXSUSx for that specific list. 'x' can be
one of the following characters: L, X, V, or S.
To completely deactivate the collection of data by any of the
three utilities, use a select list of "X". For example, to
completely skip DISKQUOTA processing use:
DEXSUSL2=="X"
REMINDER: Use VMS global assignments (==) to set the values
of any of the option symbols.
EXAMPLES
The following examples illustrate the use and syntax of the
options for DEXSUS.COM execution.
Example: DEXSUSDF=="<MICS.DEXSUS>"
DEXSUSL2=="DUA1 DUA2"
DEXSUSX3=="DUS1"
@DEXSUS
In this example, DEXSUS will use the directory
<MICS.DEXSUS> as its default directory, by issuing SET
DEF 'dexsusdf'. The assignment of DEXSUSL2 will limit
data collection for DISKQUOTA to the devices DUA1 and
DUA2. The assignment of DEXSUSX3 will exclude device
DUS1 from data collection by ANALYZE/DISK. All available
mounted disks will be included in the SHOW DEVICE disk
measurement function of DEXSUS because neither DEXSUSL1
nor DEXSUSX1 (nor DEXSUSL nor DEXSUSX) has been assigned
to limit this function. However, only Volume 1 of Volume
Sets and only Shadow Masters will be considered for SHOW
DEVICE and ANALYZE/DISK because of the defaults taken for
DEXSUSVn and DEXSUSSn.
Example: DEXSUSDF=="<MICS.DEXSUS>"
DEXSUSL2=="X"
DEXSUSL3=="X"
DEXSUSV1=="N"
DEXSUSS1=="N"
@DEXSUS
In this example, DEXSUS will use the directory
<MICS.DEXSUS> as its default directory, and will scan all
available mounted disks. The only disk measurements
taken will be those from the SHOW DEVICE function of
DEXSUS because DEXSUSL2 and DEXSUSL3 have been set to
"X". Neither DISKQUOTA nor ANALYZE/DISK data will be
collected. All disks, including all members of Volume
Sets and all Shadow Members, will be included because the
DEXSUSV1 and DEXSUSS1 filters have been disabled with a
setting of "N".
SAMPLE JOB
A sample routine called DEXSUSJ1.COM is supplied with the
CA MICS VAX/VMS Analyzer to help you set up and schedule
a batch job that records the DEXSUS data for CA MICS. A
copy of this routine is stored on your CA MICS system in
sharedprefix.MICS.SOURCE(DEXSUSJ1).
EXAMPLE: @DEXSUSJ1 TOMORROW 999 X
Will run DEXSUS each day for 999 days. The X
option causes the routine to bypass immediate
interactive execution.
EXAMPLE: @DEXSUSJ1
Will run DEXSUS immediately, one time, and then
shut down.
