McIDAS-X User's Guide
Version 2023.1

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]


REDIRECT

Writes the LW file path redirection memory block.


Formats

REDIRECT ADD file "path
REDIRECT CLEAR type
REDIRECT DELETE file
REDIRECT LIST type
REDIRECT MAKE
REDIRECT REST
rfile
REDIRECT SAVE rfile


Parameters

ADD

adds a redirection entry to the file LWPATH.NAM and dynamic memory

CLEAR

clears the redirection entries

DELETE

deletes a redirection entry from dynamic memory and the file LWPATH.NAM

LIST

lists the file redirection entries

MAKE

writes the redirection entries from LWPATH.NAM into dynamic memory (default)

REST

restores a saved redirection file into file LWPATH.NAM and dynamic memory

SAVE

saves the redirection entries to a file

file

file name, e.g., MDXX3074, AREA011* ; 12 characters maximum including the extension; if you include an extension, it must be three or less characters (use a wildcard to match extensions longer than three characters)

"path

desired directory path, 59 characters maximum; the double quote is mandatory

type

FILE

the file LWPATH.NAM

 

MEM

dynamic memory (default for the LIST option)

 

ALL

both LWPATH.NAM and dynamic memory; use with the CLEAR option only (default for CLEAR)

rfile

redirection file name; if an extension is not specified, .NAM is automatically appended


Remarks

File redirection is used to define which directories McIDAS commands search when looking for specified data and help files. When a command requests data from a file (for example, when IMGLIST displays image data from the file AREA0001), the active redirect table is checked to see if one of its entries has a matching file name. If so, the command searches for the file in the directory specified in the entry.

The active redirect table resides in memory. You can create multiple redirect files, which can be individually restored to the active redirect table. Redirect files are created with a text editor or with the command REDIRECT ADD. Redirect files consist of one or more entries, each containing a file name and a directory or path. The entry's file name can contain wild card characters (for example, A*, AREA*, MDXX05*, *.GIF). Lines beginning with a double quote (") are comments (for example, "This is a comment). Comments can only be added with a text editor; not with REDIRECT ADD. Redirect files cannot contain blank lines.

The maximum length of an entry is 72 characters, 12 for the file name and 60 for the directory. The 60th character can only be a slash (/).

If your workstation is hung and you suspect file redirection is causing it, first exit McIDAS, then delete the file LWPATH.NAM and boot the system. This file is located in the $HOME/mcidas/data or another MCPATH directory.

Caution!
It is safest to redirect only data files, for example, areas and MD files. Do not redirect the source file specified with the DOSTOLW command or the destination file specified with the LWTODOS command. Redirecting McIDAS system files may cause problems.
Some of the systems files you should NOT redirect are listed below.
ALLOC.WWW FRNVEXP.nnn STRTABLE
CONTEXT.SLT LWPATH.NAM SYSIMAGE.PM
EXPORT.nnn MCRGB.TXT TERMCHAR.nnn
FRAMED.nnn MENU UCTERM.nnn
FRAMENH.nnn NUM.FRM VERSION.TXT
FRNV.nnn SKEDFILE WINQUFIL
FRNVDIR.001 STARTUP.SYS  

Examples

REDIRECT

This entry places the redirected files and paths from the active redirection file (LWPATH.NAM) into dynamic memory.

REDIRECT LIST FILE

This entry lists the redirection entries in the file LWPATH.NAM.

REDIRECT CLEAR

This entry clears the file LWPATH.NAM and dynamic memory.

REDIRECT ADD AREA137* "/u/smith/volume/mcidas/AREAS

This example adds the redirection path /u/smith/volume/mcidas/AREAS/AREA137* to dynamic memory and the file LWPATH.NAM.

REDIRECT REST TSTVL1

This entry brings the file TSTVL1.NAM into dynamic memory and the redirection file LWPATH.NAM.

REDIRECT ADD AREA* "/u/johndoe/mcidas/areas

REDIRECT ADD GRID8* "/u/johndoe/mcidas/gridfiles

REDIRECT ADD MDXX1000 "/u/johndoe/mcidas/mdfiles

REDIRECT ADD *.ET "/u/johndoe/mcidas/enhancements

REDIRECT SAVE DATA.NAM

REDIRECT REST DATA.NAM

These entries create redirect entries in the active redirect table and then saves the table as the file DATA.NAM. The last entry makes the file the active redirect table so it can be used.

To create the same DATA.NAM redirect file using a text editor, enter the lines below in DATA.NAM and save the file.

AREA*  /u/johndoe/mcidas/areas
GRID8*  /u/johndoe/mcidas/gridfiles
MDXX1000  /u/johndoe/mcidas/mdfiles
*.ET  /u/johndoe/mcidas/enhancements

To use the file once it has been created, restore it to the active redirect table by running the command REDIRECT REST DATA.NAM.


[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]