Find Results Files

$ DIRECTORY (The VMS command)

can be used to display results files in the cache only. The first example shows how to get a directory of .ECE files in [TFTR.YM] and [TFTR.YM.USER]. The second example shows how to get a directory of all files in [TFTR.YM.USER] only.

    $ DIR YM_ALL:*.ECM
    $ DIR RES$:[TFTR.YM.USER]

The preferred disk specification is RES$, which refers to the entire results disk cache. RES$W is just the write cache, and RES$R is just the read cache.

$ RESDIR

  displays a directory of all results  files: files on the magnetic cache and on the optical disks. The optical disk directory also includes the platter and the date and time the file was archived. You must specify the directory and the file name. Wildcards are allowed in the file name only. The command is $ RESDIR filespec. Examples are:

    $ RESDIR [TFTR.BR]S42811.BE2,S42797.BE2
      Platter   D  Date      Time        Filename
      P05A      F  20-OCT-89 23:26:16    S42811.BE2
      1 file found in [TFTR.BR].
      Platter   D  Date      Time        Filename
      P07A      F  19-OCT-89 23:37:12    S42797.BE2
      1 file found in [TFTR.BR].

    $ RESDIR YS_ALL:T42%%%.*,[TFTR.YG]*.ECE,*.ABC

If you do not find a file with RESDIR or the above directory commands, then the file does not exist on the results disks.

$ RESGET

   copies files from the optical disks to the magnetic disks. Wildcards are allowed in the file name, but not in the directory name. The command is $ RESGET filespec. Although most programs will automatically access the optical disks, there may be times when you want to copy several files in advance. Examples are:

    $ RESGET  [TFTR.BR]S42811.BE2,S42797.BE2
    $ RESGET YS_ALL:T42%%%.*,[TFTR.YG]*.ECE,*.ABC
    $ RESGET  TR_DISK:[MCCUNE]*.T1T

$ RESGETW

  is the same as RESGET except that it waits for each file to be restored before proceeding to the next file in the list.

$ OPREAD

  also copies data from the optical disks . The command is $ OPREAD filespec [platter] /[NO]WAIT. The platter, which can be gotten with RESDIR, is required if wildcards are used in the file specification. OPREAD does not support the device logical names, like YS_ALL, as RESGET does, however, it may be faster if you are retrieving lots of files with a wildcard specification. For example to retrieve files with a wildcard specification:

    $ OPREAD [TFTR.BR]S42797.* P07A

or to retrieve a single file:

    $ OPREAD [TFTR.BR]S42797.BE2 /NOWAIT

Note /WAIT, which is the default, causes OPREAD to wait until the request has been completed before exiting. /NOWAIT causes OPREAD to issue the request and then return control back to the user. Sometime later the request will completed. It is not necessary to use OPREAD if the program you are using to access the data knows how to retrieve from the optical system (e.g. all programs accessing waveforms and Ufiles).

$ OPSTATUS

  lists files that are queued for restoring from or archiving to the optical disks.

    $ OPSTATUS/LIST         list files queued for restore
    $ OPSTATUS/SAVE/LIST    list files queued for archive

Other qualifiers are:

    /USER=username /USER=* /SAVE /CANCEL /CONFIRM

OPREAD and OPSTATUS are maintained by Tina Ludescher. More information is available in $ HELP JUKEBOX.

You may not want to use the di_ALL search list directory specification when deleting files. The following command:

     $ DELETE RES$W:[TFTR.BR.USER]P12345.ABC;1