...
This set of utilities is located in the "charoncp011.vdisk" disk file in the "/opt/charon/disks" folder.
Supported OpenVMS versions (depending on platform support): VMS 5.5-2, OpenVMS 6.1 and above.
In case of OpenVMS upgrade, CHARONCP will have to be re-installed.
...
Issue the following commands to install the package (example given for OpenVMS V8.4):
...
...
...
|
| Div | ||
|---|---|---|
| ||
Select all the components included to 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" ("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.
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 /DISABLE | Unloads the OpenVMS idle loop detection software. |
| Div | ||
|---|---|---|
| ||
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 /RESET | Remove all speed stepping restraints. |
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 /RESET | Clear a scheduled shutdown. |
Virtual tapes management
Specify mapping to tape container in the following way in the CHARON configuration file:
...
$ 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:
|
| Div | ||
|---|---|---|
| ||
Possible errors:
| 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 fileextension of ".vtape" and optional directory). |
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.
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:
...
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:
|