mirror of
https://github.com/pkimpel/retro-b5500.git
synced 2026-04-15 09:19:41 +00:00
Reconstruct Google Code wiki history:
Apply the *.md "markdown" files generated by the conversion from Google Code to GitHub on top of the reconstructed *.wiki files from the Google Code Subversion repository and delete the *.md files. Log of the history of wiki development on Google Code prior to conversion from *.wiki to GitHub *.md format: Revision: 476 Author: paul.kimpel@digm.com Date: 2/8/2015 10:32:05 PM Message: Commit wiki changes for Release 1.01. ---- Modified : /wiki/WebUIGettingStarted.wiki Modified : /wiki/WebUIRunningTheEmulator.wiki Modified : /wiki/WebUIUsingDatacom.wiki Modified : /wiki/WebUIUsingTheConsole.wiki Modified : /wiki/WebUIUsingTheSPO.wiki Modified : /wiki/images/B5500-Console.png Added : /wiki/images/B5500-Home-Page.png Modified : /wiki/images/B5500-SPO.png Revision: 466 Author: paul.kimpel@digm.com Date: 9/29/2014 8:25:38 AM Message: Commit wiki updates for release 1.00. ---- Modified : /wiki Modified : /wiki/WebUIGettingStarted.wiki Modified : /wiki/WebUIRunningTheEmulator.wiki Modified : /wiki/WebUIUsingDatacom.wiki Modified : /wiki/WebUIUsingTheConsole.wiki Modified : /wiki/WebUIUsingTheSPO.wiki Modified : /wiki/images/B5500-Console.png Modified : /wiki/images/B5500-SPO.png Added : /wiki/0.20-WebUIGettingStarted.wiki (Copy from path: /branches/alpha/wiki/0.20-WebUIGettingStarted.wiki, Revision, 465) Modified : /wiki/TableOfContents.wiki Added : /wiki/WebUIConfiguringTheSystem.wiki (Copy from path: /branches/alpha/wiki/WebUIConfiguringTheSystem.wiki, Revision, 465) Modified : /wiki/WebUIHowToSetUpCANDE.wiki Modified : /wiki/WebUIUsingTheCardPunch.wiki Modified : /wiki/WebUIUsingTheCardReader.wiki Modified : /wiki/WebUIUsingTheLinePrinter.wiki Modified : /wiki/WebUIUsingTheMagTapeDrive.wiki Modified : /wiki/images/B5500-CardPunch.png Modified : /wiki/images/B5500-CardReader.png Added : /wiki/images/B5500-LinePrinter.png (Copy from path: /branches/alpha/wiki/images/B5500-LinePrinter.png, Revision, 465) Modified : /wiki/images/B5500-MagTapeDrive.png Modified : /wiki/images/B5500-MagTapeLoader.png Added : /wiki/images/B5500-Word-DP.png (Copy from path: /branches/alpha/wiki/images/B5500-Word-DP.png, Revision, 465) Added : /wiki/images/B5500-Word-SP.png (Copy from path: /branches/alpha/wiki/images/B5500-Word-SP.png, Revision, 465) Added : /wiki/images/Configuration-Default-Created.PNG (Copy from path: /branches/alpha/wiki/images/Configuration-Default-Created.PNG, Revision, 465) Added : /wiki/images/Disk Schema Update.png (Copy from path: /branches/alpha/wiki/images/Disk Schema Update.png, Revision, 465) Added : /wiki/images/Disk-Config-Created.PNG (Copy from path: /branches/alpha/wiki/images/Disk-Config-Created.PNG, Revision, 465) Added : /wiki/images/Disk-Config-Deleted.PNG (Copy from path: /branches/alpha/wiki/images/Disk-Config-Deleted.PNG, Revision, 465) Added : /wiki/images/Disk-Config-Dialog.PNG (Copy from path: /branches/alpha/wiki/images/Disk-Config-Dialog.PNG, Revision, 465) Added : /wiki/images/Disk-Config-Does-Not-Exist.PNG (Copy from path: /branches/alpha/wiki/images/Disk-Config-Does-Not-Exist.PNG, Revision, 465) Added : /wiki/images/System-Config-Delete-Confirm.PNG (Copy from path: /branches/alpha/wiki/images/System-Config-Delete-Confirm.PNG, Revision, 465) Added : /wiki/images/System-Config-Deleted.PNG (Copy from path: /branches/alpha/wiki/images/System-Config-Deleted.PNG, Revision, 465) Added : /wiki/images/System-Config-Dialog.PNG (Copy from path: /branches/alpha/wiki/images/System-Config-Dialog.PNG, Revision, 465) Added : /wiki/images/System-Config-Does-Not-Exist.PNG (Copy from path: /branches/alpha/wiki/images/System-Config-Does-Not-Exist.PNG, Revision, 465) Revision: 427 Author: paul.kimpel@digm.com Date: 8/5/2014 12:23:33 PM Message: Create initial Table of Contents sidebar page. ---- Added : /wiki/TableOfContents.wiki Revision: 410 Author: paul.kimpel@digm.com Date: 6/29/2014 1:39:38 PM Message: Minor wiki updates for release 0.20 ---- Modified : /wiki/WebUIRunningTheEmulator.wiki Modified : /wiki/WebUIUsingDatacom.wiki Modified : /wiki/WebUIUsingTheConsole.wiki Revision: 394 Author: paul.kimpel@digm.com Date: 1/19/2014 4:57:05 AM Message: Commit updates and corrections to the Using the Magnetic Tape Drive wiki for 0.19. ---- Modified : /wiki/WebUIUsingTheMagTapeDrive.wiki Revision: 393 Author: nw@retrocomputingtasmania.com Date: 1/10/2014 3:41:11 PM Message: Edited wiki page B5500maxconfig through web user interface. ---- Modified : /wiki/B5500maxconfig.wiki Revision: 392 Author: paul.kimpel@digm.com Date: 1/10/2014 2:46:41 PM Message: Correct tape drive loader wiki image extension from jpg to png. ---- Modified : /wiki/WebUIUsingTheMagTapeDrive.wiki Revision: 390 Author: paul.kimpel@digm.com Date: 1/10/2014 2:17:55 PM Message: Wiki updates for release 0.19. ---- Modified : /wiki/WebUIUsingTheSPO.wiki Modified : /wiki/WebUIUsingTheMagTapeDrive.wiki Modified : /wiki/images/B5500-MagTapeDrive.png Added : /wiki/images/B5500-MagTapeLoader.png Revision: 385 Author: paul.kimpel@digm.com Date: 12/30/2013 11:10:05 AM Message: Minor wiki updates for release 0.18. ---- Modified : /wiki/WebUIUsingTheConsole.wiki Modified : /wiki/WebUIUsingTheSPO.wiki Revision: 381 Author: paul.kimpel@digm.com Date: 11/25/2013 10:08:49 PM Message: Commit further revisions to Tim Sirianni's initial TSMCP/CANDE setup wiki page. ---- Modified : /wiki/WebUIUsingDatacom.wiki Modified : /wiki/WebUIHowToSetUpCANDE.wiki Revision: 380 Author: paul.kimpel@digm.com Date: 11/25/2013 9:57:01 PM Message: Commit further revisions to Tim Sirianni's initial TSMCP/CANDE setup wiki page. ---- Modified : /wiki/WebUIHowToSetUpCANDE.wiki Revision: 379 Author: paul.kimpel@digm.com Date: 11/25/2013 9:49:29 PM Message: Commit revisions to Tim Sirianni's initial TSMCP/CANDE setup wiki page. ---- Modified : /wiki/WebUIHowToSetUpCANDE.wiki Revision: 378 Author: nw@retrocomputingtasmania.com Date: 11/23/2013 3:33:32 PM Message: typo and verbalize note. ---- Modified : /wiki/WebUIHowToSetUpCANDE.wiki Revision: 377 Author: nw@retrocomputingtasmania.com Date: 11/23/2013 3:29:12 PM Message: couple of minor edits. ---- Modified : /wiki/WebUIHowToSetUpCANDE.wiki Revision: 376 Author: paul.kimpel@digm.com Date: 11/23/2013 2:31:52 PM Message: Commit Tim Sirianni's initial TSMCP/CANDE setup wiki page. ---- Added : /wiki/WebUIHowToSetUpCANDE.wiki Revision: 375 Author: paul.kimpel@digm.com Date: 11/20/2013 8:31:56 PM Message: Release wiki updates for version 0.16. ---- Modified : /wiki/WebUIGettingStarted.wiki Modified : /wiki/WebUIUsingDatacom.wiki Modified : /wiki/WebUIUsingTheCardReader.wiki Modified : /wiki/WebUIUsingTheMagTapeDrive.wiki Modified : /wiki/images/B5500-Datacom-Terminal.png Modified : /wiki/images/MagTape-Drive-burr0136.jpg Revision: 368 Author: paul.kimpel@digm.com Date: 11/14/2013 10:01:36 PM Message: Fix mark-up error in WebUIUsingDatacom.wiki. ---- Modified : /wiki/WebUIUsingDatacom.wiki Revision: 366 Author: paul.kimpel@digm.com Date: 11/14/2013 9:32:55 PM Message: Wiki updates for emulator release 0.15. ---- Modified : /wiki/WebUIGettingStarted.wiki Modified : /wiki/WebUIRunningTheEmulator.wiki Added : /wiki/WebUIUsingDatacom.wiki (Copy from path: /wiki/WebUIUsingTheSPO.wiki, Revision, 356) Modified : /wiki/WebUIUsingTheConsole.wiki Modified : /wiki/WebUIUsingTheSPO.wiki Modified : /wiki/WebUIUsingTheCardPunch.wiki Modified : /wiki/WebUIUsingTheCardReader.wiki Added : /wiki/WebUIUsingTheLinePrinter.wiki (Copy from path: /wiki/WebUIUsingTheCardPunch.wiki, Revision, 353) Added : /wiki/WebUIUsingTheMagTapeDrive.wiki (Copy from path: /wiki/WebUIUsingTheCardReader.wiki, Revision, 353) Modified : /wiki/images/B5500-CardPunch.png Modified : /wiki/images/B5500-CardReader.png Added : /wiki/images/B5500-MagTapeDrive.png Added : /wiki/images/B5500-Datacom-Terminal.png Added : /wiki/images/MagTape-Drive-burr0136.jpg Added : /wiki/images/B5500-at-Stanford.jpg Revision: 356 Author: paul.kimpel@digm.com Date: 9/30/2013 5:19:36 AM Message: Wiki updates for version 0.13 UI changes. ---- Modified : /wiki/WebUIUsingTheConsole.wiki Modified : /wiki/WebUIUsingTheSPO.wiki Modified : /wiki/images/B5500-Console.png Modified : /wiki/images/B5500-SPO.png Added : /wiki/images/B5500-Console-Image.png Revision: 354 Author: paul.kimpel@digm.com Date: 9/2/2013 8:44:26 AM Message: Commit minor wiki corrections. ---- Modified : /wiki/WebUIGettingStarted.wiki Modified : /wiki/WebUIUsingTheSPO.wiki Revision: 353 Author: paul.kimpel@digm.com Date: 9/2/2013 8:09:49 AM Message: Commit accumulated wiki page updates as of 2013-09-02. ---- Modified : /wiki/WebUIGettingStarted.wiki Modified : /wiki/WebUIRunningTheEmulator.wiki Modified : /wiki/WebUIUsingTheConsole.wiki Modified : /wiki/WebUIUsingTheSPO.wiki Added : /wiki/images Added : /wiki/images/B5500-Console.png Added : /wiki/images/B5500-SPO.png Modified : /wiki/WebUIUsingTheCardPunch.wiki Modified : /wiki/WebUIUsingTheCardReader.wiki Added : /wiki/images/B5500-CardPunch.png Added : /wiki/images/B5500-CardReader.png Added : /wiki/images/B495-SPO-Image.png Added : /wiki/images/B5500-Console-Image.jpg Added : /wiki/images/ColdLoader-Disk-Database-Opened.png Added : /wiki/images/ColdLoader-Heading.png Added : /wiki/images/ColdLoader-Tape-File-List.png Revision: 346 Author: paul.kimpel@digm.com Date: 7/21/2013 12:23:29 PM Message: Created initial WebUIUsingTheSPO wiki page. ---- Added : /wiki/WebUIUsingTheSPO.wiki Revision: 345 Author: paul.kimpel@digm.com Date: 7/21/2013 12:13:31 PM Message: Create initial WebUIUsingTheConsole wiki page. ---- Added : /wiki/WebUIUsingTheConsole.wiki Revision: 344 Author: paul.kimpel@digm.com Date: 7/21/2013 12:00:36 PM Message: Miscellaneous revisions and corrections to WebUIUsingTheEmulator. ---- Modified : /wiki/WebUIRunningTheEmulator.wiki Revision: 343 Author: paul.kimpel@digm.com Date: 7/21/2013 11:28:57 AM Message: Miscellaneous revisions and corrections to WebUIGettingStarted. ---- Modified : /wiki/WebUIGettingStarted.wiki Revision: 342 Author: paul.kimpel@digm.com Date: 7/21/2013 11:26:24 AM Message: Created initial WebUIUsingTheCardReader wiki page stub. ---- Added : /wiki/WebUIUsingTheCardReader.wiki Revision: 341 Author: paul.kimpel@digm.com Date: 7/21/2013 11:25:23 AM Message: Created initial WebUIUsingTheCardPunch wiki page stub. ---- Added : /wiki/WebUIUsingTheCardPunch.wiki Revision: 336 Author: paul.kimpel@digm.com Date: 7/13/2013 9:13:20 PM Message: Create initial wiki page. ---- Added : /wiki/WebUIRunningTheEmulator.wiki Revision: 335 Author: paul.kimpel@digm.com Date: 7/13/2013 2:14:42 PM Message: Corrected link problems and minor typos. ---- Modified : /wiki/WebUIGettingStarted.wiki Revision: 334 Author: paul.kimpel@digm.com Date: 7/13/2013 1:49:23 PM Message: Created initial wiki page for webUI based on release 0.10. ---- Added : /wiki/WebUIGettingStarted.wiki Revision: 12 Author: nw@retrocomputingtasmania.com Date: 4/3/2012 2:48:03 AM Message: Created wiki page through web user interface. ---- Added : /wiki/B5500maxconfig.wiki Revision: 1 Author: Date: 3/4/2012 5:39:24 PM Message: Initial directory structure. ---- Added : /wiki Added : /branches Added : /tags Added : /trunk
This commit is contained in:
Paul Kimpel
@@ -1,26 +1,23 @@
|
||||
#summary Instructions for setting up the TSMCP and CANDE timesharing environment in the web-based emulator.
|
||||
#labels Burroughs,B5500,emulator,retro-b5500,TSMCP,CANDE,timesharing
|
||||
|
||||
= WebUI Setting Up TSMCP and CANDE =
|
||||
<wiki:toc max_depth="2"/>
|
||||
# WebUI Setting Up TSMCP and CANDE #
|
||||
|
||||
|
||||
= Introduction =
|
||||
|
||||
# Introduction #
|
||||
|
||||
This page describes how to add timesharing features to an existing emulator environment for the Burroughs B5500 system. At the end is a short sample session using the CANDE (Command and Edit) user interface.
|
||||
|
||||
== Prerequisites ==
|
||||
## Prerequisites ##
|
||||
|
||||
The procedure described below assumes you have the retro-B5500 emulator installed and set up with the default DCMCP (Datacom MCP) software as described in [WebUIGettingStarted WebUI Getting Started].
|
||||
The procedure described below assumes you have the retro-B5500 emulator installed and set up with the default DCMCP (Datacom MCP) software as described in [WebUI Getting Started](WebUIGettingStarted.md).
|
||||
|
||||
Before proceeding, you should have a basic familiarity with the emulator, SPO, card reader, and tape drive. See the following pages for information on these topics:
|
||||
|
||||
* [WebUIRunningTheEmulator Running the Emulator]
|
||||
* [WebUIUsingTheSPO Using the SPO]
|
||||
* [WebUIUsingTheCardReader Using the Card Reader]
|
||||
* [WebUIUsingTheMagTapeDrive Using the Magnetic Tape Drive]
|
||||
* [Running the Emulator](WebUIRunningTheEmulator.md)
|
||||
* [Using the SPO](WebUIUsingTheSPO.md)
|
||||
* [Using the Card Reader](WebUIUsingTheCardReader.md)
|
||||
* [Using the Magnetic Tape Drive](WebUIUsingTheMagTapeDrive.md)
|
||||
|
||||
== Background ==
|
||||
## Background ##
|
||||
|
||||
There were several variations of the MCP (Master Control Program) operating system used with the B5000 and B5500 computer systems over their long active lifetime. The original MCP for the B5000, released in early 1963, was somewhat limited, largely due to the severely restricted mass storage (two 32K-word drums) available on that system. The B5000 was a batch system, with most processing involving punched cards, magnetic tape, and possibly paper tape.
|
||||
|
||||
@@ -30,7 +27,7 @@ Data communications interface hardware became available for the B5500 shortly af
|
||||
|
||||
The DFMCP was enhanced to support this datacom equipment, becoming the Data Communications MCP (DCMCP). Its capabilities were oriented towards transaction processing, where multiple remote stations exchanged messages with one or more central server programs, rather than interactive timesharing.
|
||||
|
||||
== The TSMCP and CANDE ==
|
||||
## The TSMCP and CANDE ##
|
||||
|
||||
The DCMCP worked well in the environment it was designed for, but its approach to dynamic memory management was not well-suited for the user-oriented interactivity typical of a timesharing environment. To address that, Burroughs created another variation, the Timesharing MCP (TSMCP or TSSMCP).
|
||||
|
||||
@@ -49,36 +46,36 @@ With CANDE, users could create and edit source and text files, compile programs,
|
||||
The TSMCP and CANDE were quite popular on B5500s used by schools and universities. Some systems continued to run through the late 1970s and possibly into the early 1980s. Sites with heavy batch loads or more transaction-oriented datacom requirements tended to stick with the DCMCP. Both variations of the MCP continued to be supported and enhanced in parallel by Burroughs through the 1970s. Only one MCP could be run on a system at a time, but as we will see, it requires little more than a Halt/Load (reboot) to switch between them.
|
||||
|
||||
|
||||
= Overview of the Setup Process ==
|
||||
# Overview of the Setup Process #
|
||||
|
||||
CANDE consists of a main program (`CANDE/TSHARER`) and numerous helper programs that are invoked by the main program as needed to do time-consuming tasks, such as a compilation or file resequence, on behalf of a user. All this software is on the `SYSTEM` tape and must be loaded to disk before it can be run.
|
||||
|
||||
Once you have the necessary software loaded, you will need to set up two configuration files:
|
||||
|
||||
* *`SYSTEM/DISK`* describes the data communications circuit and station environment, and is used only by the TSMCP. Since the web-based emulator currently supports only one terminal device, that configuration file has a fixed configuration, as shown below. This file is maintained by the program `SYSDISK/MAKER`.
|
||||
* *`USER/CANDE`* defines the remote users. This file is used by CANDE. It is binary file containing the user's login name, password, and per-account information. This file is maintained by the program `USERS/CANDE`.
|
||||
* **`SYSTEM/DISK`** describes the data communications circuit and station environment, and is used only by the TSMCP. Since the web-based emulator currently supports only one terminal device, that configuration file has a fixed configuration, as shown below. This file is maintained by the program `SYSDISK/MAKER`.
|
||||
* **`USER/CANDE`** defines the remote users. This file is used by CANDE. It is binary file containing the user's login name, password, and per-account information. This file is maintained by the program `USERS/CANDE`.
|
||||
|
||||
CANDE only runs under the TSMCP, so the next requirement is to Halt/Load the system under that MCP. TSMCP also requires a different set of System Intrinsics. After creating the two files above, you must specify the new MCP and Intrinsics files to the system and Halt/Load the system to initiate the TSMCP.
|
||||
|
||||
Once TSMCP initialization finishes, you must then initiate CANDE. At that point you can log in using the terminal and start timesharing.
|
||||
|
||||
|
||||
= Setting Up the System =
|
||||
# Setting Up the System #
|
||||
|
||||
This section discusses the step-by-step process to prepare the web-based emulator for the TSMCP and CANDE, switch to the TSMCP, and initiate CANDE.
|
||||
|
||||
== Preparing the Configuration Files ==
|
||||
## Preparing the Configuration Files ##
|
||||
|
||||
This first step takes place outside of the emulator. Using your text editor of choice, prepare a text file for a card deck to create the `SYSTEM/DISK` file as follows:
|
||||
|
||||
{{{
|
||||
```
|
||||
?EXECUTE SYSDISK/MAKER
|
||||
?DATA CARD
|
||||
LINE,0,0,112,0,0,7,0,
|
||||
LINE,1,0,112,0,0,0,1,
|
||||
STA,0,0,0,0,"0","0",0,0,
|
||||
?END
|
||||
}}}
|
||||
```
|
||||
|
||||
The web-based emulator supports the B249/B487 interface, with a single terminal on DTTU #1, buffer #0. That adapter slot is configured to have a 112-character buffer.
|
||||
|
||||
@@ -93,11 +90,11 @@ Note the trailing commas ("`,`") on each of the cards. These are required. The o
|
||||
|
||||
The emulated terminal behaves as if it is connected on a switched circuit, although you can choose either option on its `LINE` card. The only behavioral difference is that if you configure the line as switched, TSMCP will automatically disconnect when you log out from CANDE.
|
||||
|
||||
The `SYSDISK/MAKER` program and format of the cards it processes is documented in Section 1 of the [http://bitsavers.org/pdf/burroughs/B5000_5500_5700/1058583_B5700_TSS_RefMan_Sep72.pdf Burroughs B5700 Time Sharing System Reference Manual].
|
||||
The `SYSDISK/MAKER` program and format of the cards it processes is documented in Section 1 of the [Burroughs B5700 Time Sharing System Reference Manual](http://bitsavers.org/pdf/burroughs/B5000_5500_5700/1058583_B5700_TSS_RefMan_Sep72.pdf).
|
||||
|
||||
Next, prepare another card deck to create the `USERS/CANDE` file:
|
||||
|
||||
{{{
|
||||
```
|
||||
?EXECUTE USER/CANDE
|
||||
?DATA CARD
|
||||
$NEW
|
||||
@@ -105,31 +102,31 @@ Next, prepare another card deck to create the `USERS/CANDE` file:
|
||||
PASSWORD "SECRET"
|
||||
NAME "USER NAME"
|
||||
NO CHARGE
|
||||
}}}
|
||||
```
|
||||
|
||||
Replace the text in the quoted strings with a user name, password, and display name of your choice. `$NEW` indicates that a new file will be created rather than an existing file being updated. `PASSWORD` and `NAME` are optional, and may be omitted. If no password is specified, you will log in with only your user name. `NO CHARGE` indicates that CANDE will not request a "charge code" (billing account number) as part of the log-in process.
|
||||
|
||||
You may create multiple user accounts by repeating the sequence of cards starting with the `$USER` card above.
|
||||
|
||||
There are a few additional options for configuring user accounts. The `USER/CANDE` program and format of the cards it processes is also documented in Section 1 of the [http://bitsavers.org/pdf/burroughs/B5000_5500_5700/1058583_B5700_TSS_RefMan_Sep72.pdf Burroughs B5700 Time Sharing System Reference Manual].
|
||||
There are a few additional options for configuring user accounts. The `USER/CANDE` program and format of the cards it processes is also documented in Section 1 of the [Burroughs B5700 Time Sharing System Reference Manual](http://bitsavers.org/pdf/burroughs/B5000_5500_5700/1058583_B5700_TSS_RefMan_Sep72.pdf).
|
||||
|
||||
== Loading the System Software Files ==
|
||||
## Loading the System Software Files ##
|
||||
|
||||
The next step is to load the necessary files from the Mark XIII `SYSTEM` tape image file. You should already have this file from the original setup for the DCMCP, as described in [WebUIGettingStarted WebUI Getting Started].
|
||||
The next step is to load the necessary files from the Mark XIII `SYSTEM` tape image file. You should already have this file from the original setup for the DCMCP, as described in [WebUI Getting Started](WebUIGettingStarted.md).
|
||||
|
||||
First, Halt/Load the system to the DCMCP and set the date and time as necessary. You can also do the following steps under the TSMCP, but you will still need to Halt/Load after building the configuration files.
|
||||
|
||||
Load the `SYSTEM` tape image file into the tape drive (MTA window) by clicking the *LOAD* button on the drive, selecting the file, and then clicking the *REMOTE* button. You can confirm that the tape is loaded and ready by entering the following SPO command, but this is not necessary:
|
||||
Load the `SYSTEM` tape image file into the tape drive (MTA window) by clicking the **LOAD** button on the drive, selecting the file, and then clicking the **REMOTE** button. You can confirm that the tape is loaded and ready by entering the following SPO command, but this is not necessary:
|
||||
|
||||
{{{
|
||||
```
|
||||
OL MTA
|
||||
}}}
|
||||
```
|
||||
|
||||
CANDE requires quite a few files, and the easiest thing to do is simply load everything from the `SYSTEM` tape. With the tape loaded in the drive, enter the following command on the SPO:
|
||||
|
||||
{{{
|
||||
```
|
||||
CC ADD FROM SYSTEM =/=; END
|
||||
}}}
|
||||
```
|
||||
|
||||
The `ADD` command will copy only those files that are not already present on disk. You can substitute `LOAD` for `ADD`, which will copy all the files specified, generally overwriting any existing files. This is safe to do, as MCP Library/Maintenance will not overwrite critical files, such as the running MCP.
|
||||
|
||||
@@ -137,130 +134,131 @@ Copying the files to disk will take a few minutes and output many messages to th
|
||||
|
||||
If you wish to do a more targeted load, you will need the following files:
|
||||
|
||||
{{{
|
||||
```
|
||||
CC ADD FROM SYSTEM TSS/MCP, TSS/INT, USERS/CANDE, SYSDISK/MAKER, -
|
||||
CANDE/TSHARER, FIND/DISK, GUARD/DISK, =/CANDE; END
|
||||
}}}
|
||||
```
|
||||
|
||||
Note the "`-`" at the end of the first line, which allows continuation of a control command. You should also load any additional compilers or utility programs you will want to use, e.g., `ALGOL/DISK`, `BASIC/DISK`, `COBOL/DISK`, `COBOL68/DISK`, `FORTRAN/DISK`, or `XALGOL/DISK`.
|
||||
|
||||
== Building the Configuration Files ==
|
||||
## Building the Configuration Files ##
|
||||
|
||||
Create the two configuration files, `SYSTEM/DISK` and `USERS/CANDE` by loading the card deck files you created above into the card reader and clicking the reader's *START* button. The decks can be run in any order. You can load both decks into the reader at the same time, if you wish.
|
||||
Create the two configuration files, `SYSTEM/DISK` and `USERS/CANDE` by loading the card deck files you created above into the card reader and clicking the reader's **START** button. The decks can be run in any order. You can load both decks into the reader at the same time, if you wish.
|
||||
|
||||
Make sure you resolve any errors in these decks before proceeding. CANDE will not start without both files present.
|
||||
|
||||
== Initiating TSMCP and CANDE ==
|
||||
## Initiating TSMCP and CANDE ##
|
||||
|
||||
The next step is to designate the MCP and Intrinsics files that should be
|
||||
used at the next Halt/Load. Enter the following two commands on the SPO:
|
||||
on the SPO:
|
||||
|
||||
{{{
|
||||
```
|
||||
CM TSS/MCP
|
||||
CI TSS/INT
|
||||
}}}
|
||||
```
|
||||
|
||||
These commands modify the bootstrap information in sector 0 of the disk. You should see responses similar to this:
|
||||
|
||||
{{{
|
||||
```
|
||||
CM TSS/MCP
|
||||
NEXT MCP WILL BE TSS/MCP
|
||||
CI TSS/INT
|
||||
NEW INTRINSIC FILE IS: TSS/INT.
|
||||
}}}
|
||||
```
|
||||
|
||||
Now reboot the system by switching to the emulator's Console window and clicking first the *HALT* button and then the *LOAD* button (this is why it's called a Halt/Load). You should see a message indicating the TSMCP is now running. After initialization completes, enter the date and time as necessary:
|
||||
Now reboot the system by switching to the emulator's Console window and clicking first the **HALT** button and then the **LOAD** button (this is why it's called a Halt/Load). You should see a message indicating the TSMCP is now running. After initialization completes, enter the date and time as necessary:
|
||||
|
||||
{{{
|
||||
```
|
||||
-H/L WITH TSS/MCP MARK XIII,F=16384[MODS=RRRRRRRR]-
|
||||
TIME IS 1429
|
||||
DATE IS THURSDAY, 11/17/83
|
||||
#TR PLEASE
|
||||
TR 1431
|
||||
TIME IS 1431
|
||||
}}}
|
||||
```
|
||||
|
||||
The "`F=16384`" indicates the fence location in memory. The value shown is the default if the fence was not specified at Cold Start time. You can change this value at any time using the `MF` SPO command, but it will only take effect at the next Halt/Load. Fence values must be in the range 8184 to 28644. Lower values give more memory to the swap areas for batch and interactive user programs. Higher values give more memory to the MCP and CANDE handler program. The default value is a good one to start with.
|
||||
|
||||
To switch back to the DCMCP, simply designate its MCP and intrinsics files and do another Halt/Load. The fence location is ignored by the DCMCP:
|
||||
|
||||
{{{
|
||||
```
|
||||
CM MCP/DISK
|
||||
CI INT/DISK
|
||||
}}}
|
||||
```
|
||||
|
||||
Once the TSMCP has initialized, you can initiate CANDE with the following SPO command:
|
||||
|
||||
{{{
|
||||
```
|
||||
CE
|
||||
}}}
|
||||
```
|
||||
|
||||
You should see the CANDE handler enter the mix and output its initialization message:
|
||||
|
||||
{{{
|
||||
```
|
||||
0:CANDE/TSHARER/SITE= 1 BOJ 1516
|
||||
USERS/CANDE FILE DATED 00111783
|
||||
}}}
|
||||
```
|
||||
|
||||
This indicates that CANDE is running and ready for use.
|
||||
|
||||
|
||||
= Using CANDE =
|
||||
# Using CANDE #
|
||||
|
||||
A typical B5500 timesharing system supported 20-30 users. The web-based emulator supports only one terminal, though, so only one user at a time can be signed on to CANDE in this environment. More information on using the emulated terminal can be found in the [WebUIUsingDatacom Using Datacom] wiki page.
|
||||
A typical B5500 timesharing system supported 20-30 users. The web-based emulator supports only one terminal, though, so only one user at a time can be signed on to CANDE in this environment. More information on using the emulated terminal can be found in the [Using Datacom](WebUIUsingDatacom.md) wiki page.
|
||||
|
||||
Note that six of the 64 characters in the B5500 character set were used as control characters by the teletype adapter hardware, and could not be used for their normal purpose in user program text and output messages:
|
||||
|
||||
|| *Terminal* || *B5500 graphic* || *Input* || *Output* ||
|
||||
|| `}` || greater-or-equal || ignored || disconnect switched line ||
|
||||
|| `{` || less-or-equal || ignored || carriage return ||
|
||||
|| `!` || not-equal || disconnect || line feed ||
|
||||
|| `>` || greater-than || ignored || X-on (ASCII DC1) ||
|
||||
|| `<` || less-than || backspace || RUBOUT (ASCII DEL) ||
|
||||
|| `~` || left-arrow || end of message || end of message ||
|
||||
| **Terminal** | **B5500 graphic** | **Input** | **Output** |
|
||||
|:-------------|:------------------|:----------|:-----------|
|
||||
| `}` | greater-or-equal | ignored | disconnect switched line |
|
||||
| `{` | less-or-equal | ignored | carriage return |
|
||||
| `!` | not-equal | disconnect | line feed |
|
||||
| `>` | greater-than | ignored | X-on (ASCII DC1) |
|
||||
| `<` | less-than | backspace | RUBOUT (ASCII DEL) |
|
||||
| `~` | left-arrow | end of message | end of message |
|
||||
|
||||
See pages 3-15 and 3-16 in the [http://bitsavers.org/pdf/burroughs/1031986_B5500_Handbook_Aug70.pdf B5500 Handbook] for information on the character substitutions used by the B249/B487.
|
||||
See pages 3-15 and 3-16 in the [B5500 Handbook](http://bitsavers.org/pdf/burroughs/1031986_B5500_Handbook_Aug70.pdf) for information on the character substitutions used by the B249/B487.
|
||||
|
||||
To begin a session, click the *Connect* button on the terminal (DCA) window. The button should light.
|
||||
To begin a session, click the **Connect** button on the terminal (DCA) window. The button should light.
|
||||
|
||||
== Logging In ==
|
||||
## Logging In ##
|
||||
|
||||
After connecting the terminal, you should see a welcome message from CANDE within a few seconds:
|
||||
|
||||
{{{
|
||||
```
|
||||
B5500 TIME SHARING - 01/00, STATION 02
|
||||
ENTER USER CODE, PLEASE-
|
||||
}}}
|
||||
```
|
||||
|
||||
Enter your user name as defined in the `USERS/CANDE` file. Officially, the end-of-message character for a teletype device was the left-arrow key (Shift-letter-O, "`~`" in the emulator), but as a convenience the emulator also supports using the *Enter* key. The terminal will echo a "`~`" in either case.
|
||||
Enter your user name as defined in the `USERS/CANDE` file. Officially, the end-of-message character for a teletype device was the left-arrow key (Shift-letter-O, "`~`" in the emulator), but as a convenience the emulator also supports using the **Enter** key. The terminal will echo a "`~`" in either case.
|
||||
|
||||
{{{
|
||||
```
|
||||
ENTER USER CODE, PLEASE-B5500~
|
||||
}}}
|
||||
```
|
||||
|
||||
CANDE will next request your password and output several sequences of characters on the same line of the terminal. On a teletype device, this would create an inky blob on the paper, which would obscure the password when it was entered. That doesn't work so well on a web page, so just enter your password on top of those characters, followed by end-of-message. If you did not specify a password for your user name, just key end-of-message by itself.
|
||||
|
||||
{{{
|
||||
```
|
||||
AND YOUR PASSWORD
|
||||
SECRET~@
|
||||
11/17/83 2:33 PM.
|
||||
GOOD AFTERNOON, USER NAME YOU HAVE STATION 02
|
||||
|
||||
#
|
||||
}}}
|
||||
```
|
||||
|
||||
At this point, you are logged in to CANDE and can begin entering commands. When you are finished with your session, enter `BYE` to log out. Alternatively, you can click the terminal's *Connect* button to disconnect.
|
||||
At this point, you are logged in to CANDE and can begin entering commands. When you are finished with your session, enter `BYE` to log out. Alternatively, you can click the terminal's **Connect** button to disconnect.
|
||||
|
||||
CANDE commands and use of the terminal under CANDE are documented in the
|
||||
[http://bitsavers.org/pdf/burroughs/B5000_5500_5700/1038205_B5500_TS_TerminalUG_Jun69.pdf Burroughs B5500 Time Sharing System Terminal User's Guide]. Note that the emulator does not presently support the paper tape terminal features described in this manual, particularly the CANDE `TAPE` command.
|
||||
[Burroughs B5500 Time Sharing System Terminal User's Guide](http://bitsavers.org/pdf/burroughs/B5000_5500_5700/1038205_B5500_TS_TerminalUG_Jun69.pdf). Note that the emulator does not presently support the paper tape terminal features described in this manual, particularly the CANDE `TAPE` command.
|
||||
|
||||
|
||||
== Sample CANDE Session ==
|
||||
## Sample CANDE Session ##
|
||||
|
||||
Here is a sample session, illustrating creating, compiling, and running a simple BASIC program. CANDE requires line numbers (more properly known as sequence numbers) on all lines of all files, not just those for BASIC:
|
||||
|
||||
{{{
|
||||
```
|
||||
CREATE FOO BASIC~
|
||||
FILE:FOO - TYPE:BASIC -- CREATED
|
||||
10FOR I = 1 TO 5~
|
||||
@@ -283,7 +281,7 @@ Here is a sample session, illustrating creating, compiling, and running a simple
|
||||
5 25
|
||||
|
||||
END FOO .4 SEC.
|
||||
}}}
|
||||
```
|
||||
|
||||
Note that the `RUN` command knows if the program source has not been compiled since it was last modified, and automatically recompiles before running it.
|
||||
|
||||
@@ -291,7 +289,7 @@ Now we edit the program slightly and recompile and rerun it. The "`*`" (`FIX`) c
|
||||
|
||||
Also note that multiple CANDE commands can be entered on one line, delimited by semicolons ("`;`"). Due to their nature, single-line entries (commands beginning with a sequence number) and `FIX` commands can appear only as the last command on a line.
|
||||
|
||||
{{{
|
||||
```
|
||||
*20/I*I/SQR(I)~
|
||||
LIST; RUN~
|
||||
|
||||
@@ -317,11 +315,11 @@ Also note that multiple CANDE commands can be entered on one line, delimited by
|
||||
5 2.236068
|
||||
|
||||
END FOO .3 SEC.
|
||||
}}}
|
||||
```
|
||||
|
||||
Here is a slightly larger example of an Algol program that implements the outrageously-recursive Ackermann function. Note the use of the CANDE `SEQ` (sequence) command to automatically supply line numbers and the "`<`" character as a backspace:
|
||||
|
||||
{{{
|
||||
```
|
||||
CREATE ACKMAN ALGOL~
|
||||
FILE:ACKMAN - TYPE:ALGOL -- CREATED
|
||||
SEQ 100100+100~
|
||||
@@ -359,13 +357,13 @@ Here is a slightly larger example of an Algol program that implements the outrag
|
||||
NEAR LINE 102300 ERROR NUMBER 100 -- F1.
|
||||
|
||||
ERR COMPILE .7 SEC.
|
||||
}}}
|
||||
```
|
||||
|
||||
Oops, we forgot to define the format `F1`. We will insert it by choosing a line number between two of the existing ones. Also, one of the `ELSE` clauses is indented too far, so we'll fix that as well.
|
||||
|
||||
Note that the `SEQ` command above was terminated by entering an empty line. A type-19 file declaration (line 101700) creates a datacom "remote" file, which is automatically assigned to the initiating terminal by the TSMCP.
|
||||
|
||||
{{{
|
||||
```
|
||||
101750FORMAT F1 (2I4,I12);~
|
||||
FIX 101200. .~
|
||||
RUN~
|
||||
@@ -404,13 +402,13 @@ Note that the `SEQ` command above was terminated by entering an empty line. A ty
|
||||
-STACK OVRFLW, LINE NO 101500
|
||||
|
||||
ERR ACKMAN .3 SEC.
|
||||
}}}
|
||||
```
|
||||
|
||||
The Ackermann function is so heavily recursive that the program ran out of stack space while trying to evaluate `ACKERMANN(3,4)`.
|
||||
|
||||
Now we will save what we have done thus far, list the current version of the program, and log off CANDE:
|
||||
|
||||
{{{
|
||||
```
|
||||
SAVE~
|
||||
FILE:ACKMAN - TYPE:ALGOL -- SAVED.
|
||||
|
||||
@@ -455,14 +453,14 @@ Now we will save what we have done thus far, list the current version of the pro
|
||||
OFF AT 2:36 PM.
|
||||
GOODBYE B5500
|
||||
11/17/83
|
||||
}}}
|
||||
```
|
||||
|
||||
|
||||
= Cold-Starting Directly to the TSMCP =
|
||||
# Cold-Starting Directly to the TSMCP #
|
||||
|
||||
This page has described how to set up TSMCP and CANDE after the B5500 emulator has already been cold-started with the DCMCP. It is also possible to Cold Start directly to the TSMCP.
|
||||
|
||||
Peter Grootswagers has prepared a very nice set of instructions for cold-starting directly to TSMCP. This is available on the [http://groups.google.com/group/retro-b5500 retro-B5500 forum], dated 20 November 2013. The direct link to the post with his instructions is [https://groups.google.com/forum/#!topic/retro-b5500/zCBSxow113M].
|
||||
Peter Grootswagers has prepared a very nice set of instructions for cold-starting directly to TSMCP. This is available on the [retro-B5500 forum](http://groups.google.com/group/retro-b5500), dated 20 November 2013. The direct link to the post with his instructions is https://groups.google.com/forum/#!topic/retro-b5500/zCBSxow113M.
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user