Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: CHARON Guest Utilities for OpenVMS is added

...

UtilityDescription
mkdskcmd

Used to create CHARON virtual disk containers of custom or standard types.

This utility also may be used to transfer virtual disks of one type to virtual disks of another type.

hasp_srm_view

Used to display the CHARON license contents, to collect the host system fingerprint and to transfer software licenses from one host to another.

hasp_update

Sentinel standard utility used to retrieve Sentinel protection key information, detach a license from a Sentinel SL key and rehost a license from a Sentinel SL key

ncu

Used to dedicate a host interface to CHARON-AXP, to release it back to the host and to manage CHARON virtual interfaces (TAPs).

mtd

Used to create CHARON tape images from physical tapes and to write tape images back to physical tapes.

CHARON Guest Utilities for OpenVMSUsed to manage virtual tapes and CHARON performance.

All these utilities are invoked from Linux console command line.

...

Enter "8" to quit "ncu" utility.

Back to Table of Contents

Anchor
charoncp
charoncp
CHARON Guest Utilities for OpenVMS

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.

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

Back to Table of Contents

Installation

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

$ MOUNT <device name> /OVERRIDE=IDENTIFICATION


Issue the following commands to install the package:

$ @SYS$UPDATE:VMSINSTALL

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

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

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]: 4

Proceed with installation using all the default options.

Once the installation is completed, update "SYSTARTUP_VMS.COM" file with the following line:

$ @SYS$STARTUP:CHARONCP_STARTUP

After that the package will be loaded automatically on startup.

Back to Table of Contents

Virtual tapes management

Using the following commands it is possible to manage virtual tapes attached to CHARON:

CommandDescription
$ 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 MKA600: /LOAD=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

Possible errors:

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.

Back to Table of Contents

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:

CommandDescription

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

Back to Table of Contents

Displaying version

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


Back to Table of Contents