...
The CHARON installation procedure creates shortcuts on the desktop for so-called "default" VAX/PDP11 models model and shortcuts under "Start" menu for all VAX/PDP11 models included during installation.
Desktop shortcutsshortcut:
"Start" menu shortcuts:
To run a certain CHARON-VAX / CHARON-PDP model, double click the target model's desktop shortcut (or click on "Start" menu shortcut).
Depending on settings, Windows may display a Firewall warning dialog asking to confirm CHARON access to different networks.
Check the desired options and press "Allow access" button.
The CHARON icon will appear in the system tray menu:
Next, the VAX/PDP11 emulated console will appear:
If the CHARON icon in the system tray menu disappears, it means a critical error happened at run-time. In this case you have to analyze the CHARON log file, by default stored beside CHARON executables. The default location for log files is "C:\Program Files (x86)\CHARON\Build_XXX\x86" (x64) or "C:\Program Files\CHARON\Build_XXX\x86" (x86). The name of the log file depends on the model of emulated VAX/PDP11 and the date and time, for example "MicroVAX_3100_Model_98-20142015-08-05-14-40-51-000000000.log"
...
- Configuration with no changes to the template configuration file
Right click on CHARON icon in the system tray menu, choose "Stop & Exit":
Configuration file updated to enable "F6" button in configuration file to trigger exit from CHARON:
#----------------------------------------------------------------------------
#
# Uncomment to allow 'F6' to terminate the running emulator.
#
#----------------------------------------------------------------------------
set OPA0 stop_on = F6
- To exit, press "F6" in the console window
- Use CHARON icon tray menu as shown above
...
Running from the "CHARON Launcher" utility is very convenient during the debugging of your CHARON configuration. The utility shows CHARON log updates in real time. If RDP is used to connect to the CHARON host, the CHARON may not see the license; start CHARON as a Service instead. From the Launcher, CHARON runs as a User process which will terminate if the User logs off. The Service is a System process and will continue to run until stopped.
Start the Launcher:
In the Launcher main interface, click the "Browse" button to select the desired CHARON configuration file:
Select the desired configuration file:
The Launcher will display the CHARON model specified in the selected configuration file:
Now it is possible to run CHARON. Press "Run selected configuration" button.
Depending on system settings, Windows may display a Firewall warning dialog asking to confirm CHARON access to different networks.
Check the desired options and press "Allow access" button.
Next, the CHARON icon will appear in the system tray menu:
Right after that the VAX/PDP11 emulated console will appear (in the default configuration. Some configurations may not assume console startup):
The Launcher will display CHARON log file:
It is possible to scroll the log file to analyze possible problems.
...
- Configuration with no changes to the template configuration file
- Right click on CHARON icon in the system tray menu, choose "Stop & Exit":
Using this menu, it is also possible to halt the virtual VAX/PDP11, reset it or show its console if it has been closed
- Right click on CHARON icon in the system tray menu, choose "Stop & Exit":
Configuration file updated to enable "F6" button in configuration file to trigger exit from CHARON:
#----------------------------------------------------------------------------
#
# Uncomment to allow 'F6' to terminate the running emulator.
#
#----------------------------------------------------------------------------
set OPA0 stop_on = F6
- To exit, press "F6" in the console window
- Use CHARON icon tray menu as shown above
...
Open the "CHARON Launcher" utility from "Start" menu:
In the "CHARON Launcher" main interface press "Browse" button to select CHARON configuration to be used by CHARON running as Windows service:
Choose the desired CHARON configuration file to be installed as service:
The Launcher will display the specific CHARON model name specified in the configuration file and enable management buttons:
Press "Edit CFG file" button and edit (with standard "Notepad" program) the chosen configuration file:
...
Press "Install / Update service" button in the Launcher:
A special dialog for adding new CHARON service will appear:
Enter a new service name (in the example above it is "charon-3100") and press "Install" button. If the service has been installed correctly, a configration dialog box will appear:
...
CHARON service is installed, now let's configure it. Start the "CHARON Service Manager" utility:
It is also possible to start the "CHARON Service Manager" utility from the system tray menu:
Include Page | ||||
---|---|---|---|---|
|
...
Open up "CHARON Service Manager" utility from the "Start" menu:
or from the system tray menu:
Include Page | ||||
---|---|---|---|---|
|
...
Start up the "CHARON Launcher" utility:
In the "CHARON Launcher" utility, select the modified configuration file and run it as described above.
...
Once CHARON-VAX / CHARON-PDP has been completely stopped, press the "Install / Update service" button:
The install / update dialog will appear:
...
Press "Update existing service" button:
Select the service to update with the "Installed services list" drop-down box and press "Update" to apply.
...
To remove the CHARON-VAX / CHARON-PDP service, open the "CHARON Service Manager" utility from the "Start" menu:
or from the system tray menu:
Please note: before stopping the CHARON-VAX / CHARON-PDP service, shutdown the operating system running in CHARON-VAX / CHARON-PDP.
In the main window of the utility, select the CHARON service to remove ("charon-3100" in our example) and press the button with an exclamation sign on it:
Confirm removal of the selected CHARON service by pressing the "Remove" button:
...