Versions Compared

Key

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

...

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

Div
classpagebreak


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 folder, no name and path must be specified, only extension.
  • The container name length must not be more than 255 characters

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"

Example:

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


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

...

Example:

$ CHARONCP SET MAGTAPE MKA600: /UNLOAD


Possible errorDescription
BADFILENAMEThe 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 command 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).

...