Trailing-Edge
-
PDP-10 Archives
-
BB-PBDEB-BB_1990
-
10,7/system/alloca.hlp
There are 11 other files named alloca.hlp in the archive. Click here to see a list.
ALLOCATE Command
Function
The ALLOCATE command informs the system that you will need a
resource. A resource is a tape or disk unit. With ALLOCATE, you
can reserve a resource from the system and assign a logical name
to the resource you will use.
An allocated resource can contain all the specifications
necessary when the resource is mounted. The switches that you
specify with the ALLOCATE command will be retained and applied
when you use the MOUNT command to mount the same resource.
The ALLOCATE command allocates a resource, and the SHOW
ALLOCATION display will show such a resource as both allocated
and mounted. If you use the ALLOCATE command to explicitly
allocate a resource, you will be granted extended ownership over
the resource. For example, if a resource that you have
explicitly allocated and mounted goes off-line unexpectedly (as
when the operator dismounts it), your mount request for that
resource will be automatically requeued, and the resource will be
mounted for your job when it comes on line.
Format
ALLOCATE resource:log-name/switch/switch...
Where: resource is the name of the resource that is to be
allocated. The colon (:) in the resource name is
optional. The resource name is one of the following:
o A disk structure or volume set name, such as DSKB:.
o A tape volume set name and volume identifiers, such
as PAY-WK(PM34,PM35) where PAY-WK is the volume set
name, and (PM34,PM35) is a list of the volumes in
the volume set.
o A tape volume identifier of a single-tape volume
set.
o The logical name previously associated with a
resource.
o A physical device name.
Note that a tape allocation request requires a volume
identification. If you do not include the volume set
name followed by volume identifiers, you must supply
the /VOLID switch.
log-name is the logical name you can assign to the
resource that you will use. The logical name can be up
to 6 alphanumeric characters. A tape volume set must
always have a logical name. If you do not specify a
logical name for a tape volume set, the system defaults
to the first six characters of the volume set name, or
up to the first non-alphanumeric character of the
volume set name. A disk volume set does not require a
logical-name.
To allocate more than one volume set, separate the
volume set identifications with commas.
/switches are always preceded by a slash. Some
switches can be used for any kind of volume set; others
are restricted to either tape or disk volume sets only.
NOTE
The logical name and switches that you specify
in the ALLOCATE command string are saved by the
system, and are applied when you MOUNT the
volume set.
You can obtain a list of the resources that are allocated and
mounted for your job by typing ALLOCATE with no arguments or
switches. The output is the same as the output from the SHOW
ALLOCATION command.
The following is a list of the switches you can use with
ALLOCATE. The center column lists the kind of resource(s) the
switch applies to.
Switch Device Function
/ACTIVE Disk Requests that the volume set be placed
in your job's active search list when
the structure is mounted. See SETSRC in
the TOPS-10 User Utilities Manual. The
structure will become part of the list
that the system automatically uses to
search for a file. This is the default.
Complement to /PASSIVE.
/CHECK Tape Prints a list of all the allocation
Disk requests for your job. Same as ALLOCATE
with no arguments or switches.
/CREATE Disk Allows files to be created on this
structure. This switch is the
complement to /NOCREATE and implies the
/ACTIVE switch.
/DENSITY:n-BPI Tape Specifies the recording density in bits
per inch of the volume set. The density
(n) can be: 200, 556, 800, 1600, or
6250. The -BPI portion of the value is
optional.
/DISK Disk Identifies the volume set as a disk
volume set.
/EXCLUSIVE Disk Ensures that you will have exclusive
access to the resource. No other users
will be allowed to access the resource.
You must have the same project number as
the owner of the volume set.
/HELP Tape Prints a brief description of the
Disk command.
/LABEL-TYPE:arg Tape Specifies the kind of label processing
to be used and indicates the label
status of the tape. The arguments and
their meanings are:
ANSI The label is formatted
according to ANSI standards.
BLP The tape may or may not have
BYPASS labels, but it is treated as
if it were unlabeled. Only
privileged users can use this
switch.
EBCDIC The label is formatted in
IBM EBCDIC.
USER-EOT The tape does not have
standard labels. However, you
will be informed at the end of
tape. Volume switching (for
multivolume tape volume sets)
will not be performed
automatically. Therefore, the
user program is responsible
for mounting subsequent tapes.
This is useful for programs
that create unique labels,
such as BACKUP.
UNLABELED The tape is not labeled. When
NONE a new tape is mounted from the
NOLABELS same volume set, you will not
be notified. The switching of
tapes in the volume set will
be handled automatically by
the system. You will not be
informed when the end of tape
is reached.
/NEW-VOLUME-SET Tape Specifies that a new volume set is going
to be created. The operator will choose
tapes for your job from a pool of
available tapes. This switch implies
/WRITE-ENABLE.
/NOCREATE Disk Prevents the creation of files on this
volume set, unless you specify the
volume set when you write the file.
This switch is the complement to /CREATE
and it implies /ACTIVE.
/NONOTIFY Tape Does not inform you when the resource is
Disk mounted or dismounted.
/NOTIFY Tape Sets the system to inform you when the
Disk resource is mounted or dismounted. The
system sends a message to your terminal
when any of the following occurs:
o The resource is physically mounted.
o The resource is dismounted by the
operator without a request by your
job.
o Another volume in a tape volume set
is mounted.
o The disk structure is locked or
unlocked by the operator.
/PASSIVE Disk Requests that the structure be placed in
your job's passive search list. Refer
to SETSRC program. The system will not
search for files in the structure unless
you specify the structure name in the
file specification. This switch is the
complement to /ACTIVE.
/QUOTA Disk Removed.
/READ-ONLY Tape Specifies that you will not write on the
Disk volume set. Tape volume sets will be
checked as they are mounted, to ensure
that they are write-locked. This is the
default for tape volume sets.
On disk volume sets, the monitor will
not update access dates. If you specify
both /EXCLUSIVE and /READ-ONLY, the
operator may write-lock the structure.
/REMARK:"text" Tape Allows you to send a message to the
Disk operator identifying the volume to be
mounted. The argument (text) can be up
to 50 characters long. Use quotation
marks around the text if it contains
spaces or punctuation marks.
/SCRATCH Tape Instructs the operator to mount a
scratch tape. By implication, a scratch
tape will be returned to the system's
pool of available tapes, after you are
finished with it. This switch implies
/WRITE-ENABLE.
/SHARABLE Disk Allows other users to access the
resource. This is the default function.
This switch is the complement to
/EXCLUSIVE.
/TAPE Tape Specifies that the volume set is a tape
volume set. This switch is required
when the volume set has the same name as
a catalogued disk volume set.
/TRACKS:n Tape Specifies the number of tracks on the
tape. The value n can be 7 or 9.
/VOLID:volid Tape Identifies the volumes in a tape volume
set. This switch can be used only if
the volid-list was not specified
previously. If the volume set is
comprised of more than one volume, the
volids should be separated by commas,
and the volid-list should be enclosed in
parentheses.
/WRITE-ENABLE Tape Ensures that you can write on the
Disk volume set. For tape, the system checks
each volume as it is mounted to be sure
that it is write-enabled. This is the
default for disk volume sets.
*Associated Commands*
MOUNT Makes a device available to you.
DISMOUNT Removes the specified volume set from your job's
search list. Dismounts the volume set if you
have exclusive access to it.
DEALLOCATE Removes the specified resources(s) from your
job's list of allocated resources.
SHOW ALLOCATION Prints a list of the resources that are
allocated and mounted for your job.
SHOW QUEUE Prints a list of system queues.
CANCEL Cancels a mount or queue request.
Characteristics
Runs the QUEUE program.
Destroys your core image.
Requires LOGIN.
Example
The following example shows the use of the ALLOCATE, DEALLOCATE,
MOUNT, DISMOUNT, and SHOW ALLOCATION commands. The resources are
reserved for a multivolume tape volume set with the ALLOCATE
command. The name of the volume set is TAPE-SET, and it contains
three volumes. The logical name TS is assigned to the tape set.
The tape is write enabled, and it does not have standard labels.
.ALLOCATE TAPE-SET(VOL1,VOL2,VOL3):TS/WRITE-ENABLE/LABEL:NONE<RET>
[ALLOCATE REQUEST TS QUEUED, REQUEST #672]
A file structure named DSKR: is mounted for the job:
.MOUNT DSKR:<RET>
[MOUNT REQUEST DSKR QUEUED, REQUEST #673]
[STRUCTURE DSKR MOUNTED]
The job's resources are shown using the SHOW ALLOCATION command:
.SHOW ALLOCATION<RET>
ALLOCATION FOR JOB 59 MARY MAROTTA [27,5434]
VOLUME SET RESOURCES TYPE ALL OWN
---------------- ----------------- ------------ --- ---
--- 9 TK 800/1600 MAGTAPE UNIT 1 0
--- RP06 DISK UNIT 2 2
--- RP20 DISK UNIT 1 1
DSKB DSKB STRUCTURE 1 1
DSKC DSKC STRUCTURE 1 1
DSKR DSKR STRUCTURE 1 1
TAPE-SET VOL1 MAGTAPE VOL. 1 0
TAPE-SET VOL2 MAGTAPE VOL. 1 0
TAPE-SET VOL3 MAGTAPE VOL. 1 0
The tape set is mounted, and the resources are again displayed:
.MOUNT TS<RET>
[MOUNT REQUEST TS QUEUED, REQUEST #673]
[MAGTAPE TS MOUNTED]
.SHOW ALLOCATION<RET>
ALLOCATION FOR JOB 59 MARY MAROTTA [27,5434]
VOLUME SET RESOURCES TYPE ALL OWN
---------------- ----------------- ------------ --- ---
--- 9TK 800/1600 MAGTAPE UNIT 1 1
--- RP06 DISK UNIT 2 2
--- RP20 DISK UNIT 1 1
DSKB DSKB STRUCTURE 1 1
DSKC DSKC STRUCTURE 1 1
DSKR DSKR STRUCTURE 1 1
TAPE-SET VOL1 MAGTAPE VOL. 1 1
TAPE-SET VOL2 MAGTAPE VOL. 1 0
TAPE-SET VOL3 MAGTAPE VOL. 1 0
After work is finished by accessing the tape set and the
structure, the structure is dismounted. Because the structure
was not explicitly allocated, it is automatically deallocated:
.DISMOUNT DSKR<RET>
[STRUCTURE DSKR DISMOUNTED]
The tape volume set is dismounted:
.DISMOUNT TS<RET>
[VOLUME SET TS DISMOUNTED]
The job's resources are displayed:
.SHOW ALLOCATION<RET>
ALLOCATION FOR JOB 59 MARY MAROTTA [27,5434]
VOLUME SET RESOURCES TYPE ALL OWN
---------------- ----------------- ------------ --- ---
--- 9 TK 800/1600 MAGTAPE UNIT 1 0
--- RP06 DISK UNIT 1 1
--- RP20 DISK UNIT 1 1
DSKB DSKB STRUCTURE 1 1
DSKC DSKC STRUCTURE 1 1
TAPE-SET VOL1 MAGTAPE VOL. 1 0
TAPE-SET VOL2 MAGTAPE VOL. 1 0
TAPE-SET VOL3 MAGTAPE VOL. 1 0
At this point, the tape set can again be mounted, or it can be
deallocated. The tape set is dismounted:
.DEALLOCATE TS<RET>
[VOLUME SET TS HAS BEEN DEALLOCATED]
.SHOW ALLOCATION<RET>
ALLOCATION FOR JOB 59 MARY MAROTTA [27,5434]
VOLUME SET RESOURCES TYPE ALL OWN
---------------- ----------------- ------------ --- ---
--- RP06 DISK UNIT 1 1
--- RP20 DISK UNIT 1 1
DSKB DSKB STRUCTURE 1 1
DSKC DSKC STRUCTURE 1 1
.