Page Comparison

The "

Table of Contents

Back to Table of Contents

General Description

This set of utilities is located in the "charoncp011.vdisk" disk file in the "C:\Program Files\CHARON\Virtual Disk Images\Tape utilities package" folder.

Supported OpenVMS versions: OpenVMS 6.1 and above.

...

$ @SYS$UPDATE:VMSINSTAL

...


...

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

Back to Table of Contents

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:

...

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

* 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>

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

...

...

...

* 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" ("SYS$STARTUP:SYSTARTUP_V5.COM" for VMS 5.5) file for the package to be loaded automatically at system startup:

...

Back to Table of Contents

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.

...

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

...

Virtual tapes management

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

...

Example:

...

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

...

Create the specified host-file (if it does not already exist) and attach it to the specified virtual tape device.

Example:

...

Detach any file currently attached to te specified virtual tape device.

Example:

Possible errors:

...

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

...

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.

Back to Table of Contents

Defining keys

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

...

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

...

Defines an equivalence string and a set of attributes with a key on the terminal keyboard.

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:

...

Displays key definitions created with the DEFINE/KEY command. Refer to the DCL help entry for SHOW KEY for further information.

Example:

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

Back to Table of Contents

Displaying version

...

Displays the CHARONCP package version number and architecture. This can be useful for customers reporting issues with the CHARONCP software.

Example:

...