Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: example corrected for Linux

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

...

This set of utilities is located in the "charoncp011charoncp012.vdisk" disk file in the "/opt/charon/disks" folder.

Supported OpenVMS versions (depending on platform support): OpenVMS 6.1 and above.

...

$ @SYS$UPDATE:VMSINSTAL

...

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

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

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

Back to Table of Contents

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.
Back to Table of Contents

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


Div
classpagebreak


Adjusting emulator's speed

...

$ 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

...

$ 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.

...

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

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 either be ".vtape" (and nothing else) or a valid file name (Example: "/charon/tapes/mytape.vtape") with an existing folder
  • The container name length must not be more than 255 characters

Example:

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

...

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

...

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:

...

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

Back to Table of Contents

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.1

...

2


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