Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: .vtape part updated

...

To load the OpenVMS idle loop detection software, use:

$ CHARONCP SET IDLE /ENABLE

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

To unload the OpenVMS idle loop detection software, use:

$ CHARONCP SET IDLE /DISABLE


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

Adjusting emulator's speed

CHARON speed can be adjusted using these commands.

To increase the emulator speed by the specified number of steps, use:

$ CHARONCP SET SPEED /UP=<number of steps>

To decrease the emulator speed by the specified number of steps, use:

$ CHARONCP SET SPEED /DOWN=<number of steps>

To remove all speed stepping restraints, use:

$ CHARONCP SET SPEED /RESET


Emulator's shutdown control

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

To specify the number of seconds before the CHARON emulator is to shut down, use:

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

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

To clear a scheduled shutdown, use:

$ CHARONCP SET SHUTDOWN /RESET

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: "D:\Charon\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.

To create the specified host-file (if it does not already exist) and attach it to the specified virtual tape device, use:

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

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

Example:

$ CHARONCP SET MAGTAPE MKA600: /LOAD="E:\Charon\Tapes\backup_01.vtape"

To detach any file currently attached to the specified virtual tape device, use:

$ CHARONCP SET MAGTAPE <device> /UNLOAD

Example:

$ CHARONCP SET MAGTAPE MKA600: /UNLOAD


Div
classpagebreak


.

Possible errorDescription
BADFILENAME

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

DEVNOTDISM

Attempting to execute a SET MAGTAPE/LOAD 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).

(info) 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.

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

div

classpagebreak

Defining keys

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

To define an equivalence string and a set of attributes with a key on the terminal keyboard, use:

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

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"

To display key definitions created with the DEFINE/KEY command, use:

$ CHARONCP
CHARONCP> SHOW KEY <key-name>

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

Div
classpagebreak


Displaying version

To display the CHARONCP package version number and architecture, use:

$ CHARONCP SHOW VERSION

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