Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: prepare for PDF export

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

...

The boot ROM of CHARON-VAX detects SCSI devices with multiple LUNs and builds proper device names for them.

(info) To To display a list of devices on the VAX console (SRM), enter ">>> show device" .

This list is passed to VAX/VMS at boot time.

(warning) VAXVAX/VMS creates devices only for logical unit 0 for each device detected in the boot ROM. To add additional logical units, use the following SYSGEN command:

...

Parameter

scsi_id

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

...

"kzdda.icfg" loads the second SCSI adapter.

(info) OpenVMS OpenVMS version 5.5-2H4, or above, is required to use the "pkb" controller.

...

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

    • Do not use device names of the form "/dev/sd<L>" – they are not persistent. Use one of the above device names instead.

      (info)Instead of an entire disk, a partition can be mapped by using the device name with the partition-letter at the end.
      .

  • 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

...

Parameter

removable[N]

N=0…7

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

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


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

...

When a virtual SCSI disk image is dismounted in VMS, it is no longer open by CHARON and may be copied. This capability can be useful when designing back-up and restore procedures. If copying CHARON-VAX disk images while CHARON-VAX is running, take care to minimize the risk of overloading the host system.

...

Please note:

Unlike MSCP controlled disk images, a disk image connected to a SCSI controller as a virtual SCSI disk CANNOT be replaced by another disk image unless "removable" parameter is set for this particular disk image.

Example:

set pka_0 container = "/charon/disks/my_removable_disk.vdisk"
set pka_0 removable = true

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

...

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

Please note

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

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:

"<image-size>[, <early-warning-zone-size>]"

where:

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

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

set pka_0 geometry[0] = 90


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

...

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

(warning) In In the table above N stands for logical unit number. The first unit must be 0 with no gaps in subsequent numbering. If only one LUN is configured, the LUN number can be omitted

...

Parameter

removable[N]

N=0…7

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

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


Div
classpagebreak


disconnect_timeout

Parameter

disconnect_timeout[N]

N=0…7

TypeNumeric
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 with 48 days timeout:

set pka_0 disconnect_timeout[1] = 0x400000

(warning) In In the table above N stands for logical unit number. The first unit must be 0 with no gaps in subsequent numbering. If only one LUN is configured, the LUN number can be omitted.

...