Table of Contents
General Description
The "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 "charoncp013.vdisk" disk file in the "C:\Program Files\CHARON\Virtual Disk Images\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 |
Issue the following commands to install the package (example given for OpenVMS V8.4):
...
...
...
|
Select all the components included in the package:
...
...
...
|
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 |
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.
| Command | Description |
|---|---|
$ CHARONCP SET IDLE /ENABLE | 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. |
$ CHARONCP SET IDLE /DISABLE | Unloads the OpenVMS idle loop detection software. |
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 |
It is mandatory to set the "removable" parameter to "true"
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:
| Command | Description | |
|---|---|---|
$ CHARONCP SET MAGTAPE <device> /LOAD="<filename>.vtape" | Create the specified host-file (if it does not already exist) and attach it to the specified virtual tape device. Example:
| |
$ CHARONCP SET MAGTAPE <device> /UNLOAD | Detach any file currently attached to te specified virtual tape device. Example:
|
Possible errors:
| Error | Description |
|---|---|
| BADFILENAME | The filename specified as a value to the qualifier |
| DEVNOTDISM | Attempting to execute a Perform a |
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.
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:
| Command | Description | |
|---|---|---|
| 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 Example:
| |
$ CHARONCPCHARONCP> SHOW KEY <key-name> | Displays key definitions created with the Example:
|
Displaying version
| Command | Description | |
|---|---|---|
$ CHARONCP SHOW VERSION | Displays the CHARONCP package version number and architecture. This can be useful for customers reporting issues with the CHARONCP software. Example:
|