Qualifiers

 This section describes the purpose of each VDM qualifier.  Then it lists all the qualifiers in alphabetical order and describes each qualifier in detail.


Qualifier syntax
VDM qualifiers look and act like DCL qualifiers.  They conform to normal OpenVMS DCL command qualifier syntax.

A qualifier consists of a keyword, or a keyword followed by a value.  The keyword starts with a slash.  All qualifiers apply to the entire command.  VDM qualifiers have one of the following formats:

    VDM/qualifier

    VDM/qualifier=x

Depending on the qualifier, "x" can be an alphanumeric value, a numeric value, a file name, a device, a directory, a date or a specially formatted clause such as an access control entry.

Most of the qualifiers have defaults.
VDM qualifier list
This page contains a complete list of all VDM qualifiers.  Subsequent pages contain detailed descriptions of each qualifier.

/ACE                Specify selection criteria
/ACTIVE            Submit cleanup procedures
/ALL                Used with /REPORT=TRACE
/ALLOCATED        Specify selection criteria
/BACKUP            Select files based on their backup date
/BEFORE            Select all dates before the specified date
/BROADCAST        Send message to users
/CONSOLE            Log activities to security operators
/CONVERT            Convert data files from a previous version
/CREATED            Select files based on their creation date
/CURRENT            Specify date of current data
/DATA_FILE        Specify data file to reset
/DATE            Specify date of files to convert (obsolete)
/DCL                Specify a filename for selected files
/DIR_COLLECT        Used in batch procedures to collect data
/DIR_FILE            Used with /REPORT=TRACE
/DISK            Specify selection criteria
/EXCEPTION        Enable exception reporting
/EXPIRED            Select files based on their expiry date
/EVENT            Specify file monitoring event details
/FILE            Specify a file to be monitored
/FILE            Specify a file selection criteria for reports
/FLAGS            Select files based on their flag settings
/FRAGMENTS        Select files based on their fragmentation
/INDENT            Set the amount of indentation in tree reports
/INTERVAL            Set interval between free space checks
/LARGE_CHANGE        Specify threshold for flagging large changes
/LEVEL            Specify number of directory levels
/LIST            Specify a list of report fields
/LOG                Close log file and start a new one
/MAIL            Define users to receive mail messages
/MATCH            Specify logical operation for protection
/MAXIMUM            Specify maximum rate of change percentage
/MINIMUM            Specify minimum rate of change percentage
/MODIFIED            Select files based on their modification date
/MONITOR            Used to monitor disk free space and errors
/NEAR_QUOTA        Specify threshold for flagging quotas
/NUM_FILES        Specify how many files to include in the largest_files report
/ORGANIZATION        Specify files based on their organization
/OUTPUT            Specify the destination of output
/OWNER            Specify selection criteria
/PANIC            Define second free space threshold
/PERIOD            Specify interval projection time in months
/PREVIOUS            Specify date of previous data
/PROTECTION        Specify selection criteria
/QUOTA_COLLECT        Used in batch procedures to collect data
/RATE            Specify projected capacity planning growth
/REPORT            Specify a report to be generated
/RESET            Reset averages and/or maximums in data files
/SEQUENCE            Specify the sequence of a report
/SHOW            Specify blocks or files on reports
/SINCE            Select all dates since the specified date
/SIZE            Enable size checking for analysis reports
/SORT            Specify the sequence of a report
/START            Start the VDM/MONITOR process
/STATISTICS        Specify file statistics during operations
/STATUS            Show VDM/MONITOR status
/STOP            Stop the VDM/MONITOR process
/SUMMARY            Summarize all disks specified
/TITLE            Specify a user title to appear on the report
/TYPE            Specify UIC format
/UIC_COLLECT        Used in batch procedures to collect data
/UIC_FILE            Used with /REPORT=TRACE
/UNUSED            Specify selection criteria
/USAGE            Specify data type used in capacity planning
/USED            Specify selection criteria
/VALUE            Specify type of value to reset
/VERSION            Display VDM version
/WORRY            Define first free space threshold

Qualifiers Reference

/ACE

   Use this qualifier to ensure that only those files including the specified ACE in their ACL are selected.  If you omit the qualifier, ACE's are not used to select files.

FORMAT
    /REPORT=rpt_type/ACE=(IDENTIFIER=identifier,ACCESS=access)

KEYWORDS
    ACE=(...)
Specifies the ACE used to select files.  The ACE matches the ACE specified in the file ACL.

When you specify this qualifier, specify at least one ACE entry. You can specify up to 64 ACE entries.  If you specify an ACE more than once, VDM counts and uses only the first reference.  If you specify more than one value, separate them with commas, and enclose the list in parentheses.

IDENTIFIER=identifier (required)
Specifies the identifier in the ACE used to select files.  You can select alphanumeric characters or binary formats.  You cannot select using wildcard characters.

When you specify this clause, specify one and only one identifier.

    ACCESS=access (required)
Specifies the access in the ACE used to select files.  Use one or more of the following keywords:

READ    the ACE allows the user to read the file
WRITE    the ACE allows the user to write the file
EXECUTE    the ACE allows the user to execute the file
DELETE    the ACE allows the user to delete the file
CONTROL    the ACE allows the user to change the file access
NONE, ""    the ACE doesn't allow the user to access the file
When you specify this qualifier, specify at least one access keyword.  You can specify up to 5 access types.  If you specify an access more than once, VDM counts and uses only the first reference.  If you specify more than one value, separate them with "+" and enclose the list in double quotes (").  VDM will select the record if the identifier has one or more of the access codes specified.  You cannot specify NONE in conjunction with any other type of access.  When you specify a list, the file will be selected if it matches one or more of the elements in the list based on the setting of the /MATCH qualifier.

EXAMPLES

$ VDM/REPORT=ACE/ACE=(IDENTIFIER=ENGR,ACCESS="READ+WRITE")
Generate a report for files with the ACE ENGR and Read or Write access in their ACL.


$ VDM/REPORT=ACE/ACE=(IDENTIFIER=ACC,ACCESS="")
Generate a report for all files with the ACE "ACC" that users with that identifier are denied access to.
/ACTIVE

  Use this qualifier to enable or disable submission of batch procedures when thresholds are exceeded.  Use it to test VDM/MONITOR on your system without altering any data.  When /NOACTIVE is specified, VDM/MONITOR does everything except actually submit the WORRY or PANIC procedures.  Log messages are written, mail messages are sent and the program performs exactly as if it is operating.  The default is /ACTIVE.  To disable procedure submission, use /NOACTIVE.  You can only use this qualifier in conjunction with the /MONITOR qualifier.

FORMAT
/MONITOR/ACTIVE
    /MONITOR/NOACTIVE

KEYWORDS
None

EXAMPLES

$ VDM/MONITOR/NOACTIVE
Stop submission of procedures. The monitor will continue to run normally.
/ALL

 This qualifier is used with the /REPORT=TRACE qualifier.  Saiga Systems uses the trace report to diagnose problems.  The report doesn't contain information useful to customers.

/ALLOCATED

 Use this qualifier to ensure that only those files matching the specified number of allocated blocks are selected.  If you omit the qualifier, allocated blocks is not used to select files.

FORMAT
    /REPORT=report-type/ALLOCATED=[-] [n] [n:m] [n:] [:m]

KEYWORDS
"-"
Specifies that all files are selected except those matching the specified allocated blocks.

[n] [n:m] [n:] [:m]
Specifies the number of allocated blocks used to select files.  The allocated blocks specifies the number of blocks allocated to the file.  Specify the allocated blocks as an integer.  An allocated value of 0 indicates the file contains no data.  The  allocated blocks matches the allocated blocks specified in the file header.

Specify n:m to select an inclusive range of allocated blocks using the relationship (i>=n AND i<=m).  Specify n to select a specific number of allocated blocks.  Specify n: to select a number of allocated blocks and all higher values.  Specify :m to select a number of allocated blocks and all lower values.

This is not a list; you must specify one and only one of the selections.

EXAMPLES

$ VDM/REPORT=SIZE/ALLOCATED=5000:
Generate a report for all files with 5,000 or more allocated blocks.


$ VDM/REPORT=SIZE/ALLOCATED=0
Generate a report for zero-length files.

/BACKUP

 Use this qualifier to select files based on the date of their most recent backup.  If you omit the qualifier, backup date is not used to select files.

You can specify only one of the following qualifiers:

        /BACKUP
        /CREATED
        /EXPIRED
        /MODIFIED

When you specify one of the above qualifiers, you must specify one or both of the following qualifiers:

        /BEFORE
        /SINCE

FORMAT
    /REPORT=report-type/BACKUP

EXAMPLES

$ VDM/REPORT=SIZE/BACKUP/BEFORE=25-FEB-1994
Generate a report of all files which not been backed up since February 25, 1994, or have never been backed up.


$ VDM/REPORT=SIZE/BACKUP/SINCE
Generate a report for all files which have been backed up today.

/BEFORE

 Use this qualifier to select only those files before the specified date.  If you omit the qualifier, date is not used to select files.

When you specify this qualifier, you must specify one of the following qualifiers:

        /BACKUP
        /CREATED
        /EXPIRED
        /MODIFIED

You can specify one or both of the following qualifiers:

        /BEFORE
        /SINCE

FORMAT
    /REPORT=report-type/BEFORE=[date | TODAY | YESTERDAY | TOMORROW]

KEYWORDS
date
Specifies the date for file selection.  Enter the date in the format "15_JUN_94".

TODAY
Specifies today's date.

YESTERDAY
Specifies yesterday's date.

TOMORROW
Specifies tomorrow's date.

EXAMPLES

$ VDM/REPORT=SIZE/EXPIRED/BEFORE=25-FEB-1994
Generate a report of all files which have expired before February 25, 1994.

$ VDM/REPORT=SIZE/BACKUP/BEFORE=TODAY
Generate a report of all files which not been backed today or have never been backed up.

/BROADCAST

  Use this qualifier to broadcast messages to users when the second free space threshold (PANIC level) is reached and the associated batch procedure is submitted. The default is /BROADCAST. To disable broadcast messages, use /NOBROADCAST.  You can only use this qualifier in conjunction with the /MONITOR qualifier.

FORMAT
/MONITOR/BROADCAST
    /MONITOR/NOBROADCAST

KEYWORDS
None

EXAMPLES

$ VDM/MONITOR/NOBROADCAST
Stop broadcasting messages to users when the panic threshold is exceeded on a disk.

/CONSOLE

  Use this qualifier to ensure that actions are logged to the system console when free space thresholds are reached and batch jobs are submitted.  The default is /CONSOLE. To stop actions from being logged, use /NOCONSOLE.  The default is /CONSOLE.  You can only use this qualifier in conjunction with the /MONITOR qualifier.

FORMAT
/MONITOR/CONSOLE
    /MONITOR/NOCONSOLE

KEYWORDS
None

EXAMPLES

$ VDM/MONITOR/NOCONSOLE
Stop the monitor's actions from being logged to the system console.


/CONVERT

  Use this qualifier to convert VDM V4.0 or V5.0 data files to V6.0 format when you upgrade to VDM V6.0. The program allows you to convert all the data files in the [VDM.DAT] directory. There were no changes to these files made with V7.0 so V4 or V5 files can be converted directly to the new format without an intermediate upgrade to V6.

FORMAT
/CONVERT

KEYWORDS
None

EXAMPLES

$ VDM/CONVERT
Converts all VDM data files from V4.0 or V5.0 to V6.0. If you have already done V6.0 data collections be sure and answer "NO" when prompted if files from those data collections should be converted.
/CREATED

 Use this qualifier to select files based on their creation date.  If you omit the qualifier, creation date is not used to select files.

You can specify only one of the following qualifiers:

        /BACKUP
        /CREATED
        /EXPIRED
        /MODIFIED

When you specify one of the above qualifiers, you must specify one or both of the following qualifiers:

        /BEFORE
        /SINCE

FORMAT
    /REPORT=report-type/CREATED

EXAMPLES

$ VDM/REPORT=SIZE/CREATED/SINCE=25-FEB-1994
Generate a report of all files which have been created since February 25, 1994


$ VDM/REPORT=SIZE/CREATED/SINCE
Generate a report for all files which were created today.

/CURRENT

  Use this qualifier to specify which file to access for the current column on the report.  If this qualifier is omitted, the date of the most recent run is used.

FORMAT
    /REPORT=report-type/CURRENT=date

KEYWORDS
date
Specifies the date of the current column on the report.  Enter the date in the format "15_JUN_94".

EXAMPLES

$ VDM/REPORT=CURRENT/CURRENT="04_JUL_94"
Generate a current report using July 4th as the current date.


$ VDM/REPORT=CAPACITY/SORT=UIC
Generate a capacity report in UIC sequence using the most recent data collection date (normally yesterday) as the current date.

/DATA_FILE

 Use this qualifier in conjunction with the /RESET and /VALUE qualifiers to ensure that to reset values in the UIC, DIR, or BOTH data files. If you omit the qualifier, BOTH is assumed

FORMAT
    /DATA_FILE=[UIC | DIR | BOTH]

KEYWORDS
UIC
Specifies that the UIC file is to have a value reset.

DIR
Specifies that the directory file is to have a value reset.

BOTH (default)
Specifies that both the UIC and directory files are to have a value reset.

EXAMPLES

$ VDM/RESET/DATA_FILE=UIC/VALUE=AVERAGE
Reset the average value in the UIC file only.


$ VDM/RESET/VALUE=AVERAGE
Reset the average value in the both the UIC file and the directory file.



/DCL

 Use this qualifier to specify a file to hold a list of files selected during a VDM operation.  Use the file in conjunction with a DCL procedure to correct the problem you located using the VDM operation.  If you omit the qualifier, a file containing the names of selected files is not generated.  You can only use this qualifier in conjunction with /REPORT=PROTECTION, /REPORT=ACE and /REPORT=SIZE.  The file is generated in your current directory.

Each record in the generated file contains the following information:

    node::device:[directory]name.type;version

in the normal OpenVMS file-spec format.

FORMAT
    /REPORT=report-type/DCL=file-spec

KEYWORDS
File-spec
Specifies the name of the file in which selected filenames are recorded.  If you omit the file-spec entirely, VDM will use the file specification "FILE_LIST.DAT" in your current directory.  You cannot specify a node name.  If you omit the device, VDM will default to your current device.  If you omit the directory, VDM will default to your current directory.  If you omit a file name, VDM will default to the file name "FILE_LIST".  If you omit a file extension, VDM will default to ".DAT".  If you want to store the file in the VDM directory, specify the logical "VDM_DAT: in front of the filename.  If VDM can't create the file, it will report an error.

EXAMPLES

$ VDM/REPORT=ACE/ACE=(IDENTIFIER=ENGR,ACCESS=READ)/DCL
Generate a report showing all files with the ACE "ENGR" in their ACL and write their names in the file FILE_LIST.DAT in the VDM directory.

$ VDM/REPORT=PROTECTION/DCL=PROTECTION_CHK/PROTECTION=W:RWED
Generate a report showing all files with any protection through WORLD and write their names in the file PROTECTION_CHK.DAT in your current directory.


/DIR_COLLECT

 Use this qualifier to collect usage information by directory.  This qualifier is used in a batch procedure which collects directory, UIC and quota information.

FORMAT
/DIR_COLLECT

KEYWORDS
None

EXAMPLES

$ VDM/DIR_COLLECT/DISK=DRA1:
Collect directory information for disk DRA1:.
/DIR_FILE

 This qualifier is used with the /REPORT=TRACE qualifier.  Saiga Systems uses the trace report to diagnose problems.  The report doesn't contain information useful to customers.

/DISK

     Use this qualifier to ensure that only those files on the specified disks are selected.  If you omit the qualifier, disk is not used to select files and all disks in the VDM data files are included for current or capacity reports; for ACE, protection and size reports only your current default disk will be reported.  If you specify a device which is not a disk, VDM will reject it with an error message.


FORMAT
    /MONITOR/DISK=DEFAULT
    /DISK=(disk-name[,...]) for Current or Capacity reports
    /DISK=disk-name for ACE, Protection or size reports
    /MONITOR/DISK=disk-name


KEYWORDS

DEFAULT
Specifies default /WORRY and /PANIC thresholds and procedures be set or updated.  

disk-name[,...]
Specifies the disk name used to select files.  The disk name is 1 through 31 alphanumeric characters.  If you omit the ":" character at the end, VDM will insert it automatically.

If you specify the qualifier without a value or omit it entirely for ACE, protection or size reports, VDM will search your current default disk.  You can specify up to 200 disk names.  If you specify a disk name more than once, VDM counts and uses only the first reference.  If you specify a logical name, VDM will translate it to a physical disk name but display the logical name you entered.  If you specify more than one disk name, separate them with commas, and enclose the list in parentheses.  When you specify a list, the disk will be selected if it matches any of the elements in the list.

When you specify volume sets, specify only the first drive of the volume.  VDM  checks all devices and will not collect data on secondary volume devices.

EXAMPLES
$ VDM/REPORT=CURRENT/SEQUENCE=DIRECTORY/DISK=(DRA1:,USER$DISK2:)
Generate a first level directory report for disk DUA1: and USER$DISK2:


$ VDM/REPORT=SIZE/DISK=DUA0:/ALLOCATED=5000:
Generate a report of all files with 5,000 or more allocated blocks on the disk DUA0:.


$ VDM/REPORT=SIZE/DISK=SYS$SYSDEVICE:/ALLOCATED=:5
Generate a report of all files with 5 or less allocated blocks on the disk with the logical name SYS$SYSDEVICE.


$ VDM/REPORT=CAPACITY
Generate a capacity report for all disks that data has been collected on.
/EVENT

 Use this qualifier to add or delete events from VDM’s monitor. The /EVENT qualifier requires an event clause. You can only use this qualifier in conjunction with the /MONITOR qualifier.

FORMAT
/MONITOR/EVENT=event_clause
    /MONITOR/NOEVENT=event_id

EVENT_CLAUSE    
The event clause consists of any valid combination of the following keywords and values.

    TYPE=event type
When adding events TYPE must be specified. It defines the event type being added  and controls which additional keywords are appropriate. The valid event types are:
        ABSENT    to check to see if a file has been deleted
        PRESENT    to check to see if a file exists
        SIZE        to monitor a files size
        CHANGE    to monitor a file and take action if it has been changed

    BLOCKS=value
Use BLOCKS to specify the number of disk blocks for a file size event. This keyword is only valid with TYPE=SIZE. If BLOCKS is omitted a file size event will added with the number of blocks specified in the default file event record.

COMMAND=file
Used COMMAND to specify the command procedure that should be submitted when a VDM monitor EVENT is true. This keyword can be used with all 4 event types. It must point to a valid DCL command procedure. Use QUEUE to specify which queue this job should be submitted to. If you specify COMMAND without a  procedure name the procedure from the default file event record will be used.

    COMPARE=comparison_type
Use COMPARE when adding file size events to specify the type of compare that should be made. The event will then make that type of comparison for the file against the number of BLOCKS specified and take action when the condition is true. Valid comparisons are:
        GREATER    take action when FILE is GREATER than x BLOCKS in size
LESS        take action when FILE is LESS than x  BLOCKS in size        
        EQUAL    take action when FILE is x BLOCKS in size
Use SIZE to control whether VDM is checking against the number of blocks allocated, used or unused by FILE.

    MESSAGES=value
Use messages to control how many times VDM’s monitor will signal an event as true and submit the action procedure. MESSAGES can be specified with all four file event types. Each subsequent time that VDM checks a file event and determines it to be true VDM will take the appropriate action until it has reached MESSAGES=nn times. If MESSAGES is omitted the value from the default file event record will be used.

NODE=node name
Use NODE when running VDM in a cluster to control which node VDM actually checks for a file event on. If your cluster is sharing a common VDM monitor data file specifying a NODE will prevent an event from being signalled on every node in the cluster when it becomes true. If you omit node the value from the default file event record will be used.

QUEUE=queue name
Use QUEUE to specify which queue a file event should submit it’s COMMAND procedure to. Be sure to specify a valid queue that will execute on an appropriate node. If you omit QUEUE the value from the default file event record will be used.

SIZE=size type
Use SIZE to control which value VDM COMPAREs BLOCKS against. Valid choices for size type are:
        ALLOCATED     total blocks allocated by a file
        USED            number of blocks used by a file
        UNUSED        the number of blocks allocated but not yet used by a file
    If you omit SIZE the size type from the default file event record will be used.

To delete a file event from the VDM monitor database use /NOFILE=filename and /EVENT=(TYPE=filetype).

EXAMPLES

$ VDM/NOFILE=DISK1:[DIR1]TMP.FIL/EVENT=(TYPE=CHANGED)
Remove the file changed event for the specified file. Any other events for this file such as size or absent file are not affected.

$ VDM /FILE=HITMAN_DAT:HITMAN_LOG_FILE.NODE1 /EVENT=(TYPE=SIZE, -
    BLOCKS=4000, SIZE=USED, COMPARE=GREATER, QUEUE=NODE1$BATCH, -
    COMMAND=HITMAN_COM:RESET_HITMAN_LOG.COM)
On node1 anytime HITMAN’s log file exceeds 4000 blocks used submit a command procedure to node1$batch that resets the log file.


$ VDM /MONITOR /FILE=SYS$MANAGER:SYSTARTUP_VMS.COM -
    /EVENT=(TYPE=CHANGED)
The VDM monitor will take it’s normal default actions for sending mail and console messages anytime it detects a change to the system startup file.

$ VDM /MONITOR /FILE=DISK1:[DIR1]FILE.DAT -
    /EVENT=(TYPE=ABSENT, MESSAGES=10, -
    QUEUE=NODE1$BATCH, NODE=NODE1, -
    COMMAND=VDM_COM:RECREATE_FILE.COM)
If DISK1:[DIR1]FILE.DAT ever gets deleted VDM’s monitor will submit a job that can recreate the file. The check is made on only node1 and if the file is not successfully created VDM will try again for up to 9 more times since subsequent checks would still show the file absent.
/EXCEPTION

 Use this qualifier to specify that the report created will be an exception report.  This means that only the users flagged as exceptions will be printed in the report.  There are three criteria by which a user can be flagged as an exception: SIZE, NEAR_QUOTA, LARGE_CHANGE.  For information on how to specify these criteria, see the information on the above qualifiers.  If you omit the qualifier, all records matching the other criteria will be printed.

FORMAT
    /REPORT=report-type/EXCEPTION


KEYWORDS
    None

EXAMPLES

$ VDM/REPORT=CURRENT/LARGE_CHANGE=24/EXCEPTION
Generate a current report that shows only the users with a change in usage greater that 24 percent or that are near their quota if disk quota information is being used.

/EXPIRED

 Use this qualifier to select files based on the expiration date.  If you omit the qualifier, expiration date is not used to select files.  The expiration date is set with the OpenVMS commands SET FILE/EXPIRATION_DATE and SET VOLUME/RETENTION.

You can specify only one of the following qualifiers:

        /BACKUP
        /CREATED
        /EXPIRED
        /MODIFIED

When you specify one of the above qualifiers, you must specify one or both of the following qualifiers:

        /BEFORE
        /SINCE

FORMAT
    /REPORT=report-type/EXPIRED

EXAMPLES

$ VDM/REPORT=SIZE/EXPIRED/SINCE=25-FEB-1994
Generate a report of all files which have expired since February 25, 1994, or are not yet expired.

$ VDM/REPORT=SIZE/EXPIRED/SINCE
Generate a report for all files which expire today or are not yet expired.

$ VDM/REPORT=SIZE/EXPIRED/SINCE/BEFORE=31-DEC-1994
Generate a report for all files which will expire between today and December 31, 1994.

/FILE

  Use this qualifier to specify the file for VDM’s file events OR to specify a file selection criteria when running interactive reports. For file events you must specify a valid file specification that contains no wildcards; as a selection criteria wildcards are fine and the portions of the specification not included will be defaulted from [*...]*.*;*.

FORMAT
    /FILE=disk:[directory]filename.type            file event usage
    /FILE=[directory]filename.type            selection criteria usage

KEYWORDS
This qualifier has no keywords. Enter a valid OpenVMS file specification or wildcarded file specification when used as a selection criteria.

EXAMPLES
    $ VDM /MONITOR /FILE=SYS$SYSTEM:SYSTARTUP_VMS.COM -
    /EVENT=(TYPE=CHANGE, NODE=THISND, MESSAGES=1, MAIL=SYSOP)
This command creates a VDM event that will send mail to SYSOP anytime VDM detects that the system startup file has been modified.

    $ VDM /MONITOR /FILE=HITMAN_DAT:HITMAN_LOG_FILE.THISND -
    /EVENT=(TYPE=SIZE, COMPARE=GREATER, BLOCKS=2500, -
    SIZE=ALLOCATED,  COMMAND=HITMAN_COM:RESET_LOG.COM,-
    QUEUE=THISND$BATCH, NODE=THISND)
This event monitors HITMAN’s log file and any time it has allocated more than 2500 blocks, submits a batch job that resets and purges the log file.

    $ VDM /REPORT=SIZE /FILE=*.LOG /DISK=DKA400:
    This command will generate a file size report for all the log files on disk dka400.

    $ VDM /REPORT=PROTECTION /FILE=[ACCOUNT...]*.*;* -
        /OUTPUT=ACC.LIS
This command will generate a file protection report for all the subdirectories and files under the account directory. /output has been added to direct the report to a file.

/FLAGS

 Use this qualifier to ensure that only those files matching the specified flags are selected.  If you omit the qualifier, flags are not used to select files.

FORMAT
    /REPORT=report-type/FLAGS=(["-",] [NO]flag[,...])

KEYWORDS
"-"
Specifies that all files are selected except those matching any specified flags.  This operator applies to the entire list, not just to the first element.  Files with no flags will be included (see /ALL).

flags[,...]
Specifies the flags used to select files.  A list of valid flags is contained in Appendix G.  Specify the absence of a flag by placing "NO" in front of the flag name.  The flags match the flags specified in the user authorization file.

When you specify this qualifier, specify at least one flag.  You can specify up to 18 flags.  If you specify a flag more than once, VDM counts and uses only the first reference.  If you specify more than one flag, separate them with commas, and enclose the list in parentheses.  When you specify a list, the account will be selected if it matches one or more of the elements in the list.

    Use /NOALL if you want to exclude files with no flags from a negated list.

EXAMPLES

$ VDM/REPORT=SIZE/FLAGS=NOBACKUP
Generate a report of all files which will not be backed up regardless of activity.


/FRAGMENTS

 Use this qualifier to ensure that only those files matching the specified number of fragments are selected.  If you omit the qualifier, file fragmentation is not used to select files.

FORMAT
    /REPORT=report-type/FRAGMENTS=[-] [n] [n:m] [n:] [:m]


KEYWORDS
"-"
Specifies that all files are selected except those matching the specified file fragmentation.  This operator applies to the entire list, not just to the first element.

[n] [n:m] [n:] [:m]
Specifies the number of fragments used to select files.  The file fragmentation is the number of separate extents assigned to the file.  Specify the file fragmentation as an integer.  The fragmentation matches the file fragmentation specified in the INDEXF.SYS.

Specify n:m to select an inclusive range of file fragmentation using the relationship (i>=n AND i<=m).  Specify n to select a specific file fragmentation.  Specify n: to select a number of file fragments and all higher values.  Specify :m to select a number of file fragments and all lower values.

This is not a list; you must specify one and only one of the selections.

EXAMPLES

$ VDM/REPORT=SIZE/FRAGMENTS=5:
Generate a report of all files with 5 or more fragments.



/INDENT

 Use this qualifier with the /REPORT=TREE qualifier to specify how many characters to indent each directory level when creating a tree.  "4" is the default.  The maximum value is 40.  The tree report shows up to 8 levels of directory.  If you omit the qualifier, /INDENT=4 is assumed.

FORMAT
    /INDENT=n

EXAMPLES

$ VDM/REPORT=TREE/INDENT=8
Generate a tree report indenting each sub-directory 8 characters.
/INTERVAL

 Use this qualifier to specify the time interval between free space and error checks for the disk drives listed. A valid time interval is between 1 minute and 60 minutes.  You can only use this qualifier in conjunction with the /MONITOR qualifier. You may, using this qualifier, set different intervals for different drives.

FORMAT
    /MONITOR/INTERVAL=number-of-minutes

KEYWORDS
number-of-minutes
Specifies the number of minutes between checks for free space and disk errors.

EXAMPLES

$ VDM/MONITOR/INTERVAL=2/DISK=(DISK1$,DISK2$)
Specifies that drives DISK1$ and DISK2$ are to be checked every two minutes.
/LARGE_CHANGE

 Use this qualifier to specify the percentage increase at which accounts will be flagged as having a "large change" from the previous total.  The default percentage is 20 percent.  Valid values are in the range 1 to 100.  If /EXCEPTION is specified with /LARGE_CHANGE then the report will contain only the users that are flagged for LARGE_CHANGE or NEAR_QUOTA.  If you omit the qualifier, 20 percent is assumed.

FORMAT
    /REPORT=CURRENT/LARGE_CHANGE=n

EXAMPLES

$ VDM/REPORT=CURRENT/DISK=DUA0:/LARGE_CHANGE=5
Generate a current report for all users with a 5% or greater increase in their usage are flagged.

$ VDM/REPORT=CURRENT/DISK=DUA0:/EXCEPTION
Generate a current report showing only users with at least a 20% increase in their usage or that are near their quota.

/LEVEL

   Use this qualifier with the /SEQUENCE=DIRECTORY or /REPORT=TREE qualifier to specify how many levels of directory to print when creating a tree report.  "2" is the default for reports generated in directory sequence and means only the top directories and 1 level of sub-directories will be printed.  The default for the tree report is to show all levels; below the current directory if /DISK is not specified or for the entire disk if you specify /DISK. The disk usage for each level "2" directory is the same as the block usage returned by the DCL command DIR/SIZE=ALL [level_1_directory...].  The directory sequence current or capacity reports can produce a report showing up to three directory levels.  The tree report shows up to 8 levels of directory.  If you omit the qualifier, /LEVEL=8 is assumed.  When you use this qualifier with the /SEQUENCE=DIRECTORY qualifier, values above 4 are assumed to be 3.

FORMAT
    /LEVEL=n

EXAMPLES

$ VDM/REPORT=CURRENT/SEQUENCE=DIRECTORY/LEVEL=2
Generate a current directory report for users showing the top two levels of directories.

$ VDM/REPORT=CURRENT/DISK=DUA0:/SEQUENCE=DIRECTORY
Generate a current directory report for users showing the only the top 2 levels of directories on disk DUA0:.

$ VDM/REPORT=TREE/DISK=DUA0:/LEVEL=5
Generate a directory tree showing five levels of directories for disk DUA0.

/LIST

 Use this qualifier to list the parameters in the VDM/MONITOR database.  This allows you to verify that the commands you have typed are being used, and find out what parameters VDM/MONITOR is actually using.  If you omit the filename, the list is sent to the screen, pausing after each disk until you press the enter key.

FORMAT
/MONITOR/LIST[=file-name]

KEYWORDS
"file-name"
The name of the file to write the output to.  If it is omitted, "SYS$OUTPUT" is assumed.

EXAMPLES

$ VDM/MONITOR/LIST=P.LIS
    List the VDM/MONITOR parameters in the file P.LIS.
/LOG

  Use this qualifier to close the VDM monitor's current log file and ensure that a new log file is opened. Actions are logged to the log file when free space thresholds are reached and batch jobs are submitted. The log file is, by default, called VDM_DAT:VDM_LOG_FILE.LOG. To change the log file name, define the system logical name VDM_LOG_FILE to be the file name you want the log file to be. For example:

    $ DEFINE/SYSTEM VDM_LOG_FILE DUA1:[FRED]PURGE_LOG.DAT

will cause the log file to be "dua1:[fred]purge_log.dat".

The /LOG qualifier closes the current log file and opens a new one.  The operator can then examine the contents of the previous log file.

The /NOLOG qualifier closes the current log file but does not open a new one.  Hence, no messages are recorded until the operator opens another log file.

There is no default for this qualifier, a new log file will be opened by VDM only if explicitly requested or each time VDM starts.

You can only use this qualifier in conjunction with the /MONITOR qualifier.

FORMAT
    /MONITOR/LOG
    /MONITOR/NOLOG

EXAMPLES

$ VDM/MONITOR/NOLOG
    Stop actions from being logged to the log file.

/MAIL

 Use this qualifier to ensure that users will be notified of impending problems using the OpenVMS MAIL utility when the monitor detects that the second threshold (PANIC) has been reached.

FORMAT
    /MONITOR/MAIL=username
    /MONITOR/MAIL=distribution-list
    /MONITOR/NOMAIL

KEYWORDS
username
Specifies the name of the user to receive the mail message.

distribution-list
Specifies the name of a text file containing the names of the users to receive the mail message. The filename must be preceded by the "@" character and the entire string enclosed in double quotes ("). The distribution file must conform to the rules for distribution files outlined in the OpenVMS Mail utility manual.

EXAMPLES

$ VDM/MONITOR/MAIL=SYSTEM
Send a mail message to user SYSTEM when the PANIC threshold is reached.

$ VDM/MONITOR/MAIL="@OPER.DIS"
Send mail messages to all users in the file OPER.DIS when the PANIC threshold is reached.
/MATCH

   Use this qualifier to specify the logical operation to be used when more than one entry is specified in a list of selection criteria.  Use this qualifier in conjunction with /PROTECTION or /ACE.  The normal AND relationship still applies between multiple qualifiers.

FORMAT
    /PROTECTION=(...)/MATCH=[OR | AND]

KEYWORDS
OR (Default)
Specifies that the logical operation "OR" is to used when more than one entry is specified.  If any of the entries are present, the file will be selected.

AND
Specifies that the logical operation "AND" is to used when more than one entry is specified.  All of the entries must be present for the file to be selected.

For protection, this qualifier applies within a protection class.  If more than one protection class is specified, an AND relationship is assumed.

    If you specify OR, you cannot specify AND and vice-versa.

EXAMPLES

$ VDM/REPORT=PROTECTION/PROTECTION=OWNER:RW
Generate a report of files whose owners have either Read or Write access using default /MATCH value of "OR".

$ VDM/REPORT=PROTECTION/PROTECTION=SYSTEM:RW/MATCH=AND
Generate a report of files where system has both Read and Write access.

$ VDM /REPORT=ACE /ACE=(IDENT=ENGR,ACCESS="READ+WRITE+DELETE") -
    /MATCH=AND
Generate a report showing files which the ENGR identifier provides read, write and delete access to.

/MAXIMUM

 Use this qualifier with the /REPORT=CAPACITY qualifier to specify a maximum value for the rate of change if you request a report where it is automatically calculated.  The default is +25 if you omit the qualifier.  Valid values are in the range of _99999.9 and +99999.9.  This qualifier cannot be used with the /RATE qualifier.  

FORMAT
    /REPORT=CAPACITY/MAXIMUM=n

EXAMPLES

$ VDM/REPORT=CAPACITY/PREVIOUS=28_FEB_94/MAXIMUM=5
Generate a capacity report with a maximum growth rate of 5%.


$ VDM/REPORT=CAPACITY/PREVIOUS=28_FEB_94
Generate a capacity report with a default maximum growth rate of 25%.

/MINIMUM

 Use this qualifier with the /REPORT=CAPACITY qualifier to specify a minimum value for the rate of change if you request a report where it is automatically calculated.  The default is -25 if you omit the qualifier.  Valid values are in the range of _99999.9 and +99999.9.  This qualifier cannot be used with the /RATE qualifier.  

FORMAT
    /REPORT=CAPACITY/MINIMUM=n

EXAMPLES

$ VDM/REPORT=CAPACITY/PREVIOUS=28_FEB_94/MAXIMUM=8/MINIMUM=5
Generate a capacity report with a minimum growth rate of 5% and a maximum of 8%.


$ VDM/REPORT=CAPACITY/PREVIOUS=28_FEB_94
Generate a capacity report with a minimum growth rate of -25%.

/MODIFIED

 Use this qualifier to select files based on their modification date.  If you omit the qualifier, modification date is not used to select files.

You can specify only one of the following qualifiers:

        /BACKUP
        /CREATED
        /EXPIRED
        /MODIFIED

When you specify one of the above qualifiers, you must specify one or both of the following qualifiers:

        /BEFORE
        /SINCE

FORMAT
    /REPORT=report-type/MODIFIED

EXAMPLES

$ VDM/REPORT=SIZE/MODIFIED/SINCE=25-FEB-1994
Generate a report of all files which have been modified since February 25, 1994

$ VDM/REPORT=SIZE/MODIFIED/SINCE
Generate a report for all files which have been modified today.

$ VDM/REPORT=SIZE/MODIFIED/BEFORE=1-JAN-94
Generate a report for all files which have not been modified this year (1994).
/MONITOR

 Use this qualifier to monitor your disk for low free space and device errors.

This qualifier should always be used with one or more of the qualifiers for using and maintaining VDM's monitor.
    /ACTIVE
    /BROADCAST
    /CONSOLE
    /DISK
    /EVENT
    /FILE
    /INTERVAL
    /LOG
    /LIST
    /MAIL
    /PANIC
    /START
    /STATUS
    /STOP
    /WORRY

FORMAT
/MONITOR

KEYWORDS
None