Page Comparison

address

Numeric

Specifies the CSR address. This address must be a valid QBUS 22-bit address in IO space for a TQK50 and a valid UniBUS 18-bit address in I/O space for a TUK50.

The initial values are 017774500 (TQK50) and 0774500 (TUK50), which is the factory setting for these tape controllers.

Use the "address" parameter to load several instances of TQK50's/TUK50's. The "address" parameter value must be unique for each instance of a TQK50/TUK50.

container[N]

N=0…9999

Text String

Specifies the location of the tape container. It can be either the name of a ".vtape" (".mtd") file or the name of a physical tape drive:

• Tape images
  • <file name>.vtape
    .

• Local physical tape drives recognized by Windows
  • "\\.\Tape<N>"
    

• • .
• Physical SCSI tape drive connected to a CHARON host, but not recognized by Windows

  • "\\.\Scsi<X>:<Y>:<Z>:<N>"

• • To find the values of X,Y,Z and N use the utility "Host Device Check"

media_type[N]

N=0…9999

Text String

Overrides the default (automatically determined) TMSCP media type of a device.

Syntax:

where:

• <device-name> is either: “MU”, “MK”, “SCSI”, “MI”, “DSSI”, or “MJ”

• <device-type> is of the form “LLD” or “LLLD”, where “L” is letter a from A through Z, and “D” is a decimal number from 0 through 99

If not specified, the device name is set to “MU” and the device type is set to “TK50”

Initially not specified.

geometry[N]

N=0...9999

Text String

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

Syntax:

where:

• <image-size> is the tape size in MB

• <early-warning-zone-size> is the size (in KB) of the space left on the tape that, when reached, issues a warning to the OS. If omitted, 64K is assumed.

Example:

xmi_node_id

Specifies the XMI slot in which the virtual KDM70 storage controller is placed.

For CHARON-VAX/66X0 a free slot between 10 (A) and 14 (E) must be chosen.

container[N]

N=0…9999

Text String

Possible values of the parameter are strings in one of the following forms:

• Physical disk drives

• • "\\.\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 PUA container[3]=

• • "\\.\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 class small set PUA container[0]=

• • "\\.\PhysicalDrive(iScsiTarget

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

• • = 1)

• • "

    .

• Physical tape drives recognized by Windows
  • "\\.\Tape<X>", where X is 0, 1, …
    .

• Physical tape drives 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
    

• • .

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

• • "\\.\B:"

• • 
    .
• CD-ROM drives (read-only)
  • "\\.\CdRom<X>", where X is 0, 1, …
    .

• CHARON-VAX disk images
  • [<drive>":\"<path-

• • name>"\

• • "]<file-name>[

• • ".

• • vdisk"]
    . 

• CHARON-VAX

• tape images
  • [<drive>":\"<path-

• • name>"\

• • "]<file-

• • name>".

• • vtape"
    

media_type[N]

N=0…9999

Text String

Overrides the default (automatically determined) MSCP media type of the device.

Syntax:

where:

• <device-name> is either: “DU”, “MU”, “DK”, “MK”, “SCSI”, “DI”, “MI”, “DSSI”, “DJ”, “MJ”

• <device-type> is in the form: “LLD” or “LLLD”, where “L” is a letter from A through Z, and “D” is a decimal number from 0 through 99

If not specified, the device name is set to “DI”, and the device type is selected based on disk size for the disk storage elements. For tape storage elements, the device name and type are set to “MI” and “TF86”, respectively.

Initially not specified.

geometry[N]

N=0…9999

Text String

This formatted string value specifies the explicit geometry of the disk storage element with DSSI node id: N and MSCP unit number: N. This parameter is not applicable to tape storage elements.

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.

Initially not set.

The syntax described above is applicable only to disk storage elements. If the container is a tape image, the following format is used instead:

Syntax:

where:

use_io_file_buffering[N]

N=0…9999

Text String

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 and tape 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:

vax_bi_node_id

Specifies the VAXBI slot in which the virtual KDB50 storage controller is placed. For CHARON-VAX / CHARON-PDP a free slot between 1 (1) and 15 (F) must be chosen.

Initially set to 14.

container[N]

N=0…9999

Text String

Possible values of the parameter are strings in one of the following forms:

• Physical disk drives

• • "\\.\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 PUA container[3]=

• • "\\.\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 class small set PUA container[0]=

• • "\\.\PhysicalDrive(iScsiTarget

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

• • = 1)

• • "

    .

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

• • "\\.\B:"
    

• • .
• CD-ROM drives (read-only)
  • "\\.\CdRom<X>", where X is 0, 1

• • , ...
    .
    
• CHARON-VAX disk images
  • [<drive>":\"<path-

• • name>"\

• • "]<file-name>[

• • ".

• • vdisk"]

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

media_type[N]

N=0…9999

Text String

Overrides the default (automatically determined) MSCP media type of the device.

Syntax:

where:

• <device-name> is either: “DU”, “DK”, “SCSI”, “DI”, “DSSI” or “DJ”

• <device-type> is in the form of: “LLD” or “LLLD”, where “L” is a letter from A through Z, and “D” is a decimal number from 0 through 99

If not specified, the device name is set to “DU” and the device type is selected, based on the disk size for the disk storage elements. For tape storage elements, the device name and type are set to “MI” and “TF86”, respectively.

Initially not specified.

geometry[N]

N=0…9999

Text String

This formatted string value specifies the explicit geometry of the disk storage element with MSCP unit number: N. This parameter is not applicable to tape storage elements.

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 / CHARON-PDP will configure the geometry based on the most probable disk type.

Initially not set.

use_io_file_buffering[N]

N=0…9999

Text String

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 and tape 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: