Page Comparison

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
  class small
  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), for example:
  
  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
  class small
  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

class	pagebreak

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.

...

Parameter

use_io_file_buffering[N]

N=0…7

Type

Text String

Value

Instructs CHARON-VAX to enable host operating system I/O cache on reading/writing operations.

The following values are possible:

"true" or "write-back" - the "write back" caching mode is used
"write-through" - the "write through" caching mode is used
"false" - caching is switched off

Note that this caching has a significant effect only in case of mapping to disk containers, not physical drives.

When enabled, host operating system I/O cache may significantly improve I/O performance of the virtual system. At the same time maintaining I/O cache requires additional host resources (CPU and memory) which may negatively affect overall performance of the virtual system.

Initially is set to "false".

Example:

set pka_0 use_io_file_buffering[0]=true

Div

class	pagebreak

removable

Parameter

removable[N]

N=0…7

Type

boolean

Value

Enables the logical unit to appear as a removable SCSI disk drive.

Initially set to “false” (fixed, non-removable).

...

Include Page

	KBCOMMON:DOC-GoToToc
	KBCOMMON:DOC-GoToToc

...

floppy_scsi_device

Use "floppy_scsi_device" for host floppy drives.

...

In the table above N stands for logical unit number. The first unit must be 0 with no gaps in subsequent numbering. If only one LUN is configured, the LUN number can be omitted:

Div

class	pagebreak

Example:

load floppy_scsi_device/chscsi pka_0 scsi_bus=pka scsi_id=0 set pka_0 container= "\\.\A:"

...

class	pagebreak

...

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

...

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"

Div

class	pagebreak

geometry

Parameter

geometry[N]

N=0…7

Type

Text String

Value

Specifies the size of the tape image and (optionally) the size of the "early-warning" area at the end of the tape image.

Syntax:

"<image-size>[, <early-warning-zone-size>]"

where:

<image-size> is the tape size in MB
<early-warning-zone-size> is the size (in KB) of the space remaining on the tape when a warning to the OS is issued. If omitted, 64K is assumed.

Example:

load virtual_scsi_tape/chscsi pka_0
set pka_0 geometry[0] = 90

...

"virtual_scsi_cdrom" has the following parameters:

Div

class	pagebreak

container

Parameter

container[N]

N=0…7

Type

Text String

Value

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

ISO images
- [<path-name>"\"]<file-name>[".iso"]
  Format: A string containing the full path to an *.iso image.
  If only the name of the *.iso image is specified, CHARON-VAX will look for the image 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").
  .
CD-ROM and DVD drives (IDE and SATA)
- "\\.\CdRom<X>", where X is 0, 1, …
  .

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

...

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.

Div

class	pagebreak

use_io_file_buffering

Parameter

use_io_file_buffering[N]

N=0…7

Type

Text String

Value

Instructs CHARON-VAX to enable host operating system I/O cache on reading/writing operations.

The following values are possible:

"true" or "write-back" - the "write back" caching mode is used
"write-through" - the "write through" caching mode is used
"false" - caching is switched off

Note that this caching has a significant effect only in case of mapping to ISO images, not physical drives.

When enabled, host operating system I/O cache may significantly improve I/O performance of the virtual system. At the same time maintaining I/O cache requires additional host resources (CPU and memory) which may negatively affect overall performance of the virtual system.

Initially is set to "false".

Example:

set pka_0 use_io_file_buffering[0]=true

...

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.

Div

class	pagebreak

removable

Parameter

removable[N]

N=0…7

Type

boolean

Value

Enables the logical unit to appear as a removable SCSI disk drive.

Initially set to “false” (fixed, non-removable).

...

Versions Compared

Old Version 12

New Version 13

Key

media_type

removable

floppy_scsi_device

geometry

container

use_io_file_buffering

removable