passed to a device I/O thread to be completed asynchronously instead.

SYNCIO is the default for CKD devices. SYNCIO statistics may be displayed via
the Hercules SYNCIO console command. SYNCIO may be abbreviated as SYIO.

Note: If you plan on using SYNCIO with Linux/390 and/or zLinux you might also
want to take a look at the IODELAY system parameter as well.

READONLY

READONLY returns “write inhibited” sense when a write is attempted. Note that not
all the sense bits may be set absolutely correctly.

FAKEWRITE

FAKEWRITE is a workaround for the READONLY sense problem that was men-
tioned above. In these cases the disk is not intended to be updated (e.g. MVS up-
dates the DSCB last referenced field for a readonly file) and any writes appear to
be successful even though nothing is actually written.

type

Specifies the type of control unit to which this device is attached. The use of this
parameter does not necessarily imply that all functions of the specified control unit
are emulated. The purpose is to force a particular control unit type to be indicated
in the data returned by SENSE ID and similar CCW's.

Normally the default value is appropriate and this parameter need not to be speci-
fied. Additional to the table below the following values may be specified: 3990-3
and 3990-6. The default value depends on the device type as shown in table below.

ipname

This is the host name or IP address of the system where the Hercules shared de-
vice server is running.

port

This is the port number the shared device server is listening on. If omitted the de-
fault is 3990.

devnum

Devnum specifies the device number on the shared device server. If omitted the
default is the current device number on the local system.

COMP=n

This keyword requests that the data has to be transferred compressed between the
client and the server. The argument n specifies the compression level (1-9). Values
closer to 1 mean less compression but also less processor time to perform the
compression. Values closer to 9 mean the data is compressed more but also more
processor time is required to compress the data.

Two other options LAZYWRITE and FULLTRACKIO have been deprecated. They are still accepted to
support compatibility with older configuration files but do actually nothing. It is strongly recommended to
remove these statements from the configuration file.

The following table shows the default Control Unit types depending on on the device type:

Device Type

Default CU Type

2311

2841

2314

2314

3330, 3340, 3350, 3375, 3380

3880

3390

3990

9345

9343

Table 11: Default CU Types

6.11.4 Examples

Example 1:

Define a 3390 CKD DASD device on device address 0A8C. The name and path of the file containing the
DASD image is "D:/DASD/SARES1.CKD".

0A8C 3390 D:/DASD/SARES1.CKD

Example 2:

Define a 3390 CKD DASD device on device address 0AA2. The name and path of the file containing the
DASD image is "D:/DASD/SARES1.CKD". Synchronous I/O has to be enabled and the device has to
return the "write inhibited" sense when a write is attempted.

0AA2 3390 D:/DASD/SARES1.CKD SYNCIO READONLY

Example 3:

Define a 3390 CCKD DASD device on device address 0A00. The name and path of the file containing the
DASD image is "D:/DASD/SARES1.CCKD". All changes to the DASD device have to go to the shadow
file(s) "D:/SHADOW/SARES1_*.CCKD".

0A00 3390 D:/DASD/SARES1.CCKD SF=D:/SHADOW/SARES1_*.CCKD

Example 4:

Define a 3390 CKD DASD device on device address 0A8C. The DASD device is attached to a shared
device server which is running on a machine with IP address 192.168.200.1 and listening on port 3990.
The device address of the DASD on the shared device server is also 0A8C.

0A8C 3390 192.168.200.1:3990:0A8C

Previous Page Next Page