Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Include Page
KBCOMMON:KB-CSSstyle
KBCOMMON:KB-CSSstyle

Table of Contents

Table of Contents
excludeTable of Contents

Back to Table of Contents

General Description

The CHARON Performance Improvement Package is a collection of the following utilities for VAX/VMS:

  1. IDLE
  2. SHUTDOWN
  3. SHUTDOWN_R
  4. SPEEDUP
  5. SLOWDOWN
  6. SLOWDOWN_R
  7. SLOW_TEST

...

IDLE utility significantly reduces the CHARON-AXP host CPU usage whenever a OpenVMS system is running on CHARON-AXP is idle.

The utility stalls the emulated CPU when it detects an OpenVMS idle condition. While IDLE utility is running the emulated CPU consumes, on average, less host system CPU time.

(warning) It is not recommended to use the IDLE utility in real-time process control environments.

This set of utilities is located in the "idle_vms_pkg.vdisk" disk file in the "C:\Program Files

...

\CHARON\Virtual Disk Images\idle_vms_pkg_

...

v3.0"

...

.

...

Back to Table of Contents

Usage

Installation

Specify this image in the CHARON-VAX configuration AXP configuration file, boot from the system disk and mount the disk with the following VAX/VMS following OpenVMS command:

$ MOUNT <device name> /OVERRIDE=IDENTIFICATION

In the root [.AXP] folder 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
README.
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.EXEIDLE.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.EXEStops CHARON-VAX 3 minutes after the utility is called.SHUTDOWN5.EXEStops CHARON-VAX/XX 5 minutes after the utility is called.SHUTDOWN_R.EXECancels a pending request to SHUTDOWN.SLOWDOWN.EXE

Slows down the CHARON-VAX execution. Repeated execution further slows down the execution.

SLOWDOWN_R.EXERestores 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.
To run any of these utilities issue the following command: 

 

$ RUN <name of the utility>.EXE

or

$ @<name of the utility>.COM
Note

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
TXT
SRI-AXPVMS-IDLE-V0102–1.PCSI
VMS62TO71U2_PCSI-V0200.PCSI-DCX_AXPEXE
VMS62TO71U2_PCSI-V0200.TXT

If the OpenVMS version is less than 7.1 the following steps must be applied:

  1. Copy the "VMS62TO71U2_PCSI-V0200.PCSI-DCX_AXPEXE" file to some directory on any spare disk and run this file from there:

    $ COPY VMS62TO71U2_PCSI-V0200.PCSI-DCX_AXPEXE SYS$DISK:[000000.TEMP]
    $ SET DEF SYS$DISK:[000000.TEMP]
    $ RUN
    VMS62TO71U2_PCSI-V0200.PCSI-DCX_AXPEXE
  2. Install the patch:

    $ PRODUCT INSTALL VMS62TO71U2_PCSI /SOURCE=SYS$DISK:[000000.TEMP]

If the patch has been installed return to the "[000000.AXP]" directory of the "idle_vms_pkg.vdisk" and proceed with installation of the "Idle" utility itself:

$ PRODUCT INSTALL IDLE /SOURCE=<directory containing the IDLE kit>

Once IDLE utility is installed it starts to take effect immediately, reducing the host system CPU usage if OpenVMS system running on CHARON-AXP is idle. No reboot is required.

The utility is loaded automatically on reboot, no additional configuration or startup sequence is needed.

Back to Table of Contents

Deinstallation

Issue the following command to deinstall IDLE utility:

$ PRODUCT REMOVE IDLE

The will utility stop working on next system reboot.

Please also refer to the supplied documents "README.TXT" and "VMS62TO71U2_PCSI-V0200.TXT" for more details.

Back to Table of Contents