Anchor

	TopUtilPageTOCTopUtilPage
	TOC

Include Page

	KBCOMMON:KB-CSSstyle
	KBCOMMON:KB-CSSstyle

General Description

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.

It is not recommended to use the IDLE utility in real-time process control environmentsThe "CHARON Guest Utilities for OpenVMS" (CHARONCP) package contains several utilities for managing virtual tapes, changing the emulator speed and creating useful definitions for that operations.

This set of utilities is located in the "idle_vms_pkgcharoncp013.vdisk" disk file in the "C:\Program Files\CHARON\Virtual Disk Images\idle_vms_pkg_v3.0".

Back to Table of Contents

Installation

...

Tape utilities package" folder.

Supported OpenVMS versions: OpenVMS 6.1 and above.

In case of OpenVMS upgrade, CHARONCP will have to be re-installed.

Installation

Make this virtual disk file recognized by the virtual machine in the CHARON configuration file, boot from the system disk and mount the disk with the following OpenVMS command:

$ MOUNT <device name> /OVERRIDE=IDENTIFICATION

In the [.AXP] folder of this disk you will see the following files:

README.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:

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

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

Issue the following commands to install the package (example given for OpenVMS V8.4):

$ @SYS$UPDATE:VMSINSTAL

...

* Are you satisfied with the backup of your system disk [YES]? YES
* Where will the distribution volumes be mounted: <device name>:[CHARONCP013.KIT]

Enter the products to be processed from the first distribution volume set.
* Products: CHARONCP013

* Enter installation options you wish to use (none): <press enter>

...

Do you want to install this product [NO]? YES

...

* Where should the CHARONCP root directory be located ? [SYS$SYSDEVICE:[CHARONCP]]: <press enter>

...

* Do you want to purge files replaced by this installation [YES]? <press enter>

Div

class	pagebreak

Select all the components included in the package:

Component Selection

Select the CHARONCP components you wish to install from the menu below.
An asterisk appears next to the packages that have already been
selected. You can remove a package from the list by selecting it
again. You may enter more than one selection by separating your
choices with commas.

1. [*] CHARONCP Guest Utility (REQUIRED)
2. [*] Compatability Utilities
3. [*] Install DCL Commands & Help

4. Exit

* Your choice [4]: 1,2,3

...

* Your choice [4]: 4

...

* Is this correct [YES]: <press enter>

...

* Products:<press enter>

VMSINSTAL procedure done at hh:mn

$

Proceed with installation using all the default options.

Once the installation is completed, add the following line to the "SYS$STARTUP:SYSTARTUP_VMS.COM" file for the package to be loaded automatically at system startup:

$ @SYS$STARTUP:CHARONCP_STARTUP

Include Page

	KBCOMMON:DOC-GoToToc
	KBCOMMON:DOC-GoToToc

Performance optimization

CHARON takes 100% of host CPU even in case of idle state of guest OpenVMS operating system. To get rid of such resources consumption there is a specific option provided by CHARON Guest Utilities: "idle" mode.

To load the OpenVMS idle loop detection software, use:

$ CHARONCP SET IDLE /ENABLE

This allows CHARON to detect when the emulated CPU(s) are idle and use the host power saving instructions to reduce power usage.

To unload the OpenVMS idle loop detection software, use:

$ CHARONCP SET IDLE /DISABLE

Include Page

	KBCOMMON:DOC-GoToToc
	KBCOMMON:DOC-GoToToc

Div

class	pagebreak

Virtual tapes management

Specify mapping to tape container in the following way in the CHARON configuration file:

set <adapter name> container[<unit name>] = ".vtape" removable[<unit name>] = true

Warning
It is mandatory to set the "`removable`" parameter to "`true`" The container name must be "`.vtape`", no name and path must be specified, only extension.

Example:

set PKA container[600] = ".vtape" removable[600] = true

Once it is done using the following commands it is possible to manage virtual tapes attached to CHARON.

To create the specified host-file (if it does not already exist) and attach it to the specified virtual tape device, use:

$ CHARONCP SET MAGTAPE <device> /LOAD="<filename>.vtape"

The container name specified in the /LOAD parameter must not be more than 255 characters

Example:

$ CHARONCP SET MAGTAPE MKA600: /LOAD="E:\Charon\Tapes\backup_01.vtape"

To detach any file currently attached to te specified virtual tape device, use:

$ CHARONCP SET MAGTAPE <device> /UNLOAD

Example:

$ CHARONCP SET MAGTAPE MKA600: /UNLOAD

Possible error Description

BADFILENAME The filename specified as a value to the qualifier /LOAD was either too long or does not have a file extension of ".vtape".

DEVNOTDISM

Attempting to execute a SET MAGTAPE/LOAD command when a file is already attached.

Perform a SET MAGTAPE/UNLOAD first. If a SET MAGTAPE/LOAD command has not previously been executed then the CHARON configuration container specification for the tape device may contain a full path. Doing this will create and attach and initial tape container file. To avoid this, remove the file name from the specification (leaving only a file extension of ".vtape" and optional directory).

If some tape container has been already specified in the CHARON configuration file, use the command "CHARONCP SET MAGTAPE <device> /UNLOAD" to unload it first.

Include Page

	KBCOMMON:DOC-GoToToc
	KBCOMMON:DOC-GoToToc

Div

class	pagebreak

Defining keys

It is possible to define certain keys on the terminal keyboard for fast access to the CHARONCP functionality while you are in CHARONCP.

To define an equivalence string and a set of attributes with a key on the terminal keyboard, use:

$ CHARONCP
CHARONCP> DEFINE /KEY <key-name> <equivalence-string>

You can have a set of keys defined automatically for use with the CHARONCP utility by placing DEFINE/KEY commands in the SYS$LOGIN:CHARONCP_KEYDEFS.INI file.

Example:

$ CHARONCP
CHARONCP> DEFINE /KEYF1 "SET MAGTAPE MKA600: /UNLOAD"

To display key definitions created with the DEFINE/KEY command, use:

$ CHARONCP
CHARONCP> SHOW KEY <key-name>

Refer to the DCL help entry for SHOW KEY for further information.

Example:

$ CHARONCP

CHARONCP> SHOW KEY F1
DEFAULT key state definitions:

F1 = "set magtape mka600: /unload"
CHARONCP>

For more information refer to the OpenVMS DCL Dictionary (DEFINE/KEY section).

Include Page

	KBCOMMON:DOC-GoToToc
	KBCOMMON:DOC-GoToToc

Displaying version

To display the CHARONCP package version number and architecture, use:

$ CHARONCP SHOW VERSION

This can be useful for customers reporting issues with the CHARONCP software.

Example:

$ CHARONCP SHOW VERSIONCHARONCP version id is: V1.3

Include Page

	KBCOMMON:DOC-GoToToc
	KBCOMMON:DOC-GoToToc

Versions Compared

Old Version 1

New Version Current

Key

Table of Contents

General Description

Installation

Installation

Deinstallation

Performance optimization

Virtual tapes management

Defining keys

Displaying version

Page Comparison

Versions Compared

Old Version 1

New Version Current

Key

Table of Contents

General Description

Installation

Installation

Deinstallation

Performance optimization

Virtual tapes management

Defining keys

Displaying version