Natural for Mainframes	Version 8.2.6 for Mainframes	SEARCH   CONTENTS   |   PDF BOOKS   |   HOME   UP   PREV   NEXT

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.

The following topics are covered below:

• ZIIP Parameter Syntax

• NTZIIP Macro Syntax

• Keyword Subparameters

• Example of ZIIP Parameter

• Example of NTZIIP Macro

ZIIP Parameter Syntax

The ZIIP parameter is specified as follows:

Or:

Where state can be ON, OFF or AUTO.

Note:
If specified as a list within brackets, ON, OFF or AUTO must be the first value.

NTZIIP Macro Syntax

The NTZIIP macro is specified as follows:

         NTZIIP state,                                                 *
               IMSG=value,                                             *
               STAT=value,                                             *
               PRINT=value,                                            *
               PNR=value,                                              *
               PWCSIZE=value

See Keyword Subparameters.

For a description of state, see ZIIP Parameter Syntax.

Keyword Subparameters

IMSG | STAT | PRINT | PNR | PWCSIZE

IMSG – Natural zIIP Support Message

This keyword subparameter determines whether Natural issues a NAT7070 system message after Natural zIIP support has been successfully enabled during session initialization.

STAT – zIIP Switch Component Statistics

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.

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.

PRINT – Print zIIP Processing Information (in Batch Sessions only)

This keyword subparameter can be used to get information printed about zIIP processing automatically at the end of a batch session. It is ignored in server and TSO sessions.

PNR – Print File for zIIP Processing Information (in Batch Sessions only)

This keyword subparameter can be used to determine the file where the information about zIIP processing (see the keyword subparameter PRINT) is printed at the end of a batch session. PNR is ignored for server and TSO sessions.

PWCSIZE - Size of the Cache for Print and Work Files

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.

PWCSIZE Parameter Syntax

The subparameter PWCSIZE is specified as follows:

Where:

Notes:

1. The default setting is 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.
2. You cannot change the PWCSIZE setting during a session.

Example of ZIIP Parameter

ZIIP=(ON,STAT=ON,PWCSIZE=(200,,300))

Example of NTZIIP Macro

         NTZIIP AUTO,                                                  *
               STAT=ON,                                                *
               PWCSIZE=(500,),                                         *
               PRINT=ALL

www.softwareag.com

Copyright © 1979-2016 Software AG, Darmstadt, Germany.

SEARCH   CONTENTS   |   PDF BOOKS   |   HOME   UP   PREV   NEXT