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)
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)

Note that AcuServer may not be used for sort files with the SORT-DIR 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
XFD-DIRECTORY   @host3:/usr3/dictionaries

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)
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)

keyboard input file	(-i runtime option)
keystroke playback file	(-k runtime option)
display output file	(-o runtime option)
debug input file	(-r runtime option)