Versions Compared

Key

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

...


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

...

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

...

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:

...

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 folderThe container name length must not be more than 255 characters, 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:

...

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