Using NS3000/iX Network Services (36920-90008)

Chapter 3 47
Remote File Access
FILE Command
FILE Command
Specifies a formal designator that may be used to represent a remote
file or device in a subsequent command or intrinsic. (Also known as a
file equation.)
Syntax
[=*formaldesignator ]
[=$NEWPASS ]
[=$OLDPASS ]
FILE formaldesignator [=$STDIN ]
[=$STDINX ]
[=$STDLIST ]
[=filereferenc[:nodespec]{,filedomain]]
[;DEV=[[envname]#][device][,outpri][,numcopies]]
[;VTERM]
[;ENV=envfile[:nodespec]]
[;option] . . .
Use
Available In Session? Yes
In Job? Yes
In Break? Yes
Programmatically? Yes
Breakable? No
Capabilities? None
Parameters
formaldesignator A name in the form file[.group[.account]][:nodespec]
that can be used to identify the file in a subsequent
command or intrinsic call. (For the meaning of nodespec,
see the next parameter explanation. MPE/iX currently
permits this extended formal designator, with a node
specification following a colon, in the FILE and RESET
commands, and in the FOPEN intrinsic.) If not equated
to another file designator, the formaldesignator contains
the actual name of a file. A *formaldesignator (with the
asterisk) is a “backreference” to a formal designator
defined in a previous FILE command.
nodespec Either an environment ID (specified in a previous
DSLINE or REMOTE command) or $BACK. This node
specification may appear in the file’s formal designator
or as an extension of an actual file reference. If an
environment ID appears in a file designation and in the
DEV= option, the attempt to open the file (for example,
via FOPEN) will result in an error.