Versions Compared

Key

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

Anchor
TOC
TOC
Include Page
KBCOMMON:KB-CSSstyle
KBCOMMON:KB-CSSstyle

...

Type of mappingDescription

virtualSCSI Controllers#virtual_scsi_disk

For disk image containers and physical disks

floppy_scsi_device73605069537433

For floppy drives

virtual_scsi_tape73605069537433

For tape image containers

virtual_scsi_cdrom73605069537433

For host CD-ROM and *.iso images

physical_scsi_device73605069537433

For physical tapes and other SCSI devices connected to a host

...


Using compressed folders to store virtual disks and tapes is not supported.

.

  • Local fixed disks (IDE, SATA)
    • "\\.\PhysicalDrive<X>", where X is 0, 1, …
    • "\\.\PhysicalDrive(DevID =XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX)"

      DevID addresses the target physical disk by its WWID (hexadecimal 128-bit identifier assigned to the disk drive by its manufacturer/originator).

      Example:

  • Parameter

    container[N]

    N=0…7

    Type

    Text String

    Value

    A string containing the device name to map to the emulator.

    • Disk images
      • [<path-name>"\"]<file-name>[".vdisk"]

        Format: A string containing the full path to a disk container.

        If only the name of the disk container is specified, CHARON-VAX will look for the container in the folder where the emulator executable resides, typically

        "C:\Program Files (x86)\CHARON\Build_XXXXX\x86" (Windows x64; for Windows x86 the path is "C:\Program Files\CHARON\Build_XXXXX\x86").

    Warning
    Div
    classsmall

    set pka_1 container="\\.\PhysicalDrive(DevID= 6008-05F3-0005-2950-BF8E-0B86-A0C7-0001)"


    .The WWID values can be obtained from "Host Device Check" utility ("All drives" section).

    note

    If the "Host Device Check" utility does not display any WWID, this means the target disk does not have one. Use the "\\.\PhysicalDrive<N>" mapping in this case.


  • iSCSI disks
    • "\\.\PhysicalDrive(iScsiTarget = <iSCSI target>, LUN = <LUN number>)"

      iScsiTarget addresses the disk by its iSCSI target name. LUN specifies LUN on connected iSCSI disk. 

      Example:

      Div
      classsmall

      set pka_2 container="\\.\PhysicalDrive(iScsiTarget= iqn.2008-04:iscsi.charon-target-test1, LUN= 1)"

      .

  • This parameter is initially not set, thus creating NO storage elements on the controller

    ...

    When a virtual SCSI disk image is dismounted in VMS, it is no longer open by CHARON and may be copied. This capability can be useful when designing back-up and restore procedures. If copying CHARON-VAX disk images while CHARON-VAX is running, take care to minimize the risk of overloading the host system.

    ...

    Unlike MSCP controlled disk images, a disk image connected to a SCSI controller as a virtual SCSI disk CANNOT be replaced by another disk image unless "removable" parameter is set for this particular disk image.

    Example:

    set pka_0 container[2] = "C:\Charon\Disks\my_removable_disk.vdisk"
    set pka_0 removable[2] = true

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

    ...

    Parameter

    container[N]

    N=0…7

    Type

    Text String

    Value

    A string containing the full path to a tape container. If the specified tape image does not exist, CHARON-VAX creates it.

    If only the name of the tape container is specified, CHARON-VAX will look for the container in the folder where the emulator executable resides, typically "C:\Program Files (x86)\CHARON\Build_XXXXX\x86" (Windows x64; for Windows x86 the path is "C:\Program Files\CHARON\Build_XXXXX\x86").

    warning

    If the "CHARON Guest Utilities for OpenVMS" (CHARONCP) package is used, the syntax is different. Please read the corresponding chapter.

    warning

    Using compressed folders to store virtual disks and tapes is not supported.

    media_type

    Parameter

    media_type[N]

    N=0…7

    Type

    Text String

    Value

    Overrides PRODUCT ID in the default SCSI INQUIRY data.

    Valid values may contain uppercase letters, integers and spaces. Length of this string cannot exceed 16 characters.

    By default the PRODUCT ID returned is "TLZ04"

    ...