Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Also note: that the following rules are applied for logical units. 

  1. Each SCSI device must implement logical unit 0.

  2. A SCSI device must implement all logical unit numbers between the highest and the lowest numbers implemented. 

Empty disk images can be created with the "MkDisk" utility.

...

Use the "virtual_scsi_disk" mapping for disk containers. This is the most convenient way of connecting disks to SCSI adapters in CHARON-VAX

Div
classpagebreak

 

The "virtual_scsi_disk" mapping has the following parameters: 

container

Type
Parameter
Value

container[N]

N=0…7

TypeText String
Value

A string containing the full path to a disk container. N stands for logical unit number. The first unit must be 0 with no gaps in subsequent numbering..

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

media_type

Parameter

media_type[N]

N=0…7

TypeText String
Value

Overrides PRODUCT ID in the default SCSI INQUIRY data.

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

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

Initially left unspecified.

geometry

Parameter

geometry[N]

N=0…7

TypeText 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.

use_io_file_buffering

Parameter

use_io_file_buffering[N]

N=0…7

Typeboolean
Value

Enables the use of the host OS I/O buffering.

Initially set to “NO” (buffering disabled).

removable

Parameter

removable[N]

N=0…7

Typeboolean
Value

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

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

Example

...

load virtual_scsi_disk/chscsi pka_0 scsi_bus=pka scsi_id=0

set pka_0 container[0] = "C:\Charon\Disks\disk1.vdisk"
set pka_0 container[1] = "C:\Charon\Disks\disk2.vdisk"

...

"virtual_scsi_tape" has the following parameters:

container

Value
Parameter
Type

container[N]

N=0…7

TypeText String
Value

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

N stands for the logical unit number (LUN). The first unit must be 0 with no gaps in subsequent numbering. 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").

media_type

Parameter

media_type[N]

N=0…7

TypeText 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”"TLZ04"

geometry

Parameter

geometry[N]

N=0…7

TypeText 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

Example

...

load virtual_scsi_tape/chscsi pka_0 scsi_bus=pka scsi_id=0

set pka_0 container[0] = "C:\Charon\Tapes\tape1.vtape"

set pka_0 container[1] = "C:\Charon\Tapes\tape2.vtape"

...

set pka_0 container = "C:\Charon\Tapes\tape1.vtape"

set pka_0 media_type = "TLZ08"

...

Use "physical_scsi_device" to connect any host SCSI device to CHARON-VAX.

...

classpagebreak

...

"physical_scsi_device" has the following parameters:

container

TypeXXXfor local fixed disks (IDE, SCSI, SATA)



for iSCSI disks



or for floppy drivesfor CD-ROM, DVD drives (IDE, SCSI, …)for physical tape drives for physical tape drives and other SCSI devices not recognized by Windows
Parameter
Value

container[N]

N=0…7

TypeText String
Value

A string containing the device name to map to the emulator. N stands for logical unit number (LUN). It must begin at 0 and have no gaps in subsequent numbering. If there is only one logical unit the number can be omitted.

Mapping to host system resourcesDescription
  • Local fixed disks (IDE, SCSI, SATA)
    • "\\.\PhysicalDrive<X>", where X is 0, 1, …
for local fixed disks (IDE, SCSI, SATA)
    • "\\.\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)

    • "

      .

  • 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_5 container=

    • "\\.\PhysicalDrive(iScsiTarget

    • =iqn.2008-04:iscsi.charon-target-test1, LUN

    • =1)

    • "

      .

  • Floppy drives
    • "\\.\A:"
    • "\\.\B:"

    • .
  • CD-ROM, DVD drives (IDE, SCSI, …)
    • "\\.\CdRom<X>", where X is 0, 1, …
    • .
  • Physical tape drives recognized by Windows
    • "\\.\Tape<X>", where X is 0, 1, …
      .
  • Physical tape drives and other SCSI devices not recognized by Windows
    • "\\.\Scsi<X>:<Y>:<Z>:<N>"
      Use the utility "Host Device Check" to find the values of X,Y,Z and N
    • .

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

media_type

Parameter

media_type[N]

N=0…7

TypeText 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

TypeText 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.

use_io_file_buffering

Parameter

use_io_file_buffering[N]

N=0…7

Typeboolean
Value

Enables use of the host OS I/O buffering.

Initially set to “NO” (buffering disabled).

removable

Parameter

removable[N]

N=0…7

Typeboolean
Value

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

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

Example

...

load physical_scsi_device/chscsi pka_0 scsi_bus=pka scsi_id=0
set pka_0 container="\\.\PhysicalDrive1"

...

Back to Table of Contents