User`s guide

A Sample Control File
The following control file restores files backed up into savesets on tape. This file
illustrates the complexity of control files. The list following the example explains
some of this file’s contents. To create, use, and execute control files, see the RT–11
IND Control Files Manual.
.;
1
RESALL.COM
.; Restores all files from all savesets on a tape.
.;
2
.ASKS string Input device?
$ASSIGN
3
’string’
4
BUD
5
$LOAD ’string’
.ASKS string Output device?
$ASSIGN ’string’ OUT
.SETS REWSWT "REWIND" .; Start with a rewind
.100:
6
$BACKUP/RESTORE/LOG/NOQUERY/’REWSWT’ BUD:/SAVESET OUT:
.SETS REWSWT "NOREWIND"
.IF <EXSTAT>
7
LT <ERROR> .GOTO 100
;?RESALL-I-BACKUP exit status warrants termination of procedure.
8
.EXIT
1
The period-semicolon combination (.;) specifies an internal comment. Anything
on the line after them is comments for the programmer only and is not displayed
when the COM file is run.
2
The period-command combination (for example, .ASKS, .SETS, .IF, and .EXIT)
specifies an IND directive or command.
3
The dollar sign ($) followed by a DCL command specifies that command line
is DCL. The dollar sign is optional, allowing an easy way for you to instantly
identify a DCL command in a control file.
The IND processor forwards any line that does not begin with a period or a
semicolon to KMON to interpret; and KMON disregards an initial dollar sign in
a command line.
4
The ’string’ specifies user input that the string will represent when the COM
file is run.
5
BUD is a logical device name meaning Back-Up Device.
6
A label is an alphanumeric string preceded by a period and followed by a colon
(.100:). Labels are local symbols specifying places in the control file so that the
indicated lines can be referenced by an IND directive.
7
<EXSTAT> and <ERROR> are IND special numeric symbols. This section of the
example code means that if a saveset is successfully backed up and the tape does
not rewind, then the next saveset is backed up.
8
A line beginning with a semicolon specifies an external comment, which is
displayed when control file is run.
How to Use DCL Commands 1–15