Anchor | ||||
---|---|---|---|---|
|
Include Page | ||||
---|---|---|---|---|
|
Table of Contents
Table of Contents | ||
---|---|---|
|
...
Introduction
CHARON-VAX provides two SCSI controllers for the SCSI and SCSI/QBUS models of VAX.
...
Type of mapping | Description |
---|---|
virtual_scsi_disk695730330 | For disk image containers and physical disks |
floppy_scsi_device695730330 | For floppy drives |
virtual_scsi_tape695730330 | For tape image containers |
virtual_scsi_cdrom695730330 | For host CD-ROM and *.iso images |
physical_scsi_device695730330 | For physical tapes and other SCSI devices connected to a host |
...
Include Page | ||||
---|---|---|---|---|
|
Mapping to host resources
Load a mapping device with the "load" command. Specify the name of the device instance, the emulated SCSI bus to connect the device to and the SCSI identifier of the CHARON-VAX device.
scsi_bus
Parameter | scsi_bus |
---|---|
Type | Identifier |
Value | Name of the emulated SCSI disk controller: "pka" or "pkb" |
Div | ||
---|---|---|
| ||
scsi_id
Parameter | scsi_id |
---|---|
Type | Numeric |
Value | A value between 0 and 7. This is the ID number of the emulated SCSI device. The SCSI adapter is preloaded with address 7. If required, set it to another value in the range of 0-7 from the VAX console. |
.
Info |
---|
There is no direct correspondence between the host hardware SCSI ID and these CHARON-VAX SCSI addresses. Set the correspondence between the physical SCSI addresses on the host system and the CHARON-VAX SCSI bus ID in the configuration file. |
Syntax:
load <instance type>/<module name> <instance name> scsi_bus=<bus name> scsi_id=<number> |
...
Include Page | ||||
---|---|---|---|---|
|
virtual_scsi_disk
Use the "virtual_scsi_disk" mapping for disk containers and physical disks. This is the most convenient way of connecting disks to SCSI adapters in CHARON-VAX
The "virtual_scsi_disk" mapping has the following parameters:
container
Parameter | container[N] N=0…7 | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Type | Text String | ||||||||||||||||
Value | A string containing the device name to map to the emulator.
This parameter is initially not set, thus creating NO storage elements on the controller |
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:
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 | |
---|---|---|
Type | Text String | |
Value | Instructs CHARON-VAX to enable host operating system I/O cache on reading/writing operations. The following values are possible:
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:
|
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 | ||||
---|---|---|---|---|
|
Div | ||
---|---|---|
| ||
floppy_scsi_device
Use "floppy_scsi_device" for host floppy drives.
"floppy_scsi_device" has the following parameter:
container
Parameter | container[N] N=0…7 |
---|---|
Type | Text String |
Value | "\\.\A:" or "\\.\B:" |
...
Include Page | ||||
---|---|---|---|---|
|
Div | ||
---|---|---|
| ||
virtual_scsi_tape
Use "virtual_scsi_tape" for tape containers. This is the most convenient way of connecting tapes to SCSI adapters in CHARON-VAX.
"virtual_scsi_tape" has the following parameters:
container
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").
|
media_type
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" |
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:
where:
Example:
|
...
Include Page | ||||
---|---|---|---|---|
|
virtual_scsi_cdrom
Use "virtual_scsi_cdrom" to connect IDE or SATA host CD-ROM or *.iso file to CHARON-VAX.
"virtual_scsi_cdrom" has the following parameters:
container
Parameter | container[N] N=0…7 |
---|---|
Type | Text String |
Value | A string containing the device name to map to the emulator.
This parameter is initially not set, thus creating NO storage elements on the controller |
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:
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 | |
---|---|---|
Type | Text String | |
Value | Instructs CHARON-VAX to enable host operating system I/O cache on reading/writing operations. The following values are possible:
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:
|
...
Include Page | ||||
---|---|---|---|---|
|
Div | ||
---|---|---|
| ||
physical_scsi_device
Use "physical_scsi_device" to connect any host "raw" SCSI device to CHARON-VAX. This mapping type is suitable only for tape drives and other specific SCSI devices connected to CHARON host.
"physical_scsi_device" has the following parameters:
container
Parameter | container[N] N=0…7 |
---|---|
Type | Text String |
Value | A string containing the device name to map to the emulator.
This parameter is initially not set, thus creating NO storage elements on the controller |
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:
If this parameter is not set, CHARON-VAX will configure the geometry based on the most probable disk type. |
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). |
disconnect_timeout
Parameter | disconnect_timeout[N] N=0…7 | |
---|---|---|
Type | Numeric | |
Value | Sets logical unit disconnect timeout. This parameter helps if a connected SCSI device performs a given SCSI command for a very long time. The default value depends on the type of the SCSI device attached. For example for a disk it is 10 seconds, for a tape - an hour. If the type of the device is not known the timeout is 1 hour. Example: 48 days timeout
|
...