contents.gifindex.gifprev1.gifnext1.gif

9.1.3 Remote name notation on the command line
and in the configuration file

Most files that can be named on the command line or defined in the runtime configuration file can be specified with remote name notation. There are two general exceptions:

1. If you are redirecting standard input or standard output to a file, the file cannot have remote name notation.

2. If you are using an indexed file system other than Vision, those indexed files cannot have remote name notation.

Files that can have remote name notation include:

   configuration files   (-c runtime option)

   error files                (-e runtime option)

   object file libraries  (-y runtime option)

   object files               (specified on runtime command line 
                                      or DEFAULT-PROGRAM configuration
                                      variable or CODE-PREFIX
                                      configuration variable)

   hot-key programs    (HOT-KEY configuration variable)

   sort directory           (SORT-DIR configuration variable)

   data files                  (FILE-PREFIX configuration variable
                                      or name aliases in the configuration
                                      file or specified in the program)

   log files                    (LOG-FILE and filename-LOG
                                     configuration variables)

   log directory            (LOG-DIR configuration variable)

   xfd directory            (XFD-DIRECTORY configuration variable)

Files that cannot have remote name notation include:

   keyboard input file            (-i runtime option)

   keystroke playback file    (-k runtime option)

   display output file              (-o runtime option)

   debug input file                  (-r runtime option)

Below is an example of a runtime command line that uses remote name notation to specify some of its runtime files:

runcbl -c @host1:/usr1/config/cblconfig
   -e @host2:/usr2/errors/err.out
   @host3:/usr3/objects/sample.obj 

The following are example definitions for runtime configuration variables that can have remote name notation.

CODE-PREFIX @host3:/usr3/objects

DEFAULT-PROGRAM @host3:/usr3/objects/sample.obj

FILE-PREFIX @host3:/usr3/data

HOT-KEY "@host3:/usr3/objects/sample.obj"=100,200

LOG-DIR @host3:/usr3/log

LOG-FILE @host3:/usr3/log/log.out

SORT-DIR @host3:/usr3/temp

XFD-DIRECTORY @host3:/usr3/dictionaries