Page Comparison

container[N]

N=0…7

Text String

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

media_type[N]

N=0…7

Text String

Overrides PRODUCT ID in the default SCSI INQUIRY data.

Valid values may contain uppercase letters, decimal figures, spaces. Length of string shall not exceed 16 characters.

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

Initially left unspecified.

geometry[N]

N=0…7

Text String

This formatted string value specifies the explicit geometry of the disk storage element

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

• "X" is number of sectors on track;
• "Y" is number of tracks on 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[N]

N=0…7

boolean

Enables use of host OS I/O buffering.

Initially set to “NO” (buffering disabled).

removable[N]

N=0…7

boolean

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

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

load virtual_scsi_disk/chscsi pka_0 scsi_bus=pka scsi_id=0

set pka_0 container[0] = "/charon/disks/disk1.vdisk"
set pka_0 container[1] = "/charon/disks/distributive.iso"

set pka_0 container = "/charon/disks/disk1.vdisk"
set pka_0 media_type = "RZ1ED"

• • the folder CHARON is running from.
    .

• Local fixed disks (IDE, SCSI, SATA)
  • "/dev/sd<L>" where "L" is letter
  • "/dev/disk/by-id/..." - addressing by the disk ID, for example "/dev/disk/by-id/ata-ST1000DM003-9YN162_S1D01QJ4"
  • "/dev/disk/by-label/..." - addressing by the disk label, for example "/dev/disk/by-label/MyStorage"

  • "/dev/disk/by-uuid/..." - addressing by the disk UUID, for example "/dev/disk/by-uuid/0e808a2f-cdd3-4944-a245-f729ffd73882"

    Note
    Since "/dev/sd<L>" addressing is not persistent, so it is strongly recommended to use "/dev/disk/by-id/wwn-*." syntax instead to refer the disk by its WWID - especially in the enviroments utilizing FC and SAN storages.

     It is also possible to use not a whole disk, but previously created partitions on it. In this case the syntax is the following: "/dev/sd<L><N>" where N is the number of partition to be used.
    .

• Multipath disks
  • "/dev/dm-<X>",
  • "/dev/mapper/mpath<X>",
    
  • "/dev/mapper/disk<X>" where X is 0,1,2...
    .
• Floppy drives
  • "/dev/fd<X>" where X is 0,1,2...

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

media_type[N]

N=0…7

Text String

Overrides PRODUCT ID in the default SCSI INQUIRY data.

Valid values may contain uppercase letters, decimal figures, spaces. Length of string shall not exceed 16 characters.

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

Initially left unspecified.

geometry[N]

N=0…7

Text String

This formatted string

media_type[N]

N=0…7

Text String

Overrides PRODUCT ID in the default SCSI INQUIRY data.

Valid values may contain uppercase letters, decimal figures, spaces. Length of string shall not exceed 16 characters.

By default the PRODUCT ID returned is “TLZ04”

geometryvalue specifies the explicit geometry of the disk storage element

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

• "X" is number of sectors on track;
• "Y" is number of tracks on 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[N]

N=0…7

Text String

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

Syntax:

where:

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

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

Enables use of host OS I/O buffering.

Initially set to “NO” (buffering disabled).

removable[N]

N=0…7

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

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

load virtual_scsi_tapedisk/chscsi pka_0 scsi_bus=pka scsi_id=0

set pka_0 container[0] = "/charon/tapesdisks/tape1disk1.vtapevdisk"
set pka_0 container[1] = "/charon/tapesdisks/tape2disk2.vtapeiso"

set pka_0 container = "/charon/

disks/

disk1.

vdisk"
set pka_0 media_type = "

container[N]

N=0…7

Text String

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

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

media_type[N]

N=0…7

Text String

Overrides PRODUCT ID in the default SCSI INQUIRY data.

Valid values may contain uppercase letters, decimal figures, spaces. Length of string shall not exceed 16 characters.

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

Initially left unspecified.

RZ1ED"

container[N]

N=0…7

Text String

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 logical unit number. 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 "/opt/charon/bin".

media_type[N]

N=0…7

Text String

This formatted string value specifies the explicit geometry of the disk storage element

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

• "X" is number of sectors on track;
• "Y" is number of tracks on 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[N]

N=0…7

boolean

Enables use of host OS I/O buffering.

Initially set to “NO” (buffering disabled).

removable[N]

N=0…7

boolean

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

Overrides PRODUCT ID in the default SCSI INQUIRY data.

Valid values may contain uppercase letters, decimal figures, spaces. Length of string shall not exceed 16 characters.

By default the PRODUCT ID returned is "TLZ04"

geometry[N]

N=0…7

Text String

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

Syntax:

where:

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

• <early-warning-zone-size> is the size (in KB) of 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 scsi_bus=pka scsi_id=0

set pka_0 container[0] = "/charon/tapes/tape1.vtape"
set pka_0 container[1] = "/charon/tapes/tape2.vtape"

set pka_0 container = "/charon/tapes/tape1.vtape"
set pka_0 media_type = "TLZ08"

container[N]

N=0…7

Text String

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 it in the folder CHARON is running from.
    .

• CD-ROM or DVD drives
  • "/dev/cdrom<X>" or
  • "/dev/sr<X>" where X is 0,1,2...

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

media_type[N]

N=0…7

Text String

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[N]

N=0…7

Text String

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[N]

N=0…7

Enables use of the host OS I/O buffering.

Initially set to “false” (buffering disabled).

load virtual_scsi_cdrom/chscsi pka_0 scsi_bus=pka scsi_id=0
set pka_0 container="/dev/sr0"

container[N]

N=0…7

Text String

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

• Physical tape drives and other SCSI devices connected to CHARON host
  • "/dev/sg<X>", where X is 0, 1, …

media_type[N]

N=0…7

Text String

Overrides PRODUCT ID in the default SCSI INQUIRY data.

Valid values may contain uppercase letters, decimal figures, spaces. Length of string shall not exceed 16 characters.

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

Initially left unspecified.

geometry[N]

N=0…7

Text String

This formatted string value specifies the explicit geometry of the disk storage element

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

• "X" is number of sectors on track;
• "Y" is number of tracks on 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[N]

N=0…7

Enables use of host OS I/O buffering.

Initially set to “NO” (buffering disabled).

removable[N]

N=0…7

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

disconnect_timeout[N]

N=0…7

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 (the timeout is 48 days):

0x400000 (hex) = 4194304 (dec) ~= 60 x 60 x 24 x 48 (days)

load physical_scsi_device/chscsi pka_0 scsi_bus=pka scsi_id=0
set pka_0 container="/dev/sd3sdb"