5.10 CCKD (Compressed CKD DASD opt
ions)

5.10.1 Function

The CCKD system parameter is used to alter CCKD processing. The CCKD system parameter supports
the same options as the CCKD console command.

5.10.2 Syntax

Descriptive

opt [, [, ... ]]

-1 n

-1 n

2 n

4 n

2 n

-1 n

Diagram

~¬¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬¬®

¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

-1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

-1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬ ¬
2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬ 4 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬
2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬ ¬
2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

n ¬¬¬

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬ ¬ -1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

n ¬¬¬

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬
¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

Previous Page Next Page

Extracted Text (may have errors)

5.10 CCKD (Compressed CKD DASD opt
ions)

5.10.1 Function

The CCKD system parameter is used to alter CCKD processing. The CCKD system parameter supports
the same options as the CCKD console command.

5.10.2 Syntax

Descriptive

opt [, [, ... ]]

-1 n

-1 n

2 n

4 n

2 n

-1 n

Diagram

~¬¬¬¬¬¬¬¬¬¬ , ¬¬¬¬¬¬¬¬¬®

¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

-1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

-1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬ ¬
2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬ 4 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬
2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬ ¬
2 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

n ¬¬¬

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬ ¬ -1 ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

n ¬¬¬

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬
¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

Help

Destination page number Search scope Search Text

loading

5.10.3 Parameter

option

Set a CCKD option. Multiple options may be specified, separated by commas with
no intervening blanks.

The CCKD options are:

COMP=n

Specifies the compression type to be used. This overrides the compression used
for all CCKD files. The default (-1) means don’t override the compression. Valid
compression types are:

-1 Default

0 None

1 Zlib

2 Bzip2

COMPPARM=n

Overrides the compression parameter. A higher value generally means more com-
pression at the expense of CPU and/or storage. The default (-1) means don’t over-
ride the compression parameter. The value of n can be from -1 and 9.

RA=n

Sets the Number of read ahead threads. When sequential track or block group
access is detected, some number (RAT=n) of tracks or block groups are queued
(RAQ=n) to be read by one of the read ahead threads. The default is 2, the value of
n can be a number from 1 to 9.

RAQ=n

Sets the size of the read ahead queue. When sequential track or block group
access is detected, some number (RAT=n) of tracks or block groups are queued in
the read ahead queue. The default is 4, the value of n can be a number from 0 to
16. A value of zero disables read ahead.

RAT=n

Sets the number of tracks or block groups to read ahead when sequential track or
block group access is detected. The default is 2, the value of ratn can be a number
from 0 to 16. A value of zero disables read ahead.

WR=n

Sets the number of writer threads. When the cache is flushed, updated cache
entries are marked write pending and a writer thread is signalled. The writer thread
compresses the track or block group and writes the compressed image to the emu-
lation file.

A writer thread is CPU-intensive while compressing the track or block group and
I/O-intensive while writing the compressed image. The writer thread runs one nicer
than the CPU thread(s). The default is 2, a value from 1 to 9 can be specified

GCINT=n

This is the number of seconds the garbage collector thread waits during an interval.
At the end of an interval the garbage collector performs space recovery, flushes the
cache and optionally ‘fsyncs’ the emulation file.

However, the file will not be ‘fsynced’ unless at least 5 seconds have elapsed since
the last synchronization (FSYNC). The default is 10 seconds. You can specify a
number between 1 and 60.

GCPARM=n

A value affecting the amount of data moved during the garbage collectors space
recovery routine. The garbage collector determines an amount of space to move
based on the ratio of free space to used space in an emulation file and on the num-

ber of free spacesin the file. The garbage collector wants to reduce the free space
to used space ratio and the number of free spaces.

The value is logarithmic; a value of 8 means moving 2
8
the selected value while a
negative value similarly decreases the amount to be moved. Normally, 256K will be
moved for a file in an interval. Specifying a value of 8 can increase the amount to
64M. At least 64K will be moved. Specifying a large value (such as 8) may not
increase the garbage collection efficiency correspondingly. The default is 0. You
can specify a number from -8 to 8.

NOSTRESS=n

Indicates whether stress writes will occur or not. A track or block group may be
written under stress when a high percentage of the cache is pending write or when
a device I/O thread is waiting for a cache entry. When a stressed write occurs, the
compression algorithm and/or compression parm may be relaxed, resulting in faster
compression but usually a larger compressed image.

If NOSTRESS is set to one, then a stressed situation is ignored. You would
typically set this value to one when you want create the smallest emulation file
possible in exchange for a possible performance degradation. The default is 0. You
can specify 0 (enable stressed writes) or 1 (disable stressed writes).

FREEPEND=n

Specifies the free pending value for freed space. When a track or block group
image is written, the space it previously occupied is freed. This space will not be
available for future allocations until n garbage collection intervals have completed.
In the event of a catastrophic failure, previously written track or block group images
should be recoverable if the current image has not yet been written to the physical
disk.

By default the value is set to -1 which means that if FSYNC is specified then the
value is 1 otherwise it is 2. If 0 is specified then freed space is immediately avail-
able for new allocations. The default is -1. You can specify a number from -1 to 4.

FSYNC=n

Enables or disables FSYNC. When FSYNC is enabled then the disk emulation file
is synchronized with the physical hard disk at the end of a garbage collection inter-
val (no more often than 5 seconds though).

This means that if FREEPEND is non-zero and a catastrophic error occurs, the
emulated disks should be recovered coherently. However, FSYNC may cause
performance degradation depending on the host operating system and / or the host
operating system level. The default is 0 (fsync disabled), you can specify 0 (disable
FSYNC) or 1 (enable FSYNC).

TRACE=n

Specifies the number of CCKD trace entries. You would normally specify a non-
zero value when debugging or capturing a problem in CCKD code. When the prob-
lem occurs, you should enter the "k" Hercules console command which will print the
trace table entries. The default is 0. You can specify a number between 0 and
200000. Each trace entry represents 128 bytes. Normally, for debugging, it is re-
commended to use 100000.

LINUXNULL=n

If set to 1 then tracks written to 3390 CCKD volumes that were initialized with the
-linux option will be checked if they are null (that is if all 12 4096 byte user records
contain zeroes). This is used by the DASDCOPY utility. The default is 0.

GCSTART=n

If set to 1 then space recovery will become active on any emulated disks that have
free space. Normally space recovery will ignore emulated disks until they have
been updated. The default is 0.

Previous Page Next Page

Extracted Text (may have errors)

5.10.3 Parameter

option

Set a CCKD option. Multiple options may be specified, separated by commas with
no intervening blanks.

The CCKD options are:

COMP=n

Specifies the compression type to be used. This overrides the compression used
for all CCKD files. The default (-1) means don’t override the compression. Valid
compression types are:

-1 Default

0 None

1 Zlib

2 Bzip2

COMPPARM=n

RA=n

RAQ=n

RAT=n

WR=n

GCINT=n

However, the file will not be ‘fsynced’ unless at least 5 seconds have elapsed since
the last synchronization (FSYNC). The default is 10 seconds. You can specify a
number between 1 and 60.

GCPARM=n

ber of free spacesin the file. The garbage collector wants to reduce the free space
to used space ratio and the number of free spaces.

NOSTRESS=n

FREEPEND=n

FSYNC=n

TRACE=n

LINUXNULL=n

GCSTART=n

If set to 1 then space recovery will become active on any emulated disks that have
free space. Normally space recovery will ignore emulated disks until they have
been updated. The default is 0.

directory ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

directory

5.8.3 Parameter

ADD or +

Add an entry to the list of allowable tape automount directories.

DEL or -

Delete an entry from the list of allowable tape automount directories.

directory

Specifies the host system directory where the guest is allowed or not to automati-
cally load virtual tape volumes from.

5.8.4 Examples

Example 1:

Specify directory “D:\MVS\TAPE” as the host system directory from where the guest is allowed to
automatically load virtual tape volumes.

AUTOMOUNT +D:/MVS/TAPE

AUTOMAOUNT ADD D:/MVS/TAPE

5.9 CAPPING (CPU c
apping feature)

5.9.1 Function

The CAPPING system parameter is used to cap the CPUs. If mips is greater than zero then all of the ‘CP’
type processors are capped to this value. If mips is equal to zero or “OFF” or the CAPPING system para-
meter is not coded in the configuration file then the capping is disabled.

Only CPUs of type CP are capped. CPUs of type IL, AP or IP are never capped. The CPU string on the
Hercules device and status panel which shows the CPU usage turns from white to red during the time the
CPU is capped.

5.9.2 Syntax

Descriptive

mips OFF

Diagram

ÊÊ¬¬¬ ¬¬¬§¬¬¬ mips ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

OFF ¬¬¬¬«

¬¬¬

5.9.3 Parameter

mips

Maximum total number of MIPS for all the ‘CP’ type processors.

OFF

Disables the CPU capping.

This is the same as OFF.

5.9.4 Examples

Example 1:

Set the CPU capping to 25 MIPS.

CAPPING 25

Example 2:

Disable the CPU capping feature.

CAPPING OFF

Previous Page Next Page

Extracted Text (may have errors)

directory ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

directory

5.8.3 Parameter

ADD or +

Add an entry to the list of allowable tape automount directories.

DEL or -

Delete an entry from the list of allowable tape automount directories.

directory

Specifies the host system directory where the guest is allowed or not to automati-
cally load virtual tape volumes from.

5.8.4 Examples

Example 1:

Specify directory “D:\MVS\TAPE” as the host system directory from where the guest is allowed to
automatically load virtual tape volumes.

AUTOMOUNT +D:/MVS/TAPE

AUTOMAOUNT ADD D:/MVS/TAPE

5.9 CAPPING (CPU c
apping feature)

5.9.1 Function

5.9.2 Syntax

Descriptive

mips OFF

Diagram

ÊÊ¬¬¬ ¬¬¬§¬¬¬ mips ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

OFF ¬¬¬¬«

¬¬¬

5.9.3 Parameter

mips

Maximum total number of MIPS for all the ‘CP’ type processors.

OFF

Disables the CPU capping.

This is the same as OFF.

5.9.4 Examples

Example 1:

Set the CPU capping to 25 MIPS.

CAPPING 25

Example 2:

Disable the CPU capping feature.

CAPPING OFF

5.10 CCKD (Compressed CKD DASD opt ions)

5.10.1 Function

5.10.2 Syntax

Page 211. Preface click to expand contents

Page 242. Related Publications click to expand contents

Page 253. Summary of changes click to expand contents

Page 284. Hercules Configuration File click to expand contents

Page 405. System Parameter Descriptions click to expand contents

Page 1706. Device Definition Descriptions click to expand contents

Page 2327. Hercules Console click to expand contents

Page 2598. Console Command Descriptions click to expand contents

5.10 CCKD (Compressed CKD DASD opt
ions)