Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Screenshots are updated

...

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:

Image RemovedImage Added

"Start" menu shortcuts:

Image RemovedImage Added

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.

Image RemovedImage Added

Check the desired options and press "Allow access" button.

The CHARON icon will appear in the system tray menu:

Image RemovedImage Added

Next, the VAX/PDP11 emulated console will appear:

Image RemovedImage Added

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":
      Image Removed
      Image Added

  • 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:

Image RemovedImage Added

In the Launcher main interface,  click the "Browse" button to select the desired CHARON configuration file:

Image RemovedImage Added

Select the desired configuration file:

Image RemovedImage Added

The Launcher will display the CHARON model specified in the selected configuration file:

Image RemovedImage Added

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.

Image RemovedImage Added

Check the desired options and press "Allow access" button.

Next, the CHARON icon will appear in the system tray menu:

Image RemovedImage Added

Right after that the VAX/PDP11 emulated console will appear (in the default configuration. Some configurations may not assume console startup):

Image RemovedImage Added

The Launcher will display CHARON log file:

Image RemovedImage Added

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":
      Image Removed
      Image Added
    • Using this menu, it is also possible to halt the virtual VAX/PDP11, reset it or show its console if it has been closed

  • 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:

Image RemovedImage Added

In the "CHARON Launcher" main interface press "Browse" button to select CHARON configuration to be used by CHARON running as Windows service:

Image RemovedImage Added

Choose the desired CHARON configuration file to be installed as service:

Image RemovedImage Added

The Launcher will display the specific CHARON model name specified in the configuration file and enable management buttons:

Image RemovedImage Added

Press "Edit CFG file" button and edit (with standard "Notepad" program) the chosen configuration file:

...

Press "Install / Update service" button in the Launcher:

Image RemovedImage Added

A special dialog for adding new CHARON service will appear:

Image RemovedImage Added

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:

Image RemovedImage Added

It is also possible to start the "CHARON Service Manager" utility from the system tray menu:

Image RemovedImage Added

Include Page
PDC:CHARON-VAX/PDP11 for Windows - Start service
PDC:CHARON-VAX/PDP11 for Windows - Start service

...

Open up "CHARON Service Manager" utility from the "Start" menu:

Image RemovedImage Added

or from the system tray menu:

Image RemovedImage Added

Include Page
PDC:CHARON-VAX/PDP11 for Windows - Stop service
PDC:CHARON-VAX/PDP11 for Windows - Stop service

...

Start up the "CHARON Launcher" utility:

Image RemovedImage Added

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:

Image RemovedImage Added

The install / update dialog will appear:

...

Press "Update existing service" button:

Image RemovedImage Added

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:

Image RemovedImage Added

or from the system tray menu:

Image RemovedImage Added

(warning) 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:

Image RemovedImage Added

Confirm removal of the selected CHARON service by pressing the "Remove" button:

...