This Natural profile parameter can be used to configure zIIP processing
under Natural. It corresponds to the
NTZIIP
macro in the Natural parameter module.
Note:
The ZIIP setting takes effect only if the zIIP
Enabler for Natural has been installed in your z/OS environment. For further
information, refer to
Installing zIIP Enabler for Natural
in the Installation for z/OS documentation.
| Possible settings | See ZIIP Parameter Syntax. | ||
|---|---|---|---|
| Default setting | AUTO |
See ZIIP Parameter Syntax and Keyword Subparameters. | |
| Dynamic specification | yes | The parameter
ZIIP can be specified dynamically only. In the
Natural
parameter module, use the macro
NTZIIP.
|
|
| Specification within session | yes | By means of the system command
ZIIP, the zIIP component
switch statistics can be controlled and information about zIIP processing can
be displayed.
|
|
The following topics are covered below:
The ZIIP parameter is specified as follows:
ZIIP=(state,keyword-subparameter=value,keyword-subparameter=value,...)
|
Or:
ZIIP=state |
Where state can be ON,
OFF or AUTO.
| Value | Explanation |
|---|---|
ON |
zIIP support will be activated. |
OFF |
zIIP support will not be activated. |
AUTO |
zIIP support will be activated only if there is
at least one zIIP online, or if the z/OS parameter PROJECTCPU=YES
is set in the SYS1.PARMLIB member IEAOPT.
This is the default value. |
keyword-subparameter |
See Keyword Subparameters. |
Note:
If specified as a list within brackets, ON,
OFF or AUTO must be the first value.
The NTZIIP macro is specified as follows:
NTZIIP state, *
STAT=value, *
PRINT=value, *
PWCSIZE=value
See Keyword Subparameters.
For a description of state, see
ZIIP Parameter
Syntax.
This keyword subparameter controls the collection of component
statistics for the switches into TCB-mode. The statistics can be displayed by
the system command ZIIP during the session, or
the report can be triggered by the subparameter PRINT automatically at
the end of the session (batch only). Moreover, it is possible to control the
statistics by means of the ZIIP command.
| Value | Explanation |
|---|---|
ON |
Activate zIIP switch component statistics. |
OFF |
Deactivate zIIP switch component statistics.
This is the default value. |
Note:
The setting of STAT can be overridden by the
STAT option of the
ZIIP system command and the application programming
interface USR8204N which performs
ZIIP command functions. See the relevant sections in
the System Commands documentation.
This keyword subparameter can be used to get information printed about zIIP processing automatically at the end of the session. It is ignored for server and TSO sessions.
| Value | Explanation |
|---|---|
INFO
|
Print zIIP processing general information only. |
STAT |
Print zIIP switch component statistics only. |
ALL |
Print both: zIIP processing general information and zIIP switch component statistics. |
OFF |
No print of zIIP processing information is
generated at the end of the session.
This is the default value. |
This keyword subparameter can be used to determine the cache sizes for print and work file I/O processing. This may be useful when running Natural in zIIP mode, because it reduces the overhead caused by switching from zIIP to GCP (general central processor) and vice versa. There is one cache for print files, one for output work files, and one for each input work file.
The advantage of the cache is that all I/O data is collected in the cache instead of accessing the file immediately. When the cache for print files or output work files fills up, the cache is flushed, that is, all records are written to their respective files at once. In case of work file input, all records for a given file are read and stored in the input cache for this file. Subsequently, Natural reads the input records directly from the input cache.
 |
Warning: The usage of PWCSIZE can have a negative impact on
your application flow. For example, an application may receive sent records at
a later point of time since the records are not written immediately to the
desired media. Moreover, the error behavior can be different. Example: If the
error NAT1507 - The work/print file is full. occurs, it
is not displayed immediately. Instead, the error message NAT1532 -
Error(s) during flush of print/work file cache. is displayed later
during the cache flush. The error that actually occurred can then only be
displayed with the system command
LASTMSG. This means that an
ON ERROR clause for NAT1507 no longer
works. |
The subparameter PWCSIZE is specified as
follows:
| PWCSIZE=(print-size,work-input-size,work-output-size) |
Where:
| Syntax Element | Value | Explanation |
|---|---|---|
print-cache-size |
1 - 2097151 |
The
print-cache-size in KB is used to
allocate the cache for all print files.
|
0 |
No cache for all print files is allocated. This is the default value. | |
work-input-cache-size |
1 - 2097151 |
The
work-input-cache-size in KB is used to
allocate a cache for each input work file.
|
0 |
No cache for each input work file is allocated. This is the default value. | |
work-output-cache-size |
1 - 2097151 |
The
work-output-cache-size in KB is used to
allocate the cache for all output work files.
|
0 |
No cache for all output work files is allocated. This is the default value. |
Notes:
PWCSIZE=(0,0,0). If you want
to change a default value, you only need to specify the size to be changed, for
example, PWCSIZE=(,200) to allocate 200 KB for the input cache
only.
PWCSIZE setting
during a session.
ZIIP=(ON,STAT=ON,PWCSIZE=(200,,300))
NTZIIP AUTO, *
STAT=ON, *
PWCSIZE=(500,), *
PRINT=ALL