Trailing-Edge
-
PDP-10 Archives
-
BB-PBDEB-BB_1990
-
10,7/setsrc/setsrc.hlp
There are 9 other files named setsrc.hlp in the archive. Click here to see a list.
Setting Search Lists Using SETSRC
Function
You can use the SETSRC program to change your job search list or the
system search list. You must be logged in under [1,2] to create a new
system search list. A search list is the order of the file structures
that are to be searched whenever you implicitly or explicitly specify
the generic device DSK:. The system manager originally defines the
search list to include the file structures that you can access. With
the SETSRC program, you can alter the search list by adding or
deleting file structures.
The search list is of the form:
fs1:, fs2:, fs3:, FENCE, fs4:
where: fs is the name of the file structure.
The file structures on the left of the FENCE form the active search
list and represent the generic device DSK: for your job. The active
search list is a list of the file structures that the monitor
searches, and the order in which the file structures are to be
searched. The search goes from left to right.
The files to the right of the FENCE compose the passive search list
and represent the file structures that were once in the active search
list. File structures are kept in the passive search list so that
quotas can be checked on a DISMOUNT or KJOB command; these structures
are not searched. The FENCE is the boundary between the active and
passive search lists.
You can change the job's search list by adding or deleting file
structures, using the MOUNT and DISMOUNT commands. Because the SETSRC
program does not create a UFD if one does not exist, use the MOUNT
command to create a UFD. See the help files for MOUNT and DISMOUNT
for a description of the commands.
Format
R SETSRC
*command/switch
When the program prompt (*) appears, you can respond with any of the
following commands:
Command Function
A fs1, fs2,... Adds one or more file structures to the existing
active search list. The file structures (with any
switches) are appended to the beginning or the end
of the active search list according to the
following specifications:
o If no asterisk appears in the specifications
(for example, fs1, fs2) or if an asterisk
appears before the file structure names (for
example, *,fs1, fs2), the file structures are
added to the end of the search list.
o If an asterisk follows the file structure
names (for example, fs1, fs2, *,), the file
structures are added to the beginning of the
search list.
o If the asterisk appears in the middle of the
file structures (for example, fs1, *, fs2),
the file structures before the asterisk are
added to the beginning of the search list and
the file structures after the asterisk are
added to the end.
C fs1,fs2,... Creates a new search list for this job. Any file
structures in the current search list that are not
in the new list are moved to the passive search
list.
CP[dir] Creates a new default directory path. You must
specify the new path with this command.
CS fs1,fs2,... Creates a new system search list (that is, the
file structure search list for device SYS:). You
must be logged in under [1,2] to use this command.
H Prints information (HELP) about the available
commands.
M/switch Modifies the current search list and DSK:
specification by altering the switch settings for
individual file structures. This command does not
add or remove file structures from the search
list.
R fs1,fs2,... Removes file structures from the search list.
They are placed into the passive search list, so
that on subsequent LOGOUTs or DISMOUNTs, quota
limits can be checked. This command does not
affect ersatz devices.
T Prints the job search list.
TP Prints the default directory path.
TS Prints the system search list.
You can use the following switches in the SETSRC command string.
Switches that modify file structures must appear immediately after the
file structure name that they modify. Other switches can appear
anywhere in the command string. The switches can be abbreviated as
long as the abbreviation is unique.
Switch Function
/CREATE Allows new files to be created on the file
structure. This is the default.
/LIB:[proj,prog] Used with the C or M command only, /LIB sets the
job's library directory to the UFD [proj,prog] and
adds it to your DSK: specification. This means
that if a file is not found in your directories in
your search list, the library directory will then
be searched for the file. If you only type
LIB:[PPN] to SETSRC, it interprets this as M/LIB.
/NEW Adds the directory [1,5] to your SYS:
specification. This means that when the system
directory is searched, the directory [1,5] will be
searched before the directory [1,4]. This switch
can be typed in directly as a command by omitting
the C or M command and the slash (NEW is
equivalent to M/NEW).
/NOCREATE Does not allow new files to be created on the file
structure when you specify DSK:, but allows files
to be superseded. Files can be created on the
file structure if you specify the file structure
name explicitly. You may specify this switch as
/N.
/NOLIB Removes the library directory from your DSK:
specification. This switch is only valid with the
C or M command.
/NONEW Removes the [1,5] directory from your SYS:
specification. This switch is only valid with the
C or M command.
/NOSCAN Cancels the scan switch for the directory path.
You can use this switch only with the CP command.
If you type NOSCAN at the prompt, SETSRC
interprets it as CP[dir]/NOSCAN.
/NOSYS Removes the SYS: specification from your DSK:
specification. This switch is only valid with the
C or M command.
/NOWRITE Does not allow writing on the file structure for
this job (that is, the file structure is
read-only). You may specify this switch as /R.
/SCAN Sets the scan switch for the directory path. When
you search for a file, scanning allows the search
to include higher-level SFDs and the UFD. You can
use this switch only with the CP command. If you
type SCAN at the prompt, SETSRC interprets it as
CP[dir]/SCAN.
/SYS Adds the SYS: specification to your DSK:
specification. If a file cannot be found in your
directories in your search list or in your library
directory (if /LIB:[proj,prog] has been
specified), the system directory [1,4] will then
be searched for the file. This switch can be
typed in directly as a command by omitting the C
or M command and the slash. For example, SYS is
equivalent to M/SYS.
/WRITE Allows writing on the file structure. This is the
default.
Characteristics
The SETSRC program:
Places your terminal at user level.
Destroys your core image.
Example
Your search list is defined as DSKB:.
.R SETSRC<RET>
*T<RET>
*DSKB:, FENCE
Add DSKA: to the end of the search list.
*A DSKA:<RET>
Your search list is now defined as DSKB:,DSKA:.
*T<RET>
DSKB:,DSKA:,FENCE
Add DSKC: to the beginning of the search list.
*A DSKC:,*<RET>
*T<RET>
DSKC:,DSKB:,DSKA:,FENCE
Remove DSKA: from the search list.
*R DSKA:<RET>
*T<RET>
DSKC:,DSKB:,FENCE,DSKA:
Disable writing on DSKB:.
*M DSKB:/NOWRITE<RET>
Set your library directory to [27,500] and add it to your DSK:
specification.
*M/LIB:[27,500]<RET>
Add SYS: to your search list.
*SYS<RET>
*T<RET>
/LIB:[27,500]/SYS DSKC:,DSKB:/NOWRITE,FENCE,DSKA:
Your DSK: and SYS: specifications are listed first, followed by your
search list.
*TS<RET>
The system search list is defined as DSKA:,DSKB:,DSKC:.
*DSKA:,DSKB:,DSKC:
.