DIR

CMS Commands

dir.helpcmd.txt
/*    DIR fn|* [ft|* [fm|*]] [( NAME|TYPE|MODE|FORMAT|SIZE|DATE [)]]                              */
DIR                                                       CMS User Area command

Use the DIR command to obtain specified information about CMS files residing on
accessed disks.  The format of the DIR command is:
+----------+------------------------------------------------------------------+
| DIR      | [fn|* [ft|* [ft|*]]] [(options...[)]]                            |
|          |                                                                  |
|          | options:                                                         |
|          |    NAME|TYPE|MODE|FORMAT|SIZE|DATE                               |
+----------+------------------------------------------------------------------+
where:

fn       is the filename of the files for which information is to be collected.
         If an asterisk is coded in this field, all filenames are used.  If you
         code an asterisk preceded by any number of characters, then files that
         begin with the specified characters are listed.

fn       is the filetype of the files for which information is to be collected.
         If an asterisk is coded in this field, all filetypes are used.  If you
         code an asterisk preceded by any number of characters, then files that
         begin with the specified characters are listed.

fm       is the filemode of the files for which information is to be collected.
         If this field is omitted, only the A-disk is searched.  If an asterisk
         is coded, all accessed disks are searched.

Options:

NAME     the output is sorted by filename.

TYPE     the output is sorted by filetype.

MODE     the output is sorted by filemode.

FORMAT   the output is sorted by record format.

SIZE     the output is sorted by the number of blocks in each file, smallest to
         largest.

DATE     the output is sorted by the date of the files, oldest to newest.


Usage notes:

1.  The DIR command calls the LISTFILE command.

Responses:

The requested information is displayed at the terminal:
Filename Filetype Fm  Format    Recs Blocks    Date     Time   Label
fn       ft       fm  f lrecl norecs noblks  mm/dd/yy   hh:mm  volid
n files, nn blocks: nn,nnn bytes.

where:
   fn        is the filename of the file.
   ft        is the filetype of the file.
   fm        is the filemode of the file.
   f         is the file format: F is fixed-length, V is variable-length.
   lrecl     is the logical record length of the largest record in the file.
   norecs    is the number of logical records in the file.
   noblks    is the number of CMS data blocks that the file occupies on disk.
   mm/dd/yy  is the date (month/day/year) that the file was last updated.
   hh:mm     is the time (hours:minutes) that the file was last updated.
   volid     is the volume serial number of the virtual disk on which the file
             resides.
One entry is displayed for each file listed.  The summary line totals the
displayed files.