.MACRO .99999 .MCALL .MODULE .MODULE HLPTXT,VERSION=37,COMMENT= ; Copyright (c) 1998 by Mentec, Inc., Nashua, NH. ; All rights reserved ; ; This software is furnished under a license for use only on a ; single computer system and may be copied only with the ; inclusion of the above copyright notice. This software, or ; any other copies thereof, may not be provided or otherwise ; made available to any other person except for use on such ; system and to one who agrees to these license terms. Title ; to and ownership of the software shall at all times remain ; in Mentec, Inc. ; ; The information in this document is subject to change without ; notice and should not be construed as a commitment by Digital ; Equipment Corporation, or Mentec, Inc. ; ; Digital and Mentec assume no responsibility for the use or ; reliability of its software on equipment which is not supplied ; by Digital or Mentec, and listed in the Software Product ; Description. ; ; 036 Came on 5.6 sources ; 037 Tim Shoppa, 24-Dec-1996 ; Update references to years in dates, now that either ; 2-digit or 4-digit forms are acceptable in Y2K compliant RT-11 .ENDM .MACRO ABORT ABORT Terminates, from the system console, a Foreground job (or system job) which does not have .SCCA in effect. SYNTAX ABORT logical-job-name SEMANTICS Logical-job-name is the (up to) six character logical name assigned to the Foreground/System Job. Console is the system console terminal. OPTIONS None EXAMPLES ABORT QUEUE ABORT F .ENDM .MACRO ASSIGN ASSIGN Associates a logical device name with a physical device SYNTAX ASSIGN physical-device-name logical-device-name SEMANTICS Physical-device-name is the RT-11 standard permanent name for the device. Logical-device-name is one to three alphanumeric characters long with no intervening spaces or tabs. Or, if your monitor has Extended unit support, it may be an asterisk (*) to indicate that you are assigning a default device. The physical name and logical name must be separated by a space. OPTIONS None EXAMPLES ASSIGN RK1: DK: ASSIGN LS: LP: ASSIGN VM: * .ENDM .MACRO B B Sets a relocation base SYNTAX B[ address] SEMANTICS B address sets a base for subsequent Examine (E) and Deposit (D) commands. The system adds the current base to the value you supply in an Examine or Deposit command. If address is not supplied, the base is set to zero. OPTIONS None EXAMPLES B Sets base to 0 B 6704 Sets base to 6704 octal .ENDM .MACRO BACKUP BACKUP Backup/Restore files or random access devices SYNTAX BACKUP[/OPTION] dev:[filnam.typ] dev:[filnam.typ] SEMANTICS The BACKUP command transfers files or volume images to or from multi-volume backup 'savesets'. The Backup Utility Program (BUP), is useful for making quick archive copies of RT-11 files and device volumes, and employs various data verification techniques to ensure data integrity. BACKUP can also display a directory showing the contents of device volumes and savesets that it produces. BACKUP inp:files out:[ssname] saves file(s) to a saveset on output volume(s) BACKUP/DEVICE inp: out:[ssname] saves a device image to a saveset on output volume(s) BACKUP/RESTORE inp:[ssname/SAVESET,]files out: restores file(s) from a device image saveset on inp: BACKUP/RESTORE/FILE inp:ssname[/SAVESET] out:[filnam.ext] restores saveset to one file on out: BACKUP/RESTORE/DEVICE inp:ssname out: restores a device from a device image saveset on inp: BACKUP/RESTORE/DEVICE/FILE inp:[ssname/SAVESET,]files out: restores file(s) from a device image saveset on inp: BACKUP/DIRECTORY inp:[ssname] creates a listing of saveset sections on the input volume BACKUP/DIRECTORY inp:[ssname]/SAVESET[,files] creates a listing of files within a saveset BACKUP inp:files out:logdsk/SUBSET creates a logical disk file (logdsk.DSK) and saves the specified input file(s) inside it BACKUP/RESTORE inp:logdsk/SUBSET[,files] out: retrieves file(s) from a logical disk file BACKUP/DIRECTORY inp:logdsk/SUBSET[,files] creates a listing of files in a logical disk file OPTIONS DEVICE BACKUP or RESTORE an entire device image. When used with /RESTORE the output volume is initialized DIRECTORY Creates a backup directory listing. The listing is displayed on your terminal, unless /OUTPUT or /PRINTER is specified. FILE Use only with /RESTORE. BACKUP/RESTORE/FILE restores an entire backup saveset to exactly one disk file. BACKUP/RESTORE/DEVICE/FILE restores one or more files from a BACKUP saveset. It is equivalent to BACKUP/RESTORE. INITIALIZE Use with backup operation to initialize an output volume LOG Informs of beginning of backup, restore, or verify operation. Also displays names of files processed. (default) NOLOG Prevents log messages from being printed on the screen NOQUERY Inhibits most confirmation (Are you sure?) prompts. Allows using BACKUP from indirect command files. NOREWIND Prevents initial rewind of magtape before backup or restore operation. Valid with magtape only. NOSCAN Omits bad-block scan of output disks during backup operations ONLY:n Limits the number of saveset sections to be displayed during a /DIRECTORY operation on magtape OUTPUT:filspc Use with /DIRECTORY to send output to a file or device PRINTER Use with /DIRECTORY to send output to LP: QUERY Asks for confirmation before performing an operation (default) RESTORE Restores previously backed up files or volume created by the BACKUP Utility REWIND Causes rewind of tape backup volume before operation begins (default) SAVESET Designates a backup saveset for a /RESTORE or /DIRECTORY operation. The default saveset on disk backups is BACKUP.BUP. The default saveset on magtapes is the first saveset on the tape. When /SAVESET is specified with /DIRECTORY, a list of files contained within the saveset is produced. SCAN Performs scan for bad blocks of each output disk volume before backup (default) SUBSET Use this switch in place of /SAVESET to indicate that the backup is an RT-11 logical disk file. Not valid with magtape. SYSTEM Permits wildcard restore of .SYS files to the SY: device VERIFY[:ONLY] Provides verification of data transferred to or from a device. BACKUP/RESTORE/VERIFY:ONLY performs a comparison of the contents of a backup saveset with an original disk volume without actually restoring it. EXAMPLES BACKUP/DEVICE/INITIALIZE/NOSCAN/VERIFY SY: DU2: BACKUP/INITIALIZE/VERIFY/NOQUERY DU0:*.* MU0:JUL10A BACKUP/NOREWIND/VERIFY/NOQUERY DU1:*.* MU0:JUL10B BACKUP/DIRECTORY MU0: BACKUP/DIRECTORY/PRINTER MU0:JUL10A/SAVESET BACKUP/RESTORE MU0:JUL10A/SAVESET,*.FOR DU2: BACKUP/RESTORE/FILE MU0:JUL10A.BUP SY:JUL10A.DSK BACKUP/VERIFY *.FOR,*.MAC,*.SAV SY:STUFF.DSK/SUBSET BACKUP/DIRECTORY SY:STUFF.DSK/SUBSET .ENDM .MACRO BASIC BASIC Invokes the BASIC-PLUS language processor SYNTAX BASIC SEMANTICS See the BASIC-PLUS/RT-11 Language Reference Manual OPTIONS None EXAMPLES BASIC .ENDM .MACRO BOOT BOOT Boots a new system SYNTAX BOOT[/OPTION] dev:monitor-file SEMANTICS BOOT dev: does a hardware bootstrap of the device you specify. BOOT monitor-file boots the monitor file you specify. The default file type is SYS. OPTIONS FOREIGN Boots a system volume that is not an RT-11 Version 4 or later volume; use this option to boot a V3B or earlier system. WAIT Waits for user response before proceeding with the bootstrap to allow you to change volumes before proceeding with the bootstrap. EXAMPLES BOOT RK1: BOOT RK:RT11FB .ENDM .MACRO CLOSE CLOSE Makes background output files permanent SYNTAX CLOSE SEMANTICS CLOSE makes tentative background files permanent. Use it after unexpected program termination to preserve new files. It does not affect the foreground job. You cannot use it on files opened on magtape or cassette. OPTIONS None EXAMPLES R PROG (Program running) (CTRL/C)(CTRL/C) CLOSE .ENDM .MACRO COMPILE COMPILE Translates source programs SYNTAX COMPILE[/options] filespecs[/options] SEMANTICS To compile multiple files (up to six) into a single OBJ file, separate the files with plus (+) signs in the command line. Multiple files separated by commas (,) are compiled independently. You establish which compiler is invoked by specifying the compiler as a command or file option, by explicitly specifying the source file type, or by letting the system search for the file type. The default file types for output files are .LST for listing files and .OBJ for binary files. Default file types for input are .MAC for macro programs, .FOR for FORTRAN programs, and .DBL for DIBOL programs. OPTIONS ALLOCATE:size Reserves space for an output file ALPHABETIZE DIBOL Alphabetizes the symbol table BUFFERING DIBOL Causes compiler to use single buffered I/O CHECK FORTRAN Specifies array references are to be checked by the compiler CODE:type FORTRAN Specifies the type of machine code to generate CONTINUATIONS:n FORTRAN Specifies the maximum number of continuation lines CROSSREFERENCE[:type[...:type]] MACRO/DIBOL Generates a cross-reference table in the listing file DIAGNOSE FORTRAN Expands compiler crash dump information DIBOL Uses the DIBOL compiler to translate the source files DISABLE:type[...:type] MACRO Specifies a .DSABL directive ENABLE:type[...:type] MACRO Specifies an .ENABL directive EXTEND FORTRAN Enables 80-column source input F4 FORTRAN Uses the FORTRAN IV compiler to translate the source files F77 FORTRAN Uses the FORTRAN 77 compiler to translate the source files FORTRAN FORTRAN Uses the default FORTRAN compiler to translate source programs; change the default with the command SET FORTRA HEADER FORTRAN Includes the "options-in-effect" header in the listing file I4 FORTRAN Allocates 4 bytes for single-precision integers LIBRARY MACRO Identifies a file as a macro library file LINENUMBERS DIBOL/FORTRAN (default) Includes internal sequence numbers in the compiled program LIST[:filespec] Produces a listing file LOG[:filespec] DIBOL Creates a log file of compiler error messages MACRO Uses the MACRO assembler to translate source programs NOLINENUMBERS DIBOL/FORTRAN Suppresses internal sequence numbers in compiled programs NOOBJECT Suppresses output of the binary object file NOOPTIMIZE FORTRAN Suppresses compiler optimization NOSHOW:value MACRO Specifies an .NLIST directive NOSWAP FORTRAN Causes a compiled program to keep the USR resident while running NOVECTORS FORTRAN Specifies array access by multiplication operations NOWARNINGS DIBOL/FORTRAN Suppresses warning messages during compilation OBJECT[:filespec] Specifies a file name for the object file ONDEBUG DIBOL/FORTRAN Compiles D lines in FORTRAN; includes a symbol table in DIBOL binary output OPTIMIZE FORTRAN Requests compiler optimization PAGE:n DIBOL Sets listing page length (default = 66) RECORD:length FORTRAN Alters the default record length for sequential ASCII formatted I/O SHOW:type FORTRAN/MACRO Specifies a .LIST directive to MACRO; controls FORTRAN listing contents STATISTICS FORTRAN Includes compilation statistics in the listing file SWAP FORTRAN (default) Causes a compiled program to swap the USR during execution TABLES DIBOL Includes symbol and label tables in listing TRACE:n FORTRAN Controls amount of extra code included in compiler output for use by the OTS for traceback UNITS:n FORTRAN Specifies the number of logical units that can be open at once VECTORS FORTRAN (default) Specifies array access by tabular lookup WIDE Produces a wide map on a compiler listing created by FORTRAN 77 and a wide LINK map WARNINGS DIBOL/FORTRAN Includes warning messages in the listing file WORKFILES FORTRAN Sets length of workfile (in blocks) EXAMPLES COMPILE/LIST MYPROG.FOR COMPILE/FORTRAN/LIST:FILE1.LST A+B COMPILE A.MAC/LIST,B.FOR .ENDM .MACRO COPY COPY Copies files SYNTAX COPY[/options] input-filespecs[/options] output-filespec[/option] SEMANTICS The COPY command accepts up to six input file specifications but only one output file specification. It accepts wild cards in place of file names or file types. OPTIONS ALLOCATE:size Reserves space for an output file ASCII Copies files in ASCII mode, ignoring nulls and rubouts BEFORE:[dd:mmm:yyyy] Copies files created before the specified date (default is system date) BINARY Copies files in formatted binary mode BOOT[:dd] Copies bootstrap information from a monitor file to the boot blocks of a random access device; use the optional device name if you are creating a volume to boot on a different device (for example, using an RX02 to create a floppy bootable on an RX01) CONCATENATE Combines several input files into a single output file DATE[:dd:mmm:yyyy] Copies only files with specified date. If the date is omitted, the system date is used DELETE Deletes input file after it has been successfully copied DEVICE Copies the image of a device to another device, block for block DOS Specifies that a file is in RSTS/E or DOS-11 format END:n Specifies the last block of the device being read; must be used with /DEVICE and /START:n EXCLUDE Copies all files on a device except the ones you specify FILES Copies a volume image to or from a file on another device; must be used with /DEVICE IGNORE Ignores I/O errors during a copy operation IMAGE (default) Copies files byte for byte, regardless of their content INFORMATION Treats "file-not-found" errors as informational, not fatal INTERCHANGE:n Specifies that a diskette file is in interchange format; n is the record length in characters LOG Lists on the terminal the names of the files copied MULTIVOLUME Copies files to multiple output volumes NEWFILES Copies only those files dated with the current system date NOLOG Suppresses the terminal log of copied files NOPROTECTION Removes protection status on output files NOQUERY Does not require confirmation before copying each file NOREPLACE Does not perform the copy operation if a file with the same name as the output file already exists on the output device OWNER:[nnn,nnn] Specifies the UIC for a file in DOS-11 format PACKED Specifies word-for-word transfers for PDP-11 files, EBCDIC format for interchange diskette files, and packed image format for PDP-10 files. POSITION:n Controls rewind when you copy files to or from magtape or cassette PREDELETE Deletes any duplicate files on the output device before performing the copy operation PROTECTION Sets protection status on output files QUERY Requires user confirmation before copying each file REPLACE (default) Deletes any duplicate files on the output device after the copy completes. SETDATE[:dd:mmm:yyyy] Sets the creation date of transferred files to the specified date. If the date is omitted, the system date is used SINCE[:dd:mmm:yyyy] Copies only files created on or after the specified date. If the date is omitted, the system date is used SLOWLY Transfers files one block at a time START:n Specifies the starting block number of the non-file structured volume being read or written; must be used with /DEVICE SYSTEM Copies .SYS files if wild cards are included in input filespec TOPS Specifies that the input file is on a DECsystem-10 formatted DECtape. VERIFY Reads, writes, and then rereads and compares the input and output transfers WAIT Waits for user response before starting the copy operation; must be used when the system volume is replaced with a data volume EXAMPLES COPY A.FOR DX1:B.FOR COPY/BOOT RK1:RT11SB RK1: COPY A.FOR+B.FOR C.FOR COPY A%B.MAC DX0:*.MAC COPY/ASCII MTA1.FOR DT1:TEST.FOR/ALLOCATE:50 COPY/SINCE:1:JAN:1984 *.MAC *.JAN .ENDM .MACRO CREATE CREATE Creates a file at a specific block address or extends existing files SYNTAX CREATE[/options] filespec[/options] SEMANTICS Filespec is the device name, file name, and file type of the file to create or extend OPTIONS ALLOCATE:size Specifies the number of blocks to allocate to the created file; must follow the filespec EXTENSION:n Extends the specified existing file by n blocks if possible START:block Specifies the starting block on the device of the created file EXAMPLES CREATE DX1:SWAP.SYS/START:6/ALLOCATE:25. CREATE/EXTENSION:100 FILE.DAT .ENDM .MACRO D D Deposits values in memory SYNTAX D address=value[,...value] SEMANTICS The system deposits the octal values in memory, starting at the specified address offset by the current base. Each value deposited replaces a full word. OPTIONS None EXAMPLES D 300=0 D 1000=5020,776 .ENDM .MACRO DATE DATE Sets or displays the current system date SYNTAX DATE[ dd-mmm-yyyy] SEMANTICS All numeric values are decimal; mmm represents the first three characters of the name of the month; yyyy is a 4-digit year in the range 1972 through 2099. A 2 digit year in the range 72 through 99 may also be entered to specify years in the range 1972 through 1999. OPTIONS None EXAMPLES DATE 12-MAR-84 DATE 28-AUG-2007 .ENDM .MACRO DEASSIGN DEASSIGN Removes logical device name assignments SYNTAX DEASSIGN[ logical-device-name] SEMANTICS The DEASSIGN command without an argument disassociates all logical names from all physical devices. OPTIONS None EXAMPLES DEASSIGN INP: DEASSIGN .ENDM .MACRO DELETE DELETE Removes files from a device or queue SYNTAX DELETE[/options] filespecs SEMANTICS This command deletes the files you specify from the device or from the queue manager queue. The DELETE command accepts wild cards in place of a file name or file type. CAUTION! "DELETE DT:A.MAC,B.FOR" deletes DT:A.MAC and DK:B.FOR, not DT:B.FOR. OPTIONS BEFORE[:dd:mmm:yyyy] Deletes only files created before the specified creation date If the date is omitted, the system date is used DATE[:dd:mmm:yyyy] Deletes only files with the specified creation date. If the date is omitted, the system date is used DOS Deletes files you specify from a DOS-11 or RSTS/E DECtape ENTRY Deletes an entry (job) from the queue (does not delete a file) EXCLUDE Deletes all files except the ones you specify INFORMATION Treats "file-not-found" errors as informational, not fatal INTERCHANGE Deletes a file from an interchange format diskette LOG Lists on the terminal the names of the files deleted NEWFILES Deletes only those files dated with the current system date NOQUERY Does not require confirmation before deleting files. This is the default if there are no wild cards in the file specification(s) POSITION:n Directs cassette tape operations QUERY Requires confirmation before deleting each file. This is the default if there are wild cards in the file specification(s). SINCE[:dd:mmm:yyyy] Deletes only files created on or after the specified date. If the date is omitted, the system date is used. SYSTEM Deletes .SYS files WAIT Waits for you to change volumes before proceeding with the delete operation. EXAMPLES DELETE MYPROG.OBJ DELETE/EXCLUDE DX0:*.SAV DELETE/NEWFILES DX1:*.* .ENDM .MACRO DIBOL DIBOL Invokes the DIBOL language compiler SYNTAX DIBOL[/options] filespecs SEMANTICS Separate multiple source files by plus (+) signs in the command line to compile them into a single OBJ file. Multiple files separated by commas (,) are compiled independently. Default file types are .DBL for input, .LST for listing output, and .OBJ for binary output. OPTIONS ALLOCATE:size Reserves space for an output file ALPHABETIZE Alphabetizes the symbol table BUFFERING Causes compiler to use single buffered I/O CROSSREFERENCE Generates a cross-reference table in the listing file LINENUMBERS (default) Includes internal sequence numbers in the compiled program LIST[:filespec] Produces a listing file LOG[:filespec] Creates a log file of compiler error messages NOLINENUMBERS Suppresses internal sequence numbers in compiled programs NOOBJECT Suppresses output of the binary object file NOWARNINGS Suppresses warning messages during compilation OBJECT[:filespec] Specifies a file name for the object file ONDEBUG Includes a symbol table in the binary output for debugging purposes PAGE:n Sets listing page length (default = 66) TABLES Includes symbol and label tables in listing WARNINGS (default) Includes warning messages in the listing file EXAMPLES DIBOL/LIST A DIBOL A+B/LIST/OBJECT DIBOL B/LIST,C/NOOBJECT/LIST .ENDM .MACRO DIFFERENCES DIFFERENCES Compares two files and lists the differences SYNTAX DIFFERENCES[/options] oldfile,newfile SEMANTICS Oldfile and newfile are the files to be compared. The file named in oldfile shows up as file 1 in the differences listing. The default file types are .MAC for input, and .DIF for output. OPTIONS ALLOCATE:size Reserves space for an output file ALWAYS Always produces an output file after a binary comparison, even if there were no differences AUDITTRAIL Includes an audit trail in the output file; valid only with the /SLP option BINARY Compares binary files BLANKLINES Includes blank lines in the comparison BYTES Does binary comparison byte by byte, rather than word by word CASE:type Specifies type of case sensitivity for the comparison; type may be either GENERAL or EXACT, for case insensitive or sensitive, respectively CHANGEBAR Includes a changebar character on lines in the output file that differ from the first input file COMMENTS (default) Includes assembly language comments in the comparison DEVICE Compares contents of two entire volumes, beginning at block zero. END:n Specifies the ending block in the file for a binary comparison FORMFEED Includes formfeeds in the output listing MATCH:n Specifies the number of lines that must agree to constitute a match NOCOMMENTS Excludes assembly language comments from the comparison NOSPACES Excludes spaces and tabs from the comparison NOTRIM Includes trailing spaces and tabs in the comparison OUTPUT[:filespec] Specifies the file name for the differences listing file PRINTER Prints the differences listing on the line printer QUIET Prints only a summary message for a binary comparison SIPP:filnam.typ Specifies the name of the file to contain the SIPP commands that would change oldfile to newfile. (binary comparison only) SLP:filnam.typ Specifies the name of the file to contain the SLP commands that would change oldfile to newfile. (source comparison only) SPACES (default) Includes spaces and tabs in the comparison START:n Specifies the starting block in the file for a binary comparison TERMINAL (default) Types the differences listing on the terminal TRIM (default) Excludes trailing spaces and tabs from the comparison EXAMPLES DIFFERENCES FILE1.TXT,FILE2.TXT DIFFERENCES/MATCH:1/OUTPUT:DIFF.TXT FILE1.TXT,FILE2.TXT DIFFERENCES/SLP:FILE12.DIF FILE1.MAC,FILE2.MAC .ENDM .MACRO DIRECTORY DIRECTORY Lists device or file directories SYNTAX DIRECTORY[/options] [ filespecs[/BEGIN]] SEMANTICS This command generates a listing of the directory you specify. The default is a directory of the device DK:. Specify only one input device. You can use wild cards in a file specification. The default file type for output is .DIR. OPTIONS ALLOCATE:size Use with /OUTPUT to reserve space for the output listing file ALPHABETIZE Sorts the directory in alphabetical order by file name and type BADBLOCKS Scans the device for bad blocks and displays their block number(s). BEFORE[:dd:mmm:yyyy] Lists the files created before the specified date. If the date is omitted, the system date is used BEGIN Lists the directory, starting with the file you specify BLOCKS Lists the starting block numbers of the files BRIEF Lists only file names and file types of files; same as /FAST COLUMNS:n Specifies the number of columns in the directory listing DATE[:dd:mmm:yyyy] Lists the files created on the date you specify. If the date is omitted, the system date is used DELETED Lists a directory of file names that have been deleted DOS Lists the directory of a DOS-11 or RSTS/E volume END:n Specifies the ending block of the bad block scan; valid only with the /BADBLOCKS option EXCLUDE Lists all files except those you specify FAST Lists only file names and file types of files; same as /BRIEF FILES Prints the name of each file in which a bad block is found; valid only with the /BADBLOCKS option FREE Lists unused areas FULL Lists the entire directory, including unused areas INTERCHANGE Lists the directory of an interchange format diskette NEWFILES Lists only those files dated with the current system date NOPROTECTION Lists only those files which are not protected against deletion OCTAL Lists file sizes and starting block numbers in octal ORDER[:category] Orders the directory listing according to the category you specify; same as /SORT. Categories are: DATE- orders by creation date NAME- orders alphabetically by file name POSITION- orders by file position on the device SIZE- orders by file size TYPE- orders alphabetically by file type OUTPUT:filespec Outputs the directory listing to the file you specify OWNER:[nnn,nnn] Specifies the UIC of the directory to be listed; valid only with the /DOS option POSITION (default) Outputs the directory in the physical order in which the files reside on the device. PRINTER Outputs the directory to the device currently assigned "LP:" PROTECTION Lists only the files that are protected against deletion REVERSE Reverses the order of any directory sort in effect SINCE[:dd:mmm:yyyy] Lists files created on or after the date you specify. If the date is omitted, the system date is used SORT[:category] Orders the directory listing according to the category you specify; same as /ORDER START:n Specifies the starting block number of the bad block scan; valid only with the /BADBLOCKS option SUMMARY Lists the segment structure of the directory you specify TERMINAL (default) Lists the directory on the terminal TOPS Lists the directory of a DECsystem-10 formatted DECtape. VOLUMEID[:ONLY] Prints the disk or magtape volume ID and owner name; if :ONLY is not present, also lists the directory WAIT Waits for you to change volumes before proceeding with the directory operation. EXAMPLES DIRECTORY DIRECTORY/BADBLOCKS RK1: DIRECTORY MYPROG.MAC DIRECTORY/FULL/BEFORE:12:APR:2004 DK: DIRECTORY/EXCLUDE DX0:(*.SAV,*.SYS) DIRECTORY/SINCE:1:JAN:1984 .ENDM .MACRO DISMOUNT DISMOUNT Disassociates a logical disk assignment from a file SYNTAX DISMOUNT LDn SEMANTICS Removes the association of a logical disk unit with its currently assigned file, thereby freeing it to be assigned to another file. OPTIONS None EXAMPLE DISMOUNT LD1: .ENDM .MACRO DUMP DUMP Prints formatted data dumps of files or devices SYNTAX DUMP[/options] filespec SEMANTICS Filespec represents the device or file to be dumped. The default file type for output files is .DMP. OPTIONS ALLOCATE:size Reserves space for an output file ASCII (default) Prints the ASCII equivalent of each word or byte dumped BYTES Displays the dumped information as octal bytes END:block Specifies the last block to be dumped FOREIGN Indicates that a magtape does not contain an RT-11 file structure IGNORE Dumps a file that contains a disk error NOASCII Suppresses output of ASCII equivalents of the data dumped ONLY:block Dumps only the block you specify OUTPUT:filespec Outputs the dump listing to the file you specify PRINTER (default) Outputs the dump listing to the line printer RAD50 Prints the RAD50 equivalent of each word dumped START:block Specifies the first block to be dumped TERMINAL Types the dump listing on the terminal WORDS (default) Displays the dump information as octal words EXAMPLES DUMP A.OBJ DUMP/OUTPUT:MACLIB/BYTES/ONLY:1 SYSMAC.MAC DUMP/NOASCII/RAD50/ONLY:6 RK0: .ENDM .MACRO E E Prints the contents of memory on the terminal SYNTAX E address[-address] SEMANTICS Prints in octal the values of the words in the specified address range, offset by the current base. OPTIONS None EXAMPLES E 1000 E 2000-2076 .ENDM .MACRO EDIT EDIT Invokes the text editor SYNTAX EDIT[options] filespec[/ALLOCATE:size] SEMANTICS If you do not specify an option, an Edit Backup for the file you specify is assumed. /CREATE performs an Edit Write for the file. /INSPECT performs an Edit Read for the file. EDIT/OUTPUT:B A is equivalent to an Edit Read on file A and an Edit Write for file B. OPTIONS ALLOCATE:size Reserves space for an output file COMMAND[:filename] Executes the specified file as the initialization command file; the default file is KEDINI.KED CREATE Creates a new file with the name you specify EDIT Invokes the EDIT editor EXECUTE:filespec Executes the TECO commands contained in the file; use with /TECO INSPECT Opens the file you specify for reading only; same as READONLY JOURNAL[:filename] Records in a journal file the modifications you make during your session KED Invokes the KED editor; this is the default for the RT11FB and RT11SB monitors KEX Invokes the mapped monitor (virtual) version of the KED editor; this is the default for mapped monitors K52 Invokes the VT52 version of the KED editor NOCOMMAND Inhibits the execution of an initialization command file NOQUERY Does not require confirmation before beginning the KED/KEX work session OUTPUT:filename Opens the file you specify for output of the edited text QUERY Queries the user before beginning the KED/KEX work session when appropriate READONLY Opens the file you specify for reading only; same as INSPECT RECOVER[:filename] Executes commands from a journal file to recover modifications lost by an abnormal abort of the original work session TECO Invokes the TECO editor EXAMPLES EDIT FILE EDIT/CREATE FILE.NEW EDIT/INSPECT FILE.OLD EDIT/OUTPUT:A B EDIT FILE/ALLOCATE:150 EDIT/JOURNAL FILE EDIT/JOURNAL/RECOVER FILE .ENDM .MACRO EXECUTE EXECUTE Translates, links, and runs a program with one command SYNTAX EXECUTE[/options] filespecs[/options] SEMANTICS To compile multiple files (up to six) into a single OBJ file, separate the files with plus (+) signs in the command line. Multiple files separated by commas (,) are compiled independently. You establish which compiler is invoked by specifying the compiler as a command or file option, by explicitly specifying the source file type, or by letting the system search for the file type. The default file types for output are .LST for listing files, .MAP for load map files, .OBJ for binary output files, and .SAV for memory image files. Default file types for input are .MAC for macro programs, .FOR for FORTRAN programs, and .DBL for DIBOL programs. OPTIONS ALLOCATE:size Reserves space for an output file ALPHABETIZE DIBOL Alphabetizes the symbol table BOTTOM:n Specifies the lowest address to be used in the linked program BUFFERING DIBOL Causes compiler to use single buffered I/O CHECK FORTRAN Specifies array references are to be checked by the compiler CODE:type FORTRAN Specifies the type of machine code to generate CONTINUATIONS:n FORTRAN Specifies the maximum number of continuation lines CROSSREFERENCE[:type[...:type]] MACRO/DIBOL Generates a cross-reference table in the listing file DEBUG[:filespec] Links ODT (or the specified file) with the program as a debugging aid DIAGNOSE FORTRAN Expands compiler crash dump information DIBOL Uses the DIBOL compiler to translate the source files DISABLE:value[...:value] MACRO Specifies a .DSABL directive DUPLICATE Allows multiple copies of library/user routines in overlays ENABLE:value[...:value] MACRO Specifies an .ENABL directive EXECUTE[:filespec] Specifies the name of the memory image file EXTEND FORTRAN Enables 80-column source input F4 FORTRAN Uses the FORTRAN IV compiler to translate the source files F77 FORTRAN Uses the FORTRAN 77 compiler to translate the source files FORTRAN FORTRAN Uses the default FORTRAN compiler to translate source programs; change the default with the command SET FORTRA GLOBAL Includes crossreference listing of global symbols in link map HEADER FORTRAN Includes the "options-in-effect" header in the listing file I4 FORTRAN Allocates 4 bytes for single-precision integers LIBRARY MACRO Identifies a file as a macro library file LINENUMBERS DIBOL/FORTRAN (default) Includes internal sequence numbers in the compiled program LINKLIBRARY:filespec Includes the library you specify during the LINK operation. LIST[:filespec] Produces a listing file LOG[:filespec] DIBOL Creates a log file of compiler error messages MACRO Uses the macro assembler to translate source programs MAP[:filespec] Produces a load map NOLINENUMBERS DIBOL/FORTRAN Suppresses internal sequence numbers in compiled programs NOOBJECT Suppresses output of the binary object file NOOPTIMIZE FORTRAN Suppresses compiler optimization NORUN Prevents program execution after the link operation completes NOSHOW:type MACRO Specifies an .NLIST directive NOSWAP FORTRAN Causes a compiled program to keep the USR resident during execution NOVECTORS FORTRAN Specifies array access by multiplication operations NOWARNINGS DIBOL/FORTRAN Suppresses warning messages during compilation OBJECT[:filespec] Specifies a file name for the object file ONDEBUG DIBOL/FORTRAN Compiles D lines in FORTRAN; includes a symbol table in DIBOL binary output OPTIMIZE FORTRAN Requests compiler optimization PAGE:n DIBOL Sets the listing page length (default = 66) RECORD:length FORTRAN Alters the default record length for sequential ASCII formatted I/O RUN (default) Starts the program after the link operation completes SHOW:type FORTRAN/MACRO Specifies a .LIST directive to MACRO; controls FORTRAN listing contents STATISTICS FORTRAN Includes compilation statistics in the listing file SWAP FORTRAN (default) Causes a compiled program to swap the USR during execution TABLES DIBOL Includes symbol and label tables in listing TRACE:n FORTRAN Controls amount of extra code included in compiler output for use by the OTS for traceback UNITS:n FORTRAN Specifies the number of logical units that can be open at once VECTORS FORTRAN (default) Specifies array access by tabular lookup WARNINGS DIBOL/FORTRAN Includes warning messages in the listing file WIDE Produces a wide map on a compiler listing created by FORTRAN 77 and a wide LINK map WORKFILES FORTRAN Sets length of workfile (in blocks) EXAMPLES EXECUTE MYPROG.FOR EXECUTE RTN1,RTN2,MYPROG/EXECUTE EXECUTE A+B/LIST/OBJECT,MYLIB/LIBRARY+C.MAC/LIST/OBJECT EXECUTE/NORUN/FORTRAN/LIST:FILE1 A+B .ENDM .MACRO FORMAT FORMAT Formats and/or verifies a volume SYNTAX FORMAT[/options] filespec SEMANTICS Filespec is the name and unit number of the device to be formatted or checked. No file name or type is allowed. OPTIONS NOQUERY Does not require confirmation before beginning the formatting or verifying operation. PATTERN[:value] Selects the patterns to use during pattern checking QUERY (default) Requires confirmation before beginning the initialization SINGLEDENSITY Requests that an RX02 diskette be formatted as a single density volume VERIFY[:ONLY] Does pattern checking on the volume after formatting it; does not format if ONLY is included WAIT Waits for you to change volumes before proceeding with the formatting or verifying operation. EXAMPLES FORMAT RK0:/VERIFY/PATTERN:7 FORMAT DY0:/SINGLEDENSITY/WAIT .ENDM .MACRO FORTRAN FORTRAN Invokes the FORTRAN language compiler SYNTAX FORTRAN[/options] filespecs SEMANTICS To compile multiple files (up to six) into a single OBJ file, separate the files with plus (+) signs in the command line. Multiple files separated by commas (,) are compiled independently. The default file types for output are .LST for listing files and .OBJ for binary output. The default input file type is .FOR. OPTIONS ALLOCATE:size Reserves space for an output file CHECK Specifies array references are to be checked by the compiler CODE:type Specifies the type of machine code to generate CONTINUATIONS:n Specifies the maximum number of continuation lines DIAGNOSE Expands compiler crash dump information EXTEND Enables 80-column source input F4 Uses the FORTRAN IV compiler to translate the source files F77 Uses the FORTRAN 77 compiler to translate the source files HEADER Includes the "options-in-effect" header in the listing file I4 Allocates 4 bytes for single-precision integers LINENUMBERS (default) Includes internal sequence numbers in the compiled program LIST[:filespec] Produces a listing file NOLINENUMBERS Suppresses internal sequence numbers in compiled programs NOOBJECT Suppresses output of the binary object file NOOPTIMIZE Suppresses compiler optimization NOSWAP Causes a compiled program to keep the USR resident during execution NOVECTORS Specifies array access by multiplication operations NOWARNINGS Suppresses warning messages during compilation OBJECT[:filespec] Specifies a file name for the object file ONDEBUG Includes D lines in compilation OPTIMIZE Requests compiler optimization RECORD:length Alters the default record length for sequential ASCII formatted I/O SHOW:value Controls the listing content STATISTICS Includes compilation statistics in the listing file SWAP (default) Causes a compiled program to swap the USR during execution TRACE:n Controls amount of extra code included in compiler output for use by the OTS for traceback UNITS:n Specifies the number of logical units that can be open at once VECTORS (default) Specifies array access by tabular lookup WARNINGS Includes warning messages in the listing file WIDE Produces a wide map on a compiler listing created by FORTRAN 77 and a wide LINK map WORKFILES Sets length of workfile (in blocks) EXAMPLES FORTRAN/LIST MYPROG FORTRAN/LIST:FILE2 A+B FORTRAN A+B/LIST,C/NOOBJECT/LIST .ENDM .MACRO FRUN FRUN Loads and starts a foreground program SYNTAX FRUN filespec[/options] SEMANTICS Filespec is the name of the relocatable file to be run as the foreground job. The default file type is .REL. OPTIONS BUFFER:n Reserves n words in memory over and above normal program size NAME:jobname Assigns the specified logical job name to the job; system job monitors only PAUSE Prints the load address and waits rather than starting the job; a RESUME command will start the job TERMINAL:n Assigns terminal unit n to interact with the foreground job; multi-terminal monitors only EXAMPLES FRUN MYPROG FRUN DEMOSP/PAUSE FRUN DEMOFG/BUFFER:1300 FRUN PROG/TERMINAL:3 .ENDM .MACRO GET GET Loads a memory image file into memory SYNTAX GET filespec SEMANTICS The memory image is loaded into the background memory area from the file. OPTIONS None EXAMPLES GET MACRO .ENDM .MACRO HELP HELP Lists helpful information SYNTAX HELP[/options][ topic[ subtopic[:items...]...]] or HELP * SEMANTICS HELP * lists the items for which help is available. HELP lists the HELP text (of which this is a part). HELP topic lists information on the specific topic only. HELP topic subtopic lists information on the specific subtopic only (for example, HELP HELP SEMANTICS lists the paragraph of which this text is a part). HELP topic subtopic:item lists only the text associated with the specific item. HELP topic/item lists the text associated with the specific item under the subtopic OPTIONS. Valid topics are the keyboard monitor commands. Subtopics are "SYNTAX", "SEMANTICS", "OPTIONS", and "EXAMPLES". Items are specific command options. OPTIONS PRINTER Prints the HELP text on the line printer TERMINAL (default) Types the HELP text on the terminal EXAMPLES HELP COPY !Lists information about COPY command HELP/PRINTER EXECUTE !Prints information about EXECUTE !command HELP PRINT OPTION:COPIES!Describes the COPIES option for PRINT HELP COPY/BOOT/DEVICE !Describes the listed options for COPY .ENDM .MACRO INITIALIZE INITIALIZE Initializes device directories SYNTAX INITIALIZE[/options] device SEMANTICS Specify only one device. INITIALIZE initializes the device's file directory and clears it of all files. Any data on the device is lost. A default directory size, which depends on the device, is assigned to the device unless you specify otherwise. OPTIONS BADBLOCKS[:RETAIN] Scans the disk for bad blocks and writes FILE.BAD files over the bad blocks, retaining any old .BAD files if requested DOS Initializes the device you specify in DOS-11 format FILE:filespec Creates a bootable magtape by writing the file you specify in the magtape boot block INTERCHANGE Initializes a diskette directory in interchange format NOQUERY Does not require confirmation before starting the initialization QUERY (default) Requires confirmation before beginning the initialization REPLACE[:RETAIN] Scans a volume for bad blocks and builds a replacement table; if you specify RETAIN, the existing replacement table is reused RESTORE Restores the directory of an initialized volume if that volume has not been written on since it was initialized SEGMENTS:n Specifies the number of segments in the new directory VOLUMEID[:ONLY] Establishes a volume identification and owner name as part of the initialization. ONLY specifies that only the volume id and owner is to change; no volume initialization is performed WAIT Waits for user response before continuing the initialization EXAMPLES INITIALIZE RK1: INITIALIZE/SEGMENTS:20 RK1: INITIALIZE/BADBLOCKS RK: INITIALIZE/FILE:MBOOT.BOT MT0: .ENDM .MACRO INSTALL INSTALL Adds a new device handler to the system SYNTAX INSTALL device[,...device] SEMANTICS Device is the two-character device name for the new handler; it must match the name of the handler file (hh.SYS for SB and FB, hhX.SYS for mapped monitors). OPTIONS None EXAMPLES INSTALL CR: INSTALL LP:,CR:,DT: .ENDM .MACRO LIBRARY LIBRARY Creates and alters object and macro libraries SYNTAX LIBRARY[/options] library filespecs[/options] SEMANTICS Library is the name of the library file to be created or modified. Filespecs are the input module file names, separated by commas (,). The default file types for output files are .LST for directory listings, .MLB for macro libraries, and .OBJ for object libraries. The default input file types are .MAC for macro libraries and .OBJ for object modules. OPTIONS ALLOCATE:size Reserves space for an output file CREATE Creates an object library file DELETE Deletes an object module from a library EXTRACT Extracts an object module from a library and stores it in an OBJ file INSERT Inserts an object module into an existing library LIST[:filespec] Lists the directory of an object library MACRO[:n] Creates a macro library where optional argument is the number of macro directory entries (default = 128.) NOOBJECT Suppresses the creation of a new object library OBJECT[:filespec] Specifies the name of the updated library PROMPT Indicates that there is more than one line of input to the librarian REMOVE Deletes a specific global symbol (and the entire module of which it is a part) from the library directory REPLACE Replaces modules in an existing library with modules of the same name UPDATE Combines /INSERT and /REPLACE functions EXAMPLES LIBRARY/CREATE NEWLIB FIRST,SECOND LIBRARY/EXTRACT NEWLIB DX1:ATAN LIBRARY/INSERT/OBJECT:NEWLIB OLDLIB THIRD,FOURTH LIBRARY/LIST:TT: OLDLIB .ENDM .MACRO LINK LINK Produces an executable program SYNTAX LINK[/options] filespecs SEMANTICS Filespecs are the object files to be linked; separate them with commas (,). Default file types are .OBJ for input files, .MAP for map output files, and .SAV for memory image output files. OPTIONS ALLOCATE:size Reserves space for an output file ALPHABETIZE Lists global symbols on the link map in alphabetical order BITMAP (default) Outputs the program bit map BOTTOM:n Specifies the lowest address to be used by the linked program BOTTOM:n:DAS (used with /IDSPACE only) Specifies the lowest Data space address to be used by the linked program BOTTOM:n:INS or BOTTOM:n (used with /IDSPACE only) Specifies the lowest Instruction space address to be used by the linked program BOUNDARY:value Starts a specific program section on a particular address boundary BOUNDARY:n:DAS (used with /IDSPACE only) Starts a specific Data space program section on a particular address boundary BOUNDARY:n:INS or BOUNDARY:n (used with /IDSPACE only) Starts a specific Instruction space program section on a particular address boundary DEBUG[:filespec] Links ODT or the debugging program you specify with your program DUPLICATE Allows multiple copies of library/user routines in overlays EXECUTE[:filespec] Specifies the name of the memory image file EXTEND:n Extends a program section to the size you specify EXTEND:n:DAS (used with /IDSPACE only) Extends a Data space program section to the size you specify EXTEND:n:INS or EXTEND:n (used with /IDSPACE only) Extends an Instruction space program section to the size you specify FILL:n Initializes unused locations in the memory image file to the value you specify FILL:n:DAS (used with /IDSPACE only) Initializes unused locations in the Data space portion of the memory image file to the value you specify FILL:n:INS or FILL:n (used with /IDSPACE only) Initializes unused locations in the Instruction space portion of the memory image file to the value you specify FOREGROUND[:stacksize] Links the program for foreground execution GLOBAL Includes crossreference listing of global symbols in link map IDSPACE Generates an extended SAV image file which separates Instruction and Data space. Several other options are modified based on the presence of this option INCLUDE Accepts specific global symbols by name for inclusion in the memory image file LDA Produces a file in absolute binary loader format LINKLIBRARY[:filespec] Includes the file you specify as a library in the link operation MAP[:filespec] Generates a load map NOBITMAP Does not output the program bit map if there is code below location 400. When uses with /IDSPACE, causes both the Instruction and Data space bitmaps to be suppressed. NOEXECUTE Suppresses creation of the memory image file PROMPT Indicates that there is more than one line of input to the linker ROUND:n Rounds up a specific program section so that the root is a multiple of the value you specify ROUND:n:DAS (used with /IDSPACE only) Rounds up a specific Data space program section so that the Data space root is a multiple of the value you specify ROUND:n:INS or ROUND:n (used with /IDSPACE only) Rounds up a specific Instruction space program section so that the Instruction space root is a multiple of the value you specify RUN Initiates execution of the linked program SLOWLY Uses the largest possible area for the symbol table during the link operation STACK[:n] Specifies the stack address for the linked program. If used with /IDSPACE and 'n' is not specified, the stack symbol is verified to be in Data space. SYMBOLTABLE[:filespec] Generates a symbol table file TOP:n Specifies the highest address to be used by the linked program TOP:n:DAS (used with /IDSPACE only) Specifies the highest address to be used by the Data space code in the linked program TOP:n:INS or TOP:n (used with /IDSPACE only) Specifies the highest address to be used by the Instruction space code in the linked program TRANSFER[:n] Specifies the starting address of the linked program. If used with /IDSPACE and 'n' is not specified, the transfer symbol is verified to be in Instruction space. WIDE Produces a load map that is 132 columns wide XM Specifies that a job to be run under a mapped monitor requires the special SETTOP features EXAMPLES LINK MYPROG LINK RTN1,RTN2,MYPROG/EXECUTE LINK/MAP:MAPFIL PROG1,PROG2 LINK/IDSPACE/BOTTOM:1000:INS PROG1,PROG2 .ENDM .MACRO LOAD LOAD Makes a device handler permanently resident in memory SYNTAX LOAD device[=jobtype][,....device[=jobtype]] SEMANTICS Device is the two-character permanent device name for the handler to be made resident. Jobtypes are B for background and F for foreground. If system job support is present, jobtype may be any logical job name. OPTIONS None EXAMPLES LOAD RK: LOAD DT:=B,MT:,LP:=F .ENDM .MACRO MACRO MACRO Invokes the macro assembler SYNTAX MACRO[/options] filespecs[/options] SEMANTICS To assemble multiple files (up to six) into a single OBJ file, separate the files with plus (+) signs in the command line. Multiple files separated by commas (,) are assembled independently. The default file types for output are .LST for listing files and .OBJ for binary files. The default file type for input is .MAC. OPTIONS ALLOCATE:size Reserves space for an output file CROSSREFERENCE[:type[...:type]] Generates a cross-reference table in the listing file DISABLE:value[...:value] Specifies a .DSABL directive ENABLE:value[...:value] Specifies an .ENABL directive LIBRARY Identifies a file as a macro library file LIST[:filespec] Produces a listing file NOOBJECT Suppresses output of the binary object file NOSHOW:value Specifies an .NLIST directive OBJECT[:filespec] Specifies a file name for the object file SHOW:type Specifies a .LIST directive EXAMPLES MACRO/LIST MYPROG MACRO/CROSSREFERENCE PROG1+PROG2/LIST/NOOBJECT MACRO/LIST:FILE.OUT A+B .ENDM .MACRO MOUNT MOUNT Assigns a logical disk unit to a file SYNTAX MOUNT[/option] LDn filespec [logical_name] SEMANTICS Associates a logical disk unit with a file on a physical volume. The file specification is of the form dd:filnam.typ, the default file type being .DSK. Specifying the optional logical name causes an implicit ASSIGN LDn logical_name to be performed. OPTIONS NOWRITE Does not permit writing to the logical disk unit WRITE (default) Permits writing to the logical disk unit EXAMPLE MOUNT LD1: WORK.DSK MOUNT LD2: SOURCE.FIL SRC MOUNT/NOWRITE LD7 LD6:MASTER.DSK SEC .ENDM .MACRO PRINT PRINT Prints files on the line printer SYNTAX PRINT[/options] filespecs SEMANTICS The PRINT command accepts up to six input file specifications; separate multiple file specifications with commas (,). Wild cards are accepted in place of file names or file types. The default file type is .LST. If the queue processor is running, files are automatically queued to the line printer OPTIONS BEFORE[:dd:mmm:yyyy] Prints only the contents of the files created before the specified date. If the date is omitted, the system date is used COPIES:n Prints the number of copies you specify DATE[:dd:mmm:yyyy] Prints only the contents of the files created on the date specified. If the date is omitted, the system date is used DELETE Deletes the file after printing it FLAGPAGE:n Includes a banner page before the file INFORMATION Treats "file-not-found" errors as information, not fatal LOG Lists on the terminal the files printed NAME:dev:jobname Associates a job name with the print queue entry and specifies the device to queue to; valid only if QUEUE is running NEWFILES Prints only those files dated with the current system date NOFLAGPAGE (default) Does not include a banner page before the file NOLOG Suppresses the terminal log of files printed OUTPUT Specifies an alternative output device to which to send the file PROMPT Allows continuation lines; valid only if QUEUE is running QUERY Requires confirmation before printing each file SINCE[:dd:mmm:yyyy] Prints the contents of files created on or after the date specified. If the date is omitted, the system date is used WAIT Waits for user response before proceeding with the print (Not valid if QUEUE is running) EXAMPLES PRINT A.LST PRINT/COPIES:3 REPORT PRINT/DELETE FILE1 PRINT/FLAGPAGE:2 FILE2 PRINT/NEWFILES/QUERY *.LST .ENDM .MACRO PROTECT PROTECT Sets RT-11 file protection status SYNTAX PROTECT[/options] filespec SEMANTICS The specified RT-11 file's protection status is set to prevent deletion OPTIONS BEFORE[:dd:mmm:yyyy] Sets protection status for files created before the specified date. If the date is omitted, the system date is used DATE[:dd:mmm:yyyy] Sets protection status only for files with the specified date. If the date is omitted, the system date is used EXCLUDE Sets protection status for all files on a device except for the files specified LOG Lists on the console terminal a log of the files whose protection status are affected NEWFILES Sets protection status only for files which have the current system date QUERY Requests confirmation, file by file, before protection status is set SETDATE[:dd:mmm:yyyy] Sets the creation date of the protected file to the specified date. If the date is omitted, the system date is used SINCE[:dd:mmm:yyyy] Sets protection status only for files which were created on or after the specified date. If the date is omitted, the system date is used SYSTEM Sets the protection status of .SYS files if wild cards are included in the filespec WAIT Pauses to allow operator to mount volume containing files whose protection status is to be set EXAMPLES PROTECT KED.SAV PROTECT/NEWFILES *.DAT PROTECT/QUERY *.MAC PROTECT/SYSTEM/QUERY *.SYS .ENDM .MACRO QUEMAN QUEMAN Queue control program. SYNTAX /Option SEMANTICS Most requests to QUEMAN are done through DCL commands. Only requests not supported by DCL are described here. OPTIONS A Abort the QUEUE program. Output is stopped. M Remove a job from the queue. Specify the job name followed by /M. P Prompt for default settings. Two items are prompted for: Number of banner pages? Delete workfile? R Resume queue output if QUEUE was previously suspended using /S. Restart the current job if QUEUE was not previously suspended. S Suspend QUEUE at the end of the current file. EXAMPLES /A LIST/M .ENDM .MACRO R R Loads and starts a program SYNTAX R filespec[ input-list[ output-list]] or R filespec[ argument] SEMANTICS Filespec is the name of the program to be started. The default device is SY: and the default file type is .SAV. Any argument or input and output list you include is passed to the program in CSI format. OPTIONS None EXAMPLES R MYPROG R DX1:MYPROG R DIR DX1:*.* LP:/E .ENDM .MACRO RECALL RECALL Recalls a previously entered command (mapped monitors only) SYNTAX RECALL[/options] [ string] [ n] SEMANTICS Recalls a command line saved by SL, produces a list of command lines saved by SL, or clears SL's command buffer. Notes: The RECALL command is available only when using SL with an RT-11 mapped monitor. SET SL RECALL must be in effect. RECALL commands are not saved in the SL command stack. RECALL commands are recognized only from the keyboard; not from command files. RECALL string Searches for and recalls a previous command that begins with the specified string RECALL n Recalls the "nth" command line in the command stack OPTIONS ALL Produces a numbered list of command lines saved by SL. The current cycle depth is indicated by an asterisk. CLEAR Clears SL's command buffer, and resets the CYCLE depth to two. EXAMPLES RECALL DIR RECALL/ALL RECALL 14 .ENDM .MACRO REENTER REENTER Starts a program at its reentry address SYNTAX REENTER SEMANTICS The program that is in memory in the background area is restarted at its reentry address. OPTIONS None EXAMPLES REENTER .ENDM .MACRO REMOVE REMOVE Removes a device handler from the system SYNTAX REMOVE device[,...device] For mapped monitors REMOVE [device[,...,device] [region[,...,region] SEMANTICS Device is the two-character permanent device name for the device to be removed from the system. Region is a 1-to-6-character global region. If found, that global region is eliminated. OPTIONS None EXAMPLES REMOVE LP: REMOVE CR:,DT: REMOVE IND REMOVE SP,MYREG,IND,LP: .ENDM .MACRO RENAME RENAME Changes the name of a file SYNTAX RENAME[/options] input-filespec output-filespec SEMANTICS The RENAME command accepts up to six input file specifications; separate multiple file specifications with commas (,). The command accepts only one output file specification. Wild cards are accepted in place of file names or file types. The device you specify (if any) must be the same for input and output files. OPTIONS BEFORE[:dd:mmm:yyyy] Renames only those files created before the specified date. If the date is omitted, the current system date is used DATE[:dd:mmm:yyyy] Renames only those files created on the specified date. If the date is omitted, the current system date is used INFORMATION Treats "file-not-found" errors as information, not fatal LOG Lists the renamed files on the terminal NEWFILES Renames only those files dated with the current system date NOLOG Suppresses the terminal log of renamed files NOPROTECTION Removes the protected status of files NOREPLACE Does not perform the rename operation if a file with the new name already exists PROTECTION Sets files to be protected against deletion QUERY Requires confirmation before each rename operation begins REPLACE (default) Deletes any previous files with the new name after the operation completes SETDATE[:dd:mmm:yyyy] Sets the creation date on the renamed file to the date specified. If the date is omitted, the system date is used SINCE[:dd:mmm:yyyy] Renames files created on or after the specified date. If the date is omitted, the system date is used SYSTEM Renames .SYS files WAIT Waits for user response before proceeding with the rename EXAMPLES RENAME A.FOR B.FOR RENAME A%%.MAC *.FOR RENAME/SYSTEM DX0:MM.SYS DX0:MX.SYS .ENDM .MACRO RESET RESET Causes a general system reset SYNTAX RESET SEMANTICS OPTIONS None EXAMPLES RESET .ENDM .MACRO RESUME RESUME Resumes execution of a foreground or system job SYNTAX RESUME [jobname] SEMANTICS Resumes execution of the foreground or system job after a SUSPEND command or if an FRUN or SRUN command was used with the /PAUSE option. If system job support is present, jobname is the logical name of the job to resume. OPTIONS None EXAMPLES RESUME .ENDM .MACRO RUN RUN Loads and starts a program SYNTAX RUN filespec[ input-list[ output-list]] or RUN filespec[ argument] SEMANTICS Filespec is the name of the program to be started. The default device is DK: and the default file type is .SAV. Any argument or input and output list you include is passed to the program in CSI format. OPTIONS None EXAMPLES RUN MYPROG RUN DX1:MYPROG RUN DIR DX1:*.* LP:/E .ENDM .MACRO SAVE SAVE Writes memory areas to a file SYNTAX SAVE filespec[ parameters] SEMANTICS Filespec is the file in which background memory is to be saved. Parameters are of the form address[-address2][,...] and specify the areas of memory to be saved. The default is to save all the background program. OPTIONS None EXAMPLES SAVE TESTPG SAVE TABLE 1000-17776 .ENDM .MACRO SET SET Controls various system options SYNTAX SET physical-device-name condition or SET item condition SEMANTICS Physical-device-name is the name of the device handler whose characteristics are to be modified. Item is a system parameter to be modified. Separate multiple conditions with commas (,). See the RT-11 Commands Manual for a list of the handler characteristics and system parameters that can be changed. OPTIONS None EXAMPLES SET LP: LC SET WILD EXPLIC SET ERROR SEVERE .ENDM .MACRO SETUP SETUP Set hardware characteristics of a device SYNTAX SETUP device command[,...command] SEMANTICS SETUP device command[,...command] sets the characteristics associated with the commands for the device specified. Since not all commands are valid for all devices, consult the user's guide for your particular hardware to determine which characteristics are supported by your device. See the RT-11 Commands Manual for descriptions of the valid SETUP commands or type SETUP HELP. EXAMPLES SETUP TERMINAL LIGHT,TABS:10:20,SMOOTH SETUP CLOCK TIME:14:35,DATE:31:OCT SETUP LS DRAFT,HORIZONTAL:6 .ENDM .MACRO SHOW SHOW Displays system hardware and software status SYNTAX SHOW [options] SEMANTICS SHOW displays the device assignments; other information is displayed by specifying one or more option names. OPTIONS ALL Shows configuration, devices, jobs, and terminals COMMANDS[/options] Displays a list of defined User Command Linkage (UCL) commands /OUTPUT:filespec Produces the defined command list in the specified file /PRINTER Produces the defined command list on the line printer CONFIGURATION Indicates the monitor version number, SET options, hardware configuration, and SYSGEN options DEVICES Indicates the status and vectors of all device handlers on the system ERRORS[/options] Produces on the terminal a report of all system and device errors; valid only if error logging is present. Options are: /ALL (default) Produces the report for all errors /FILE[:filnam.typ] Specifies the name of the file containing the logged errors; defaults to ERRLOG.DAT /FROM:[dd:mmm:yyyy] Reports only errors that occurred after the date specified /OUTPUT:filespec Produces the report in the specified file /PRINTER Produces the report on the line printer /SUMMARY Produces a summary report /TERMINAL (default) Produces the report on the terminal /TO:[dd:mmm:yyyy] Reports only errors that occurred before the date specified JOBS Lists the names and status of all loaded jobs MEMORY Displays the current memory organization in tabular form QUEUE Lists the contents of the line printer queue SUBSET List the current logical disk subsetting assignments in effect TERMINALS Indicates the status and SET options of all the terminals on the system (if a multi-terminal monitor) UMR Displays information about the UNIBUS mapping registers if the UB pseudohandler is loaded, or information about why UB is not loaded EXAMPLES SHOW SHOW CONFIGURATION SHOW QUEUE .ENDM .MACRO SL SL RT-11's Single Line Command Editor SYNTAX o SL uses keypad keys, arrow keys, LINEFEED and DELETE keys, and and keys on main keyboard o on the keypad is the "GOLD" key o Press GOLD first for lower keypad functions ( is DEL LINE, is UNDEL LINE) +----------+----------+----------+----------+ | PF1 | PF2 | PF3 | DEL LINE | | GOLD | HELP | | | | | | |UNDEL LINE| +----------+----------+----------+----------+ o HELP key displays function key layout. OPTIONS ARROW KEY FUNCTIONS: o Arrow key functions: LEFT Cursor to left one character +----------+ RIGHT Cursor to right one character | OLD | OLD Recall previous line | ^ | NEW Recall next line | CYCLE | +----------+----------+----------+ | LEFT | NEW | RIGHT | | <- | v | -> | o Arrow Key Functions: | BEGIN | SET CYC | END | +----------+----------+----------+ CYCLE Recall nth line BEGIN Move cursor to line begin SET CYC Store current line depth END Move cursor to line end Save command in SAVE buffer Recall command from SAVE buffer KEYPAD +----------+----------+----------+----------+ | | | | DEL LINE | Lower Functions | GOLD | HELP | | | are GOLD | PF1| PF2| PF3|UNDEL LINE| +----------+----------+----------+----------+ | | | | DEL WORD | | | | | - | | 7| 8| 9|UNDEL WORD| +----------+----------+----------+----------+ | ADVANCE | BACKUP | | DEL CHAR | | | | | , | | 4| 5| 6|UNDEL CHAR| +----------+----------+----------+----------+ | WORD | EOL | CHAR | | | | | | | | 1| DEL EOL 2| 3| | +----------+----------+----------+ ENTER + | BLINE | | | | | | | | OPEN LINE 0| .| | +----------+----------+----------+----------+ CONTROL FUNCTIONS Control key sequences perform the following functions: CTRL/A Alternate between INSERT and REPLACE modes CTRL/B Previous line * CTRL/C Cancel command CTRL/D Cursor left CTRL/E Previous line CTRL/F Cursor right * CTRL/H Swap/Unswap CTRL/J Delete Word to left of cursor CTRL/R Re-display current line CTRL/U Delete line to the left of cursor CTRL/V Next line CTRL/W Re-display current line CTRL/Z EOF * only when SET TT NOFB is in effect CONTROL FUNCTIONS (continued) Delete Word to left of cursor Delete character to left of cursor CTRL/U Undelete line to left of cursor Undelete character RECALL (mapped monitors only) This command allows you to display and recall lines that are saved in the SL command stack. (Type HELP RECALL) .ENDM .MACRO SQUEEZE SQUEEZE Rearranges disk files to collect unused file space SYNTAX SQUEEZE[/options] device SEMANTICS Specify one input device. If you do not specify an output device, the input device is compressed. If you specify an output device, the input device is copied to the output device in a compressed format and the input device remains unchanged. If you specify an output device, make sure it was previously initialized. OPTIONS NOQUERY Does not require confirmation before the compression begins OUTPUT:filespec Compresses the input device to the output device you specify rather than onto itself QUERY (default) Requires confirmation before the compression begins WAIT Waits for user response before proceeding with the squeeze EXAMPLES SQUEEZE RK3: SQUEEZE/OUTPUT:RK1: RK0: SQUEEZE/NOQUERY DT1: .ENDM .MACRO SRUN SRUN Loads and starts a system job SYNTAX SRUN filespec[/options] SEMANTICS Filespec is the name of the relocatable file to be run as the system job. The default file type is .REL. OPTIONS BUFFER:n Reserves n words in memory over and above normal program size LEVEL:n Assigns priority n to the job; n is a number from 1 to 6 NAME:jobname Assigns the specified logical job name to the system job PAUSE Prints the load address and waits rather than starting the job; a RESUME command will start the job TERMINAL:n Assigns terminal unit n to interact with the foreground job; multi-terminal monitors only EXAMPLES SRUN EL/LEVEL:4/TERM:1 SRUN F4JOB.REL/BUFF:1000 .ENDM .MACRO START START Initiates the program in memory SYNTAX START[ address] SEMANTICS Address is an even octal number that specifies an address in the background job. The program in memory is started at that address. The default is to use the program's start address. OPTIONS None EXAMPLES START START 7002 .ENDM .MACRO SUSPEND SUSPEND Stops execution of the foreground or system job SYNTAX SUSPEND [jobname] SEMANTICS Suspends execution of the foreground job until a RESUME command is given. If system job support is present, the jobname is the logical name of the job to suspend. OPTIONS None EXAMPLES SUSPEND .ENDM .MACRO TIME TIME Sets or displays the system time SYNTAX TIME[ hh:mm:ss] SEMANTICS In the TIME command, hh represents the hour (0-23), mm represents the minute (0-59), and ss represents the second (0-59). The system assumes 00 for an omitted field. OPTIONS None EXAMPLES TIME 11:15 .ENDM .MACRO TYPE TYPE Outputs files to the terminal SYNTAX TYPE[/options] filespecs SEMANTICS The TYPE command accepts up to six input file specifications; separate multiple file specifications with commas (,). Wild cards are accepted in place of file names or file types. The default file type is .LST. OPTIONS BEFORE[:dd:mmm:yyyy] Types the contents of files created before the specified date. If the date is omitted, the system date is used COPIES:n Types the file the number of times you specify DATE[:dd:mmm:yyyy] Types the contents of files created on the specified date. If the date is omitted, the system date is used DELETE Deletes the file after typing it INFORMATION Treats "file-not-found" errors as information, not fatal LOG Logs the names of the files typed NEWFILES Types only those files dated with the current system date NOLOG Suppresses the log of the files typed QUERY Requires confirmation before typing each file SINCE[:dd:mmm:yyyy] Types the contents of files created on or after the specified date. If the date is omitted, the system date is used WAIT Waits for user response before proceeding with the type EXAMPLES TYPE A.LST TYPE/COPIES:3 REPORT TYPE/NEWFILES *.LST .ENDM .MACRO UNLOAD UNLOAD Removes a resident device handler or FG job from memory SYNTAX UNLOAD device[,...device] UNLOAD jobname[,...jobname] SEMANTICS Device is the physical device name of the device handler to be removed from memory. UNLOAD F removes a foreground program that is not running. UNLOAD "jobname" unloads a system job, if system jobs are supported and the job is not running. OPTIONS None EXAMPLES UNLOAD RK: UNLOAD LP:,DT: UNLOAD F UNLOAD QUEUE .ENDM .MACRO UNPROTECT UNPROTECT Resets RT-11 file protection status SYNTAX UNPROTECT[/options] filespec SEMANTICS The specified RT-11 file's protection status is set to allow deletion OPTIONS BEFORE[:dd:mmm:yyyy] Sets protection status only for files created before the specified date. If the date is omitted, the system date is used DATE[:dd:mmm:yyyy] Resets protection status only for files with the specified date. If the date is omitted the system date is used EXCLUDE Resets protection status for all files on a device except for the files specified INFORMATION Treats "file-not-found" errors as information, not fatal LOG Lists on the console terminal a log of the files whose protection status allows deletion NEWFILES Resets protection status only for files which have the current system date QUERY Requests confirmation, file by file, before protection status is reset SETDATE[:dd:mmm:yyyy] Sets the creation date of the unprotected file to the specified date. If the date is omitted, the system date is used SINCE[:dd:mmm:yyyy] Sets protection status only for files which were created on or after the specified date. If the date is omitted, the system date is used SYSTEM Allows protection status of .SYS files to reset WAIT Pauses to allow operator to mount volume containing files whose protection status is to be reset EXAMPLES UNPROTECT KED.SAV UNPROTECT/NEWFILES *.DAT UNPROTECT/SINCE:14:APR:1982 *.MAC UNPROTECT/QUERY/SYSTEM *.SYS .ENDM .MACRO V V Loads and starts a completely virtual program (mapped only) SYNTAX V filespec[ input-list[ output-list]] or V filespec[ argument] SEMANTICS Filespec is the name of the program to be started. The default device is SY: and the default file type is .SAV. Any argument or input and output list you include is passed to the program in CSI format. OPTIONS None EXAMPLES V MYPROG V DX1:MYPROG V DIR DX1:*.* LP:/E .ENDM .MACRO VRUN VRUN Loads and starts a completely virtual program (mapped only) SYNTAX VRUN filespec[ input-list[ output-list]] or VRUN filespec[ argument] SEMANTICS Filespec is the name of the program to be started. The default device is DK: and the default file type is .SAV. Any argument or input and output list you include is passed to the program in CSI format. OPTIONS None EXAMPLES VRUN MYPROG VRUN DX1:MYPROG VRUN DIR DX1:*.* LP:/E .ENDM