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