Trailing-Edge
-
PDP-10 Archives
-
BB-F494Z-DD_1986
-
10,7/path.hlp
There are 7 other files named path.hlp in the archive. Click here to see a list.
1.0 DEFAULT PATH COMMANDS:
.PATH [newpath]/switches
-or-
.PATH =name:/switches
where "newpath" is the desired default path, "name" is a
(path-defined) logical name, and "switches" may be one or more of the
following:
/SCAN Enable scanning.
/NOSCAN Disable scanning.
/SYS Enable auto search of [1,4].
/NOSYS Disable auto search of [1,4].
/NEW Enable auto search of [1,5].
/NONEW Disable auto search of [1,5].
/UP:n Ascend n levels of SFDs.
/DOWN:list Append the list of SFDs to the current path.
The effect of the /UP and /DOWN switches may also be obtained using
the following command form:
.PATH ascenders descenders switches
where "switches" can be any of the switches listed above, "ascenders"
is as many "<" characters as SFD levels you wish to ascend, and
"descenders" is a ">" character followed by a list of SFDs to append
to your path (after the effect of the ascenders, if any). Legal
separators in the SFD list in the "descenders" field are: ",", ".",
and ">".
2.0 SEARCH LIST COMMANDS:
(System search list commands require that your job be privileged)
.PATH/switches
where "switches" may be one or more of the following:
/ADD:list Add the structures specified by list to the job search
list.
/REMOVE:list Remove the structures specified by list from the job
search list.
/CREATE:list Create a new job search list consisting of those
structures in list.
/MODIFY:list Modify the structures in the job search list as
specified by list.
/SADD:list Add the structures specified by list to the system
search list.
/SREMOVE:list Remove the structures specified by list from the
system search list.
/SCREATE:list Create a new system search list consisting of those
structures in list.
/SMODIFY:list Modify the structures in the system search list as
specified by list.
The same search list switch may appear more than once in a command but
the effect is the same as if the user had specified all the structures
in one switch. ADD, REMOVE, and MODIFY switches may appear together
in any combination, but CREATE may not be combined with any of the
above switches. Regardless of the position of the REMOVE, ADD, and
MODIFY switches, PATH will always process them in the order given
above. PATH does not set the search list once for each switch.
Instead, it starts with the search list at the time the program was
run, removes the structures specified by the REMOVE switches, adds the
structures specified by the ADD switches, and finally modifies any
structures specified by the MODIFY switches. This means that the ADD
switches may add structures added by the REMOVE switches and the
MODIFY switches may not find a structure removed with REMOVE. The
argument to the search list switches is an ordered list of elements
which represent the structures on which to act. If more that one
element is specified, they must be enclosed in parenthesis and
separated by commas. Each element has the form:
name:modifier:modifier...
where name is the name of a structure (e.g., DSKB), an abbreviation
for a structure name (e.g., DS), or an asterisk (*). PATH interprets
an asterisk to mean the search list at the time the program was run
minus any structures from the current search list that were explicitly
given in the switch. The structure modifiers may be one or more of
the following:
WRITE Write enable the specified structure
NOWRITE Write lock the specified structure
CREATE Allow file creation on the specified structure when DSK:
is specified in an OPEN.
NOCREATE Allow file creation on the specified structure only if
it's name is explicitly given in an OPEN.
3.0 LOGICAL PATH NAME COMMANDS:
.PATH name:/switches=dev:file.ext[path],dev:file.ext[path],...
where "name" is the name of a logical path name and each
"dev:file.ext[path]" are the components of that logical name. If the
device of a logical path name component has an implied PPN or is
itself a logical name, PATH will ignore any directory specified by the
user and substitute the implied ppn or the body of the logical path
name in its place. In the latter case, any filename or extension
specified in the component being defined are overwritten by the
filename or extension from the substituted body of the logical path
name. The filename or extension are not overwritten if there is no
corresponding field in the substituted body or if the /OVERRIDE switch
was specified in the definition of the logical path name being
substituted.
If the component of a logical path name is defined using "[,]",
"[,pn]", or "[p,]", PATH does not substitute the current login PPN
when defining the logical path name. Instead, the monitor does the
substitution at the time of the use of the logical path name. In
general, this is not a problem, unless the user's PPN changes between
the definition of the logical path name and the use of it. To
indicate that a logical path name was defined in this manner, PATH
will list the path of each component of a logical path name in exactly
the same way that it was defined.
If no components are specified to the right of the equal sign, the
definition of the existing logical name will be deleted.
"Switches" may be one of the following:
/SEARCH - Enable auto search of the components of this logical
name if no file is found on a LOOKUP/enter to generic
device DSK:. (This is similar to the SETSRC /LIB
attribute although they are implemented differently
so that the old SETSRC /LIB attribute operates
consistently with previous monitors). The /SEARCH
attribute may apply to only one logical path name and
implicitly deletes the SETSRC /LIB definition, if
any.
/NOSEARCH - Remove the above attribute.
/OVERRIDE - If this logical name is specified to OPEN a channel
and a LOOKUP, ENTER, etc. is done that specifies a
filename or extension, ignore the filename and
extension in the LOOKUP, ENTER, etc. block and use
the values from the logical name component. In
addition, this switch controls the way that path
substitutes logical name bodies during the definition
of a logical names as described above.
/NOOVERRIDE - Remove the above attribute.
An existing logical name may have the SEARCH or OVERRIDE attribute
changed with the following command:
.PATH name:/[NO]switch
The following switch alters the definition of logical path names but
may not appear in conjunction with any other logical name command or
switch:
/CLEAR - Clear all logical name definitions.
4.0 LISTING PATHS, SEARCH LISTS, AND LOGICAL PATH NAMES:
The following switches may be placed anywhere on the command line or
in SWITCH.INI:
/LIST:CHANGE List only those things changed in the current command.
/LIST:PATH List the default path, path switches, and the SETSRC
style /LIB setting (default).
/LIST:JSL List the job search list.
/LIST:SSL List the system search list.
/LIST:NAMES List the logical path name definitions.
/LIST:ALL List all of the above.
/LIST Same as /LIST:CHANGE. (Exception: .PATH and
.PATH/LIST are treated as .PATH/LIST:PATH).
/NOLIST Don't list anything.
Any of the above PATH functions may be combined in the same command
string (with the exceptions specifically noted above). Note that PATH
uses SCAN to interpret the command string so that all SCAN defaults
with regard to "sticky" devices and PPNs apply.