^^ .right margin 78 .title RT/RSX SIMULATOR USER GUIDE .NOFILL Copyright 1977, McGill University .FILL - .skip 20 .nofill .center RT/RSX SIMULATOR .center ================ .center USER GUIDE .center ========== .skip 20 .tab stops 50 AUTHOR:G.Bernstein DATE: 25-FEB-77 IDENT: UP15.1 NAME: RTRSUSRGD.RNO LOCATION: SY:[1,203] LAST UPDATE: 14-SEP-77 .page .skip 2 DESCRIPTION .SKIP ----------- .SKIP 2 .TAB STOPS 10 RSX task 'RTV' will simulate an RT-11 V02B operating system running in a 16K PDP-11 computer.A 24K RT-11 system is also available. Most of the normal RT-11 program development operations can be performed. RT-11 system programs supported include: .nofill EDIT PIP MACRO LINK PATCH FORTRAN SRCCOM LIBR .fill .skip 2 Once a user program has been developed it can be run under the simulator as long as it restricts I/O to the devices noted in the next paragraph. Attempts at doing I/O to other devices, e.g. A/D converters will meet with unpredicatble results. Once debugged, the user program can be transported to the target RT-11 system and run without modification. .skip 2 RT-11 SUPPORT PROVIDED .skip ---------------------- .fill .tab stops 10 .skip 2 The virtual file (SY:[1,200]VIRK05.VIR) has been loaded with most of the RT-11 system programs in addition to SYSMAC.SML, FORLIB.OBJ and SYSLIB.OBJ. These are all RT-11 V02B versions. The virtual file simulates an RT-11 system device of 4096 blocks; i.e. an RK05 disk. .skip 2 Support for line printer (LP), terminal (TT), system device (SY or default) and floppy disk drive 0 (DX) has been built in. Because of the limited size of the virtual file it is suggested that users save all files created on an RT-11 floppy and delete those files from the 'system device' when a session is completed. There is also a clean copy of the virtual file ([1,200]VIRK05.SAV) which can be renamed to 'VIRK05.VIR' should the latter become corrupted. It is also possible for a private version of VIRK05 to be created under a user's own UIC with a suitably modified 'RTV' task for use in this manner. .skip 2 Support for the foreign-mounted RT-11 device (DX) has been provided to facilitate communication between the simulator and the target RT-11 system. Note that references to DX:, DX0:, and DX1: will all cause I/O to the floppy mounted in drive 0, and that this floppy must be an RT-11 file-structured volume. It is possible to re-assign the floppy LUN at run-time by issuing an MCR reassign command following installation of RTV. For example, to use an RK05 mounted in drive 1, enter .nofill .skip >INS [1,200]RTV >REA RTV 5 DK1: .fill .paragraph Note also that the terminal driver provided only supports output operations. Thus PIP commands of the form 'TT:=XXX.FOR' are legal while 'XXX.FOR=TT:' are not. .skip 3 STARTING THE TASK .skip ----------------- .skip 2 A) Running the 16K Virtual Version .skip 2 The 16K version is adequate for most applications and should be used whenever possible. Issue the command: .skip 2 >RUN [1,200]RTV .skip 1 and after RT-11 signs on proceed with program development as if a stand-alone RT system were being used. .skip 3 B) Running the 24K Virtual Version .skip 2 The 24K version has been provided for the running of larger programs and for the assembly and compilation of programs which require large symbol table space. Issue the command .skip 2 >RUN [1,200]RTV24K .skip 1 to start the 24K version. .skip 3 C) Running the 16K Logical Version .skip 2 The logical version performs filing to a foreign mounted RT-11 disk rather than to the virtual file. In the BMEU implementation, this disk is a floppy containing the modified executive 'RSXLOG.SYS' and modified device drivers which is mounted in drive 1. To run the logical system, mount the floppy in DX1, allocate it and run 'RTL'; i.e. .skip 2 >ALL DX1: .skip 1 >RUN [1,200]RTL .skip 2 Note that references to DX0: in the BMEU implementation will be directed to the RT-11 floppy mounted in drive 0 while references to SY: or default will be to the floppy in drive 1. See the document 'RTRSNOTES.RNO' for instructions on configuring systems with different devices. .skip 3 EXITING TO RSX .skip -------------- .skip 2 Exit to RSX can be accomplished by typing . Note that this character is therefore no longer passed on to RT-11. It should be noted that when this graceful exit is not performed (e.g. upon system crashes while the simulator is in use) that the virtual file will become locked and must be unlocked with PIP before the system is usable again. .skip 3 KNOWN PROBLEMS .skip -------------- .skip 2 .nofill 1. Only one person at a time can use the simulator. 2. The task is not checkpointable and therefore ties up a good deal of core. 3. FOCAL doesn't run (but RT-11 BASIC does) 4. works but when performed from within PIP, for example, the '*' character is not displayed when the listing is finished. 5. Output to the line printer does not get spooled. Users should use 'LP' only when they are sure that no one else is spooling. 6. Occasionally the task gets hung up. Since the task attaches the RSX terminal it may only be aborted from a privileged terminal using the MCR 'ABO' command. The virtual file must be unlocked in this instance. 7. GT ON is disabled. 8. Only the S/J version is implemented.