Versions Compared

Old Version 9

changes.mady.by.user Bruno Miretti

Saved on

compared with

New Version 10

changes.mady.by.user Bruno Miretti

Saved on

Key

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

...


Example:

load RQDX3/RQDX3 DUA

The RQDX3 offers the following configuration parameters, which are specified with the "set" command:

address

Parameteraddress
Type

Numeric

Value

Specifies the CSR address. This address must be a valid QBUS 22-bit address in IO space.

Initially its value is 017772150, which is the factory setting for the RQDX3 disk controller.

Use the "address" parameter for loading several instances of RQDX3. The "address" parameter value must be unique for every instance of the controller.

max_n_of_units

Parameter

max_n_of_units

TypeNumeric
Value

Specifies the maximum number of units supported by the controller. Possible values are 4…9999.

The default value is 9999.

Div
classpagebreak

container

Parameter

container[N]

N=0…9999

TypeText String
Value

Specifies the location of the disk container. It can be either the name of a ".vdisk" file or the name of a physical disk:

  • Local fixed disks (IDE, SCSI, SATA)

    • "\\.\PhysicalDrive<N>"
      "\\.\PhysicalDrive(DevID =XXX-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 DUA container[3]="\\.\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:Image Removed.


      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 DUA container[0]="\\.\PhysicalDrive(iScsiTarget= iqn.2008-04:iscsi.charon-target-test1, LUN= 1)"


      .

  • Floppy drives
    • "\\.\A:"
    • "\\.\B:"
      .
  • CD-ROM, DVD drives (IDE, SCSI, …)
    • "\\.\CdRom<N>"



Div
classpagebreak


media_type

Parameter

media_type[N]

N=0…9999

Type

Text String

Value

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

Syntax:

"<device-name>[,<device-type>]"

where:

  • <device-name> is one of “DU”, “DK”, “SCSI”, “DI”, “DSSI”, “DJ”

  • <device-type> is of 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 “DU” and the device type is selected based on disk size.

Initially not specified.

geometry

Parameter

geometry[N]

N=0…9999

Type

Text String

Value

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

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

  1. X is the number of sectors per track;

  2. Y is the number of tracks per cylinder;

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


Div
classpagebreak


use_io_file_buffering

Parameter

use_io_file_buffering[N]

N=0…9999

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

(info) 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:

set DUA use_io_file_buffering[2]=true



...

Parameter

vax_bi_node_id

TypeNumeric
Value

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

Parameter

container[N]

N=0…9999

Type

Text String

Value

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
      classsmall

      set PUA container[3]="\\.\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:Image Removed.


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

...

Parameter

use_io_file_buffering[N]

N=0…9999

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

(info) 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:

set PUA use_io_file_buffering[0]=true

...


Example:

Create a KDB50 MSCP controller in BI slot 1 of a VAX/PDP11:

...