mirror of
https://github.com/PDP-10/stacken.git
synced 2026-01-27 20:27:27 +00:00
220 lines
8.2 KiB
Plaintext
220 lines
8.2 KiB
Plaintext
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.
|