Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Page breaks management for PDF export

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

...

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

      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:


      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


Div
classpagebreak


media_type

Parameter

media_type[N]

N=0…7

Type

Text String

Value

Overrides the PRODUCT ID in the default SCSI INQUIRY data.

Valid values may contain uppercase letters, integers and spaces. The length of the string cannot exceed 16 characters.

If not specified, synthetic SCSI INQUIRY data is returned containing a PRODUCT ID selected based on the disk size.

Initially left unspecified.

...

geometry

Parameter

geometry[N]

N=0…7

Type

Text String

Value

This formatted string value specifies the explicit geometry of the disk storage element

The string format is <X>”/”<Y>[“/”<Z>] where:

  • "X" is the number of sectors per track;
  • "Y" is the number of tracks per cylinder;
  • "Z" (optional) is the number of cylinders on the unit. If omitted, Z is calculated based on X, Y and the total number of sectors on the unit that reflects the size of the disk storage element;

If this parameter is not set, CHARON-VAX will configure the geometry based on the most probable disk type.

...

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


...