RSTS/E Commands
---------------
ALLOCATE
The ALLOCATE command reserves a physical device for your use during the current session and optionally establishes a logical name for the device. Once a device has been allocated, other users cannot access the device until you specifically deallocate it or log out. You can allocate a device only when it is not allocated by another job.
Format
ALLOCATE device-name[:] [logical-name[:]]
Prompts
Device: device-name
See also: ASSIGN, DEALLOCATE
APPEND
The APPEND command adds the contents of one or more files to the end of the file you specify. APPEND is similar in syntax and function to the COPY command.
Format
APPEND [node::]input-file-spec[,...] [node::]output-file-spec
Command Qualifiers Defaults
/[NO]LOG /LOG
/[NO]QUERY /NOQUERY
Prompts
From: input-file-spec[,...]
To: output-file-spec
See also: COPY
ASSIGN
The ASSIGN command lets you relate a logical name to a directory or to a physical device. The names you ASSIGN stay in effect until you log out, or log into another account or until you DEASSIGN the name.
Format
ASSIGN device-name:[[ppn]] logical-name[:]
Prompts
Device: device-name:[[ppn]]
Logical name: logical-name[:]
BASIC
The BASIC command invokes the BASIC-PLUS or BASIC-PLUS-2 programming environment, depending on the qualifiers you use and the system's default. It also prepares RSTS/E for the development of BASIC programs.
Format
BASIC
Command Qualifiers Comments
/BP2 Invokes the BASIC-PLUS-2
programming environment
/BPLUS Invokes the BASIC-PLUS
programming environment
All subsequent commands are interpreted as BASIC programming commands, until you type the following command to return to the DCL keyboard
monitor: DCL <ret>
CCL
Format
CCL ccl-command
The Concise Command Language (CCL) allows you to enter a command name rather than type RUN and a program name.
You can type CCL commands directly after DCL's dollar prompt ($). The format of the CCL command is defined by your system manager. For details about the use of a CCL command, refer to the documentation written for your site.
When you are using the DCL Keyboard Monitor, DCL commands take precedence over CCL commands. If your system manager gives a CCL command the same name as a DCL command, you must type the prefix "CCL" a space, and the CCL command itself.
For example, a CCL command name "DIRECTORY" and the DCL command "DIRECTORY" may produce different results depending on how the CCL command works at your site. To use the CCL version, type:
$ CCL DIRECTORY <ret>
COBOL
The COBOL command compiles a COBOL-81 program. (Only one source file at a time can be compiled with COBOL-81.)
Format:
COBOL file-spec
Qualifiers Defaults
/[NO]ANSI_FORMAT
/[NO]CHECK
/[NO]CROSS_REFERENCE
/LIST[=listfile] /NOLIST
/NOLIST
/[NO]MAP
/NAMES=aa @ /NAMES=SC
/OBJECT[t<bjfile] /OBJECT
/NOOBJECT
Prompts
File: file-spec
See also: LINK
COPY
The COPY command duplicates one or more existing files. You can use COPY to:
- copy one file to another file
- merge (concatenate) more than one file into a single file
- copy a group of files to another group of files
Format
COPY [node::]input-file-spec[,...] [node::]output-file-spec
Qualifiers Defaults
/ALLOCATION=n
/[NO]CONTIGUOUS (N)
/[NO]LOG (N) /LOG
/[NO]OVERLAY /NOOVERLAY
/PROTECTION=n
/[NO]QUERY (N) /NOQUERY
/[NO]REPLACE (N) /NOREPLACE
(N) denotes a qualifier that you can use in network operations.
Prompts
From: input-file-spec[,...]
To: output-file-spec
CREATE
The CREATE command allows you to enter text and save it as a file.
Format
CREATE file-spec
Prompts
File: file-spec
Once you have entered the file-spec, press RETURN and you may start typing text. Press <CTRL/Z> when you have finished entering text.
Command Qualifiers
/ALLOCATION=n
/[NO]CONTIGUOUS
/PROTECTION=n
/[NO]REPLACE
See also: EDIT
DEALLOCATE
The DEALLOCATE command releases a device that you reserved for private use, so that other users may have access to it. (However, DEALLOCATE does not deassign any logical name you may have set up for the device.)
Format
DEALLOCATE device-name[:]
Command Qualifiers Defaults
/ALL none
Prompts
Device: device-name[:]
See also: ALLOCATE
DEASSIGN
The DEASSIGN command cancels logical name assignments you made with
the ASSIGN or ALLOCATE commands.
Format
DEASSIGN [logical-name[:]]
Command Qualifiers Defaults
/ALL
Prompts
Logical name: logical-name[:]
See also: ASSIGN, DEALLOCATE
DELETE/ENTRY
The DELETE/ENTRY command deletes jobs from the queue that have not yet begun processing or jobs that are currently being processed.
Format
DELETE/ENTRY=job-number [queue-name[:]]
Command Qualifiers Defaults
/BATCH
Prompts
Queue: queue-name[:]
If you do not specify a queue name, LP0: is assumed.
See also: PRINT, SUBMIT, DELETE/JOB, SET QUEUE/ENTRY
DELETE/JOB
The DELETE/JOB command uses the name of a job to cancel a request
to the print or batch queue.
Format
DELETE/JOB=job-name [queue-name[:]]
Command Qualifiers Defaults
/BATCH
For example, if you decide after you make your print request that you do not want a hard copy of the file after all, you can use the
DELETE/JOB command to withdraw your request. (If the file is printed before you enter the DELETE/JOB command, your request is too late. However, it works if your file is in the middle of printing: the file stops printing.)
See also: PRINT, SUBMIT, DELETE/ENTRY, SET QUEUE/JOB
DELETE
The DELETE command permanently removes a file from your account.
Format
DELETE [node::]file-spec[,...]
Command Qualifiers Defaults
/BEFORE=date
/CREATED /CREATED
/[NO]LOG /LOG
/MODIFIED
/[NO]QUERY /NOQUERY
/SINCE=date
Prompts
File: [node::]file-spec[,...]
DIBOL
The DIBOL command compiles a DIBOL-11 to six source file specifications o be compiled into a single object file with the DIBOL compiler.
Format
DIBOL filespec[,...]
File Qualifiers Defaults
/LIST[=listfile] /NOLIST
/NOLIST
/OBJECT[=objfile] /OBJECT
/NOOBJECT
/WARNINGS /WARNINGS
/NOWARNINGS
See also: LINK
DIFFERENCES
The DIFFERENCES command compares two files and lists any sections of text that differ between the two files.
Format
DIFFERENCES input-file-spec compare-file-spec
Command Qualifiers Defaults
/IGNORE=BLANKLINES
/MATCH=size /MATCH=3
/MAXIMUM_DIFFERENCES=n
/OUTPUT[=file-spec]
Prompts:
File 1: input-file-spec
File 2: compare-file-spec
DIRECTORY
The DIRECTORY command displays information about files. Use the TYPE command to display the contents of individual files.
Format
DIRECTORY [node::][file-spec[,...]]
Command Qualifiers Defaults
/BEFORE=date
/BRIEF /BRIEF
/CREATED /CREATED
/DATE[=CREATED] /NODATE
[=MODIFIED]
[=ALL]
/NODATE
/FULL /BRIEF
/MODIFIED /CREATED
/OUTPUT=outfile
/[NO]PROTECTION /PROTECTION
/SINCE=date
/SIZE[=ALLOCATION] /SIZE=USED
[=USED]
/NOSIZE
/TOTAL
DISMOUNT
Releases a disk or tape previously accessed with a MOUNT command. You issue this command before you take the drive off line, or before you physically dismount the tape or disk.
The DISMOUNT command deallocates the device if it was allocated to you. (On some systems, dismounting a disk requires privileges.) You cannot DISMOUNT a device if there are open files on it. If you try, RSTS/E displays the message:
?Account or device in use
Format
DISMOUNT device-name[:] [label]
Prompts
Device: device-name[:]
See also: MOUNT, DEALLOCATE
EDIT
The EDIT command starts the EDT editor program, which lets you create and edit text files.
Format
EDIT file-spec
Command Qualifiers Defaults
/COMMAND[=file-spec] /COMMAND=EDTINI.EDT
/NOCOMMAND /COMMAND=EDTINI.EDT
/JOURNAL[=file-spec] /JOURNAL
/NOJOURNAL /JOURNAL
/OUTPUT[=outfile] /OUTPUT
/NOOUTPUT /OUTPUT
/[NO]READ_ONLY /NOREAD_ONLY
/[NO]RECOVER /NORECOVER
/EDT /EDT
Prompts
File: file-spec
FORTRAN
The FORTRAN command compiles up to six FORTRAN source files into a single object file.
6 There are three FORTRAN compilers available on RSTS/E:
Command Invokes
FORTRAN/FOR FORTRAN-IV
FORTRAN/F4P FORTRAN-IV-PLUS
FORTRAN/F77 FORTRAN-77
FORTRAN/F77 is the default, unless your system manager has changed it. Qualifiers which you may use with FORTRAN-IV are as follows:
Format
FORTRAN/FOR file-spec[,...]
Command Qualifiers
xCODE:EAE
EIS
FIS
THR
/[NO]D_LINES
/[NO]I4
/[NO]LINENUMBERS
/LIST[=listfile]
/NOLIST
/[NO]MACHINE_CODE
/OBJECT[=objfile]
/NOOBJECT
/[NO]OPTIMIZE
/[NO]WARNINGS
Qualifiers which you may use with FORTRAN-IV-PLUS or FORTRAN-77
are as follows:
Format
FORTRAN/F4P file-spec[,...] or FORTRAN/F77 file-spec[,...]
Command Qualifiers Defaults
/[NO]CHECK /CHECK
/CONTINUATIONS=n /CONTINUATIONS=19
/[NO]D_LINES /NOD_LINES
/[NO]I4 /NO14
/LIST[=listfile] /NOLIST
/NOLIST
/[NO]MACHINE_CODE /NOMACHINE_CODE
/OBJECT[=objfile] /OBJECT
/NOOBJECT
/[NO]WARNINGS /WARNINGS
/WORK_FILES=n /WORK_FILES=2
Prompts
File: file-spec[,...]
See also: LINK
HELP
Help can be obtained on a particular topic by typing:
HELP topic subtopic subsubtopic
A topic can have the following format:
1) An alphanumeric string (e.g. a command name, option, etc.)
2) Same preceded by a "/"
3) The match-all symbol "*"
Example:
HELP COPY
The RSTS/E DCL User's Guide contains a complete description of all DCL commands supported on RSTS/E.
INITIALIZE
Deletes any data on a tape and writes a new label.
The INITIALIZE command allocates the tape drive if it is not already allocated.
Format
INITIALIZE device-name[:] [label]
Qualifiers
/FORMAT=ANSI
/FORMAT=DOS
/DENSITY=nnn
Prompts
Device: magtape[:]
Label: [label]
See also: MOUNT, DISMOUNT
LINK
The LINK command links together object files to produce an executable program. You can also specify an overlay structure for the program.
Format
LINK file-spec[,...]
Language Qualifiers Comments
Only one of the following may be specified:
/BASIC or /BP2 BASIC-PLUS-2
/COBOL or /C81 COBOL-81
/DIBOL
/F4P FORTRAN-IV-PLUS
/F77 FORTRAN-77
/FORTRAN FORTRAN-IV
/RT11 MACRO/RT11
If no language qualifier is specified, /BASIC (for BASIC-PLUS-2) is assumed, unless your system manager has changed the default.
Additional
Command Qualifiers Defaults
/EXECUTABLE[=file-spec] /EXECUTABLE
/NOEXECUTABLE
/[NO]FMS /NOFMS
/MAP[=file-spec] /NOMAP
/NOMAP
/STRUCTURE
/[NO]DMS /NODMS
Prompts
Files: file-spec
If /STRUCTURE was specified, you will be prompted for the names of the input files and overlay structure to use, e.g.,
ROOT files: file-spec[,...]
Root PSECTs: [PSECT-name[,...]]
Overlay: [file-spec[,...][+]]
You can specify /STRUCTURE if the program is written in BASIC-PLUS-2, DIBOL, FORTRAN-IV-PLUS, or FORTRAN-77. You cannot specify /STRUCTURE if the program is written in COBOL, FORTRAN-IV, or MACRO/RT11.
See also: COBOL, DIBOL, BASIC, MACRO, FORTRAN
LOGOUT
The LOGOUT command ends your session at the terminal.
Format
[LO]GOUT
Command Qualifiers
/BRIEF
/FULL (default)
If you include the /BRIEF qualifier after the LOGOUT command, RSTS/E ends your session at the terminal without displaying a message. If you inclue the /FULL, or simply type LOGOUT, RSTS/E displays information about the status of your account.
MACRO
Invokes a MACRO-11 assembler. You can include up to six file specifications with the MACRO command.
On RSTS/E you can use either MACRO/RT11 or MACRO/RSX11. The default is MACRO/RSX11 unless your system manager has changed it.
Format
MACRO/RT11 filespec[,...]
OR
MACRO/RSX11 filespec[,...]
Command Qualifiers
/LIST[=listfile]
/NOLIST
/OBJECT[=objfile]
/NOOBJECT
File Qualifiers
/LIBRARY
See also: LINK
MOUNT
The MOUNT command prepares a tape or disk for processing by system commands or user programs. (You do not always have to MOUNT a tape before using it.) On some systems, mounting a disk requires privilege.
Format
MOUNT device-name[:] [label]
Command Qualifiers Defaults
/[NO]WRITE /WRITE
Qualifiers for Tapes Defaults
/FORMAT=ANSI
/FORMAT=DOS
/FORMAT=FOREIGN
/DENSITY=nnn
Prompts
Device: device-name[:]
Label: volume-label
See also: DISMOUNT, INITIALIZE, ALLOCATE
PRINT
The PRINT command queues a file for printing, either on a default system printer or on a device you specify. A queue is the list of files to be printed.
Format
PRINT file-spec[,...]
Command Qualifiers Defaults
/AFTER=date-time
/FORMS=type /FORMS=NORMAL
/JOB_COUNT=n /JOB_COUNT=1
/NAME=job-name
/PRIORITY=n
/QUEUE=queue-name[:] /QUEUE=LP0:
File Qualifiers Defaults
/COPIES=n /COPIES=1
/[NO]DELETE /NODELETE
Prompts
File: file-spec[,...]
See also: DELETE/JOB, SET QUEUE/JOB
RENAME
The RENAME command changes the file name or file type of an existing file.
Format
RENAME old-file-spec[,...] new-file-spec
Qualifiers Defaults
/[NO]LOG /LOG
/[NO]QUERY /NOQUERY
/[NO]REPLACE /NOREPLACE
/PROTECTION=n /PROTECTION=60
Prompts
From: input-file-spec[,...]
To: output-file-spec
See also: COPY, DELETE
REQUEST
The REQUEST command displays a message at a system operator's terminal.
Format
REQUEST message-text
When you use the REQUEST command to send a message to an operator, the message is displayed at the operator services console.
RUN
The RUN command runs an executable file.
Format
RUN file-spec
Prompts
Program: file-spec
SET HOST
The SET HOST command lets you log into another computer from the system you first logged into.
Format
SET HOST node[::]
Prompts
Node: node-name
SET PROTECTION
The SET PROTECTION command specifies the protection code of a file. You assign a protection code to determine who else, if anyone, can have access to your files.
Format
SET PROTECTION[=n] [file-spec,...]
Qualifiers
/DEFAULT
/[NO]QUERY
/[NO]LOG
Prompts
Protection code: n
Files: file-spec
X If you use SET PROTECTION/DEFAULT, RSTS/E assigns the protection code you specify to all files you create during the current session. However, do not include a file specification when you use the /DEFAULT qualifier.
SET QUEUE/ENTRY
The SET QUEUE/ENTRY command changes the status of a file that is queued for printing or for batch job execution but is not yet processed by the system.
Format
SET QUEUE/ENTRY=sequence-number [queue-name[:]]
Additional
Command Qualifiers Defaults
/AFTER=date-time none
/BATCH
/FORMS=type
/HOLD
/JOB_COUNT=n
/PRIORITY=n
/RELEASE
If you do not specify a queue name, MP0: is assumed.
See also: DELETE/ENTRY, SET QUEUE/JOB
SET QUEUE/JOB
The SET QUEUE/JOB command uses the name of a job to modify the status of a file that is queued for a printer or batch queue.
Format
SET QUEUE/JOB=job-name [queue-name[:]]
Command Qualifiers Defaults
/AFTER=date-time None.
/BATCH
/FORMS=type
/HOLD
/JOB_COUNT=n
/PRIORITY=n
/RELEASE
When you submit a batch job or issue the PRINT command, the job is assigned a name, according to the first input file specification or the name you specify. You can use this name to modify the status of the job in the queue.
See also: DELETE/JOB, SET QUEUE/ENTRY
SET TERMINAL
The SET TERMINAL command lets you specify the characteristics of your terminal. Privileged users can also set the characteristics of other terminals.
Format
SET TERMINAL [device-name[:]]
Command Qualifiers Defaults
/[NO]BROADCAST /NOBROADCAST
/CRFILL[=n] /CRFILL=0
/[NO]ECHO /ECHO
/[NO]HARDCOPY
/LA34
/LA36
/LA38
/LA120
/[NO]LOWERCASE
/PARITY=EVEN /NOPARITY
ODD
/NOPARITY
/[NO]SCOPE
/SPEED=n
/SPEED=(i,o)
/[NO]TAB /NOTAB
/[NO]TTSYNC /TTSYNC
/[NO]UPPERCASE
/VT05
/VT52
/VT55
/VT100
/WIDTH=n
See also: SHOW TERMINAL
SHOW DEVICES
The SHOW DEVICES command displays the status of devices that have disks mounted on them or that are allocated to jobs.
See also: MOUNT, ALLOCATE
SHOW QUEUE
The SHOW/QUEUE command displays a list of entries in the printer and/or batch job queues.
Format
SHOW QUEUE [queue-name[:]]
Command Qualifiers
/BATCH
/BRIEF
Queue: queue-name[:]
To display the queue of your system's default printer, type:
$ SHOW QUEUE
If there are no files in the queue, RSTS/E prints a message similar to:
LP0 queue is empty
SHOW NETWORK
The SHOW NETWORK command displays the systems you can connect to by the network. If the network is operational, RSTS/E displays the names of different nodes that your system can access.
Format
SHOW NETWORK
See also: SET HOST
SHOW SYSTEM
The SHOW SYSTEM command displays information about use of the system's resources. Specifically, it displays information about the status of all jobs, attached and detached, in use on the system.
Format
SHOW SYSTEM
The only difference between SHOW SYSTEM and SHOW USERS is that the SHOW SYSTEM command includes information about the status of detached jobs.
See also: SHOW USERS
SHOW TERMINAL
The SHOW TERMINAL command displays the characteristics of your terminal. Most of these characteristicscan be changed with a corresponding option of the SET TERMINAL command. (Users with privileged accounts can display the characteristics of other terminals.)
Format
SHOW TERMINAL [device-name[:]]
See also: SET TERMINAL
SHOW USERS
The SHOW USERS command displays information about the status of attached jobs on the system.
Format
SHOW USERS
See also: SHOW SYSTEM
SUBMIT
The SUBMIT command enters one or more control files for batch processing.
Format
SUBMIT file-spec[,...]
Command Qualifiers Defaults
/AFTER=date-time
/NAME=job-name
/PRIORITY=n /PRIORITY=128
/QUEUE=quename
File Qualifiers Defaults
/[NO]DELETE /NODELETE
Prompts
File: file-spec[,...]
See also: DELETE/JOB, SET QUEUE/JOB
TYPE
The TYPE command displays the contents of a text file (as opposed to a binary or temporary file).
Format
TYPE [node::]file-spec[,...]
Command Qualifiers Defaults
/OUTPUT=file-spec /OUTPUT=KB:
/[NO]QUERY /NOQUERY
Prompts
File: file-spec[,...]
To temporarily halt the display of a file, use <CTRL/S>. To resume output where it was interrupted, use <CTRL/Q>. (On a VT100 terminal you can also press the NO SCROLL key to stop and restart output.)
To suppress the display but continue command processing, use <CTRL/O>. If you press <CTRL/O> again before processing is completed, output resumes at the current point in command processing.
To stop command execution entirely, press <CTRL/C>. The use of <CTRL/C> returns you to DCL command level.
See also: COPY
RSTS
Help can be obtained on a particular topic by typing:
HELP topic subtopic subsubtopic ...
A topic can have the following format:
1) an alphanumeric string (e.g., a command name, option, etc.)
2) same preceded by a "/" (=> interpreted as a switch)
3) the match-all symbol "*"
Examples:
HELP DIRECTORY /S
HELP SET STALL
Abbreviations result in all matches being displayed.
Additional information is available on:
/OUTPUT /PROMPT
ADVANCED ASSIGN ATTACH BASIC
BYE DCL DEASSIGN DISMOUNT
DIRECTORY EXIT FILENAMES FIT
HELP HELLO KEYBOARD LOGIN
MOUNT PIP QUE REASSIGN
RT11 RSX RUN SET
SWITCH SYSTAT TECO TYPE
VTEDIT
TUCoPS is optimized to look best in Firefox® on a widescreen monitor (1440x900 or better).
Site design & layout copyright © 1986-2024 AOH
