next up previous contents index
Next: SNAP Output Up: Results Data Previous: TRANSP Input Files

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
deletes the file P12345.ABC;1 in RES$W:[TFTR.BR.USER]. If a file of the same name also exists in RES$W:[TFTR.BR], it is not be deleted. If you had used BR_ALL instead of RES$W: [TFTR.BR.USER], both files would be deleted.


next up previous contents index
Next: SNAP Output Up: Results Data Previous: TRANSP Input Files

Marilee Thompson
Fri Jul 11 11:22:04 EDT 1997