Table of Contents
Conventions
Throughout the document(s) these conventions are followed
Notation | Description |
$ | The dollar sign in interactive examples indicates an operating system prompt for VMS. The dollar sign can also indicate non superuser prompt for UNIX / Linux. |
# | The number sign represents the superuser prompt for UNIX / Linux. |
| > | The right angle bracket in interactive examples indicates an operating system prompt for Windows command (cmd.exe). |
| Bold monospace type in interactive examples indicates typed user input. |
| Bold monospace type enclosed by angle brackets indicates command parameters and parameter values. |
| Monospace type in interactive examples, indicates command response output. |
[ ] | In syntax definitions, brackets indicate items that are optional. |
... | In syntax definitions, a horizontal ellipsis indicates that the preceding item can be repeated one or more times. |
| Italic monospace type, in interactive examples, indicates typed context dependent user input. |
The following definitions apply
| Term | Description |
|---|---|
| Host | The system on which the emulator runs, also called the Charon server |
| Guest | The operating system running on a Charon instance, for example, Tru64 UNIX, OpenVMS, Solaris, MPE or HP-UX |
General Description
The CHARON Performance Improvement Package is a collection of the following utilities for VAX/VMS:
- IDLE
- SHUTDOWN
- SHUTDOWN_R
- SPEEDUP
- SLOWDOWN
- SLOWDOWN_R
- SLOW_TEST
These utilities are located in the "idle_vms_pkg.vdisk" disk file in the "C:\Program Files (x86)\CHARON\Virtual Disk Images\idle_vms_pkg_v2.0" folder. (Windows x64; for Windows x86 the path is: "C:\Program Files \CHARON\Virtual Disk Images\idle_vms_pkg_v2.0").
Usage
Specify this image in the CHARON-VAX configuration file, boot from the system disk and mount the disk with the following VAX/VMS command:
$ MOUNT <device name> /OVERRIDE=IDENTIFICATION |
In the root of this disk you will see the following executable files and the COM file designed for the VAX/VMS system running on CHARON-VAX:
| Utility | Description |
|---|---|
| IDLE.EXE | Significantly reduces the CHARON-VAX/XX host CPU usage whenever a VAX/VMS system running on CHARON-VAX is idle. To ensure this is automatically started, you may include a call to the IDLE.EXE in the system startup file. IDLE.EXE stalls the emulated CPU when it detects an OpenVMS idle condition. While IDLE.EXE is running the emulated CPU consumes, on average, less host system CPU time. It is not recommended to employ IDLE.EXE in real-time process control environments. Note: IDLE.EXE cannot be used with the VAX 6xx0 emulators. |
| IDLE_VMS55.EXE | IDLE.EXE version for the VMS 5.5-2 and VMS 5.5-2H4 instances. |
| SHUTDOWN.EXE | Stops the CHARON-VAX emulator 30 seconds after the utility is invoked. These 30 seconds are intended to be used to shutdown the VAX/VMS system running on CHARON-VAX. |
| SHUTDOWN3.EXE | Stops CHARON-VAX 3 minutes after the utility is called. |
| SHUTDOWN5.EXE | Stops CHARON-VAX/XX 5 minutes after the utility is called. |
| SHUTDOWN_R.EXE | Cancels a pending request to SHUTDOWN. |
| SLOWDOWN.EXE | Slows down the CHARON-VAX execution. Repeated execution further slows down the execution. |
| SLOWDOWN_R.EXE | Restores the normal CHARON-VAX/XX execution speed. |
| SPEEDUP.EXE | Raises CHARON-VAX execution speed by a certain amount of steps. Only works if SLOWDOWN.EXE has been applied. |
| SLOW_TEST.COM | A test that demonstrates the effect of the CHARON slowdown mechanism. |
$ RUN <name of the utility>.EXE |
or
$ @<name of the utility>.COM |
The SHUTDOWNn.EXE routines do not initiate the shutdown of the VAX/VMS system running on CHARON-VAX, only of the emulator itself.
Establish a VMS shutdown procedure that can complete within the specified time