Versions Compared

Old Version 6

changes.mady.by.user Bruno Miretti

Saved on

compared with

New Version 7

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

Anchor
TOC
TOC
Include Page
KBCOMMON:KB-CSSstyle
KBCOMMON:KB-CSSstyle

...

Parameter

container[N]

N=0…7

Type

Text String

Value

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

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


Div
classpagebreak


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.

...

(warning) In the table above N stands for logical unit number. The first unit must be 0 with no gaps in subsequent numbering.

Div
classpagebreak


Example:

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] = "/dev/sdc"

...

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 CHARON is running from.

Warning

If the "CHARON Guest Utilities for OpenVMS" (CHARONCP) package is used there is a possibility not to specify the exact tape container on CHARON start since it can be specified later using the package.

In this case the syntax is:

load virtual_scsi_tape/chscsi pka_0 scsi_bus=pka scsi_id=0
set pka_0 container[0] =".vtape"



Div
classpagebreak


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"

...

Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc

Div
classpagebreak


virtual_scsi_cdrom

Use "virtual_scsi_cdrom" to connect IDE or SATA host CD-ROM or *.iso file to CHARON-VAX.

...

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:

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


Div
classpagebreak


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 “false” (buffering disabled).

...

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.


Div
classpagebreak


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:

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

...