Replaces run-time-dependent information with constants in a
   specified file. You can use Digital Test Manager filters on Digital
   Test Manager files and other ASCII files.

   Format

     FILTER  file-specification [/qualifier...]

1  –  Restrictions

   o  The FILTER command is for use with noninteractive and terminal
      tests only.

2  –  Command Qualifiers

2.1    /ALL

   Specifies that all the filters be run on the specified file.

2.2    /DATE

   Where the date form is abbreviated, the date filter replaces date
   stamps by substituting a "d" for each displayed number of the day
   of the month, an "m" for each displayed letter of the month, and
   a "y" for each displayed number of the year. Where the date form
   is spelled out, the month name is replaced by "month", the numeric
   day is replaced by "day", and the year is replaced by "year".

   The following list shows some examples of the date filtering
   functions; this list is not all inclusive.

     17-OCT-1998 with dd-mmm-yyyy
     17 OCT 98 with dd mmm yy
     98.OCT.17 with yy.mmm.dd
     10/17/98 with mm/dd/yy
     1998/10/17 with yyyy/mm/dd
     October 17, 1998 with month day, year
     Oct. 17, 1998 with month day, year
     17.October.1998 with day.month.year
     98-October-17 with year-month-day

2.3    /DIRECTORIES

   Replaces the directory specification field in the file
   specification with DISK:[DIRECTORY].

2.4    /FILE_NAMES

   Replaces the file names with FILENAME.EXT.

2.5    /LOG

   /LOG (D)
   /NOLOG

   Controls whether Digital Test Manager displays informational and
   success messages on your screen.

2.6    /TIME

   Replaces time stamps with the following forms:

     15:37:53.22 with hh:mm:ss.xxxx
     15:37:53 with hh:mm:ss
     15:37 with hh:mm
     3:37 PM with hh:mm xm
     15H37m with hhHmmm
     15H37' with hhHmm'
     15.37 h with hh.mm h
     15 h 37"53 s with hh h mm"ss s
     15 h 37 min with hh h mm min
     kl 15.37 with kl hh.mm
     h 15.37 with h hh.mm

2.7    /TRACE_BACK

   Replaces 32-bit memory addresses with xxxxxxxx and
   64-bit memory addresses with xxxxxxxx xxxxxxxx.

2.8    /USER_FILTER

   /USER_FILTER=filename
   /USER_FILTER=(filename[,...])
   /NOUSER_FILTER (D)

   The specified files are executed by DEC Text Processing Utility
   (DECTPU). If more than one file is specified they are executed in
   the order given. The user filters are applied before any
   built-in filters that are also specified on the command line.

   User filter files can be located either in OpenVMS directories or in
   Code Management System (CMS) libraries. Files may be
   specified using logical names including logical names that specify
   search lists. Wildcards cannot be used. For files in CMS libraries,
   the most recent generation on the main line of descent is used.

   Before the first file is executed the file to be filtered is read
   into the DECTPU buffer "filter_buffer". Next, the file specified by
   the logical name DTM$UFDEFINES is executed. The system logical name
   DTM$UFDEFINES references the file SYS$LIBRARY:DTM$UFDEFINES.TPU,
   which contains definitions of a global replace procedure and
   patterns which can be used in building filters. This logical can be
   redefined to point to a custom file.

   Any errors in accessing the user filter files or in executing the
   DECTPU commands will be reported. However, they will not cause the
   FILTER command to fail, and any remaining user and built-in filters
   will be applied.

   After all the user filters have been applied, the file being
   filtered will be written out. If any built-in filters are also
   specified, they are applied to the newly created file, resulting in
   a second new version.

2.9    /VERSION

   Replaces file versions with VERSION.

3  –  Example

   DTM> FILTER/ALL DUA0:[USER01.DTMLIB]FILTER.BMK
   %DTM-S-FILTERED, expression successfully filtered
   DTM>

   This example runs the six standard filters on the file
   FILTER.BMK.