| Anchor | ||||
|---|---|---|---|---|
|
| Include Page | ||||
|---|---|---|---|---|
|
...
load CIXCD PAA |
The CIXCD emulation has the following configuration parameters:
parameters. These parameters can be added to the "load" command or specified separately with the "set" command.
port
| Parameter |
|---|
Type
Value
port[N] N=0…127 | |
| Type | Numeric |
|---|---|
| Value | An integer value that specifies the TCP/IP port number on which the emulated CIXCD host adapter listens for connections from other emulated CIXCD host adapters with address: N. Possible values are from 1024 through 32767. Initially not set. |
host
| Parameter | host[N] N=0…127 |
|---|---|
Type | Text String |
| Value | A string value that specifies the TCP/IP hostname (and optionally the TCP/IP port number) to connect to another emulated CIXCD host adapter with address: N. The syntax for the string is “host-name[:port-no]”, with possible values for the port-no in the range of 1024 through 32767. Initially not set. |
xmi_node_id
| Parameter | xmi_node_id |
|---|---|
| Type | Numeric |
| Value | An integer value that specifies the location of the virtual CIXCD host adapter on the XMI bus. Possible values are 11 through 14 (Initially set to 14). |
ci_node_id
| Parameter | ci_node_id |
|---|---|
| Type | Numeric |
| Value | An integer value that specifies the address of the virtual CIXCD host adapter on the virtual CI network. Possible values are 0 through 127 (Initially set to 127). |
Example
The example below shows how to configure a virtual CIXCD adapter with a location on the XMI bus other than the default. It declares a CIXCD adapter in slot 11 (0xB = decimal 11) of the virtual XMI bus:
load CIXCD PAA xmi_node_id=0xB |
The configuration file below creates a virtual VAX 6610 (single CPU) node with one virtual HSJ50 storage controller serving two disks to the VAX over a virtual CI network:
|
HSJ50 storage controller
The virtual HSJ50 storage controller functionally replaces a physical HSJ50 CI storage unit. It supports virtual and physical disks, tapes and removable storage devices that are mapped on local or remote host platform storage. The virtual HSJ50 cannot connect to a physical CI infrastructure.
In a single CHARON-VAX/66X0 instance without a CI cluster, the virtual HSJ50 is located as a separate entity on the same host platform. In a CI cluster, the definition of each HSJ50 is replicated exactly in each CHARON-VAX CI node. In most cases one HSJ50 storage controller per virtual CI network is enough.
When loading an instance of a virtual HSJ50 storage controller, the CHARON-VAX configuration file must supply a unique reference name for that instance. While this name is only valid within the configuration file, it is recommended, for clarity, to use the VAX/VMS SCSNODENAME as an instance name.
The line below loads an emulated HSJ50 storage controller and assigns it the instance name SCSNODE:
load HSJ50 MYDISKS |
The HSJ50 emulation has the following configuration parameters:
ci_host_name
| Parameter |
|---|
...
Type
...
Value
| ci_host_name | |
Type | Text String |
|---|---|
Value | A string value that specifies the instance name of the emulated CIXCD host adapter serving the virtual CI network. If this value is not set, CHARON-VAX will try to locate the host adapter automatically. Automatic lookup works only if the CHARON-VAX configuration has exactly one instance of an emulated CIXCD host adapter. |
ci_node_id
| Parameter | ci_node_id |
|---|---|
| Type | Numeric |
| Value | An integer value that specifies the address of an emulated HSJ50 storage controller on the virtual CI network. Possible values are 0 through 7 (initially set to 0). |
scs_node_name
| Parameter | scs_node_name |
|---|---|
| Type | Text String |
| Value | A string value that specifies the SCSNODENAME of the emulated HSJ50 storage controller. The string can contain up to 6 characters. Possible characters are uppercase letters A through Z and the integers 0 through 9. Initially set to the name of the emulated HSJ50 controller. Therefore the name of the emulated HSJ50 controller must follow the above rules. |
scs_system_id
Parameter | scs_system_id |
|---|---|
| Type | Numeric |
| Value | An integer value that specifies the SCSSYSTEMID of the emulated HSJ50 storage controller. Initially set to an arbitrary value that is guaranteed to be unique within the running emulated VAX 66x0 node. |
mscp_allocation_class
| Parameter | mscp_allocation_class |
|---|---|
| Type | Numeric |
| Value | An integer value that specifies the ALLOCLASS of the emulated HSJ50 storage controller. Possible values are 0 through 255 (initially set to 0). |
container
| Parameter | container[N] N=0…9999 |
|---|---|
| Type | Character |
| Value | Possible values of the parameter are strings in one of the following forms: |
...
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
This parameter is initially not set, thus creating NO storage elements on the controller |
media_type
| Parameter | media_type[N] N=0…9999 | |
|---|---|---|
| Type | Text String | |
| Value | Overrides the default (automatically determined) MSCP media type of the device. Syntax:
where:
If not specified, the device name is set to “DI” and the device type is selected based on disk size for disk storage elements. For tape storage elements, the device name and type are set to "MI" and "TF86" respectively. 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 CI node ID: N and MSCP unit number: N. This parameter is not applicable to tape storage elements. 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. Initially not set. The syntax above is applicable only to disk storage elements. If the container is a tape image, the following format is used: Syntax:
where:
|
use_io_file_buffering
| Parameter | use_io_file_buffering[N] N=0…9999 |
|---|---|
| Type | Boolean |
| Value | Enables the use of the host OS I/O buffering. Initially set to “NO” (buffering disabled). |
Example
The following example configures a virtual HSJ50 storage controller with a non-default CI network address of 75:
load HSJ50 DISKS ci_node_id=75 |
The configuration file below emulates a VAX 6610 node with one HSJ50 storage controller serving two disks:
|
When this configuration file is executed and "container[0]" points to a valid VMS system disk image, a virtual VAX 6610 can boot VAX/VMS with the following command:
>>> BOOT /XMI:E /NODE:0 |
In the above boot command, "/XMI:E" and "/NODE:0" instruct the boot ROM to connect to the disk via the host adapter in XMI slot 14 (this is the default CIXCD XMI node ID, the hex value E stands for decimal 14).
Then via the storage controller with CI node id 0, DU0 is reached (defined as container[0]) and the boot command is executed for the associated file on the host system.
After logging into VMS, the “SHOW DEVICE” command displays the following:
|
| Div | ||
|---|---|---|
| ||
|
When a tape or disk image, connected to an emulated HSJ50 controller, is dismounted, in VAX/VMS, it is disconnected from CHARON-VAX and can be manipulated.