Versions Compared

Old Version 14

changes.mady.by.user Kirill Nikolaev (Unlicensed)

Saved on

compared with

New Version Current

changes.mady.by.user Bruno Miretti (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Update for PDF export

Anchor
TOC
TOC
Include Page
KBCOMMON:KB-CSSstyle
KBCOMMON:KB-CSSstyle

Table of Contents

Table of Contents
excludeTable of Contents

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.

...

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

Installation

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

...


Div
classpagebreak


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

$ @SYS$STARTUP:CHARONCP_STARTUP

After that the package will be loaded automatically on 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.


$ 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 /DISABLEUnloads the OpenVMS idle loop detection software.

Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc


Div
classpagebreak


Adjusting emulator's speed

CHARON speed can be adjusted using these commands:

$ CHARONCP SET SPEED /UP=<number of steps>Increase the emulator speed by the specified number of steps.
$ CHARONCP SET SPEED /DOWN=<number of steps>Decrease the emulator speed by the specified number of steps.
$ CHARONCP SET SPEED /RESETRemove all speed stepping restraints.

Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc

Emulator's shutdown control

It is possible to schedule CHARON to shutdown directly from OpenVMS:

$ CHARONCP SET SHUTDOWN /IN=<seconds, 60 is default>

The number of seconds before the CHARON emulator is to shut down.

The value can be between 0 and 65535 (approx. 18 hours).

$ CHARONCP SET SHUTDOWN /RESETClear a scheduled shutdown.

...

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:

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

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

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

Example:

$ CHARONCP SET MAGTAPE MKA600: /LOAD="/charon/tapes/backup_01.vtape"


$ CHARONCP SET MAGTAPE <device> /UNLOAD

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

Example:

$ CHARONCP SET MAGTAPE MKA600: /UNLOAD



Div
classpagebreak


Possible errors:

...

Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc

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 file SYS$LOGIN:CHARONCP_KEYDEFS.INI

Example:

$ CHARONCP
CHARONCP> DEFINE /KEY F1 "SET MAGTAPE MKA600: /UNLOAD"


$ CHARONCP
CHARONCP> SHOW KEY <key-name>

Displays key definitions created with the DEFINE/KEY command. 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>


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

Displaying version

$ CHARONCP SHOW VERSION

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

Example:

$ CHARONCP SHOW VERSION

CHARONCP version id is: V1.3


Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc