This section describes the SYSTP functions which are available under most TP monitors.
The Natural monitoring function can be used to view statistics about the Natural programs and terminals used during the current Natural session.
The scope of the Natural monitor is determined by the area in which the statistical data is collected:
When a global or local monitor buffer pool is used (as assigned
by the BPI
profile parameter or the
NTBPI
macro of the Natural
parameter module; see the Parameter Reference
documentation), program and terminal statistics of all Natural sessions that
share this buffer pool are collected.
When a monitor buffer is used within the thread (as determined
by the MONSIZE profile
parameter; see the Parameter Reference documentation), only
program statistics and information about the terminal of the current Natural
session are collected. For a monitor buffer, we recommend a minimum value of 64
KB.
In addition to defining the scope for the Natural monitor, you have
to set the RDCSIZE profile
parameter, which activates the Natural Data Collector.
Caution:
When active, the monitoring function can affect overall
system performance.
When you invoke the function, the appears, which provides the following functions:
With these functions you can activate or deactivate the monitor function.
When the monitor function is activated, it begins collecting statistical information of current session(s). Once the monitor function is deactivated, a statistical summary is written to the system log file.
This function provides statistical information about whether
monitoring data is collected in a monitor buffer pool and/or the space
allocated with the MONSIZE parameter,
and indicates the size and the address of the allocated space.
You can view statistical information about all Natural programs that have been executed since the monitor was started and the terminals that have been activated since then.
To execute the program or terminal statistics function
In the Code field of the
, enter P (for program
statistics) or T (for terminal statistics).
You can specify selection criteria for the programs/terminal
and/or libraries to be viewed:
In the Name of LTERM or
Program field and/or the Name of Library field,
enter the name of the required item or specify a range of names by using
asterisk (*) and/or a wildcard (?). If you leave the fields empty or only enter
an asterisk (*), all programs/terminals and libraries are selected.
*CD selects ABCD, ACD.
AB* selects AB, AB1, ABC, ABEZ.
ABC? selects ABCA, ABCZ.
A?C*Z selects ABCZ, AXCBBBZ and
ANCZ.
When you have finished specifying selection criteria and press ENTER, a statistics overview screen similar to the example below appears:
13:44:35 ***** NATURAL SYSTP UTILITY ***** 2008-08-29 User SAG - Natural Monitor Program Statistics - TID TCK8 C Program Library NAT- ADA- Ext- Mean- Screen I/O User Sys Fetch * * time time time time No KB Acc Acc ------------------------------------------------------------------------------ _ MONMNU1M SYSTP 0 0 0 0.0 18 9 6 0 19 _ SYSMAP0M SYSTP 0 0 0 0.0 0 0 0 0 52 _ S2SCOM01 SYSTP 0 0 0 0.0 0 0 0 0 36 * MONMNU1P SYSTP 0 0 0 0.0 1 0 28 0 6 _ MONLST1P SYSTP 0 0 0 0.0 3 0 21 0 12 _ SYSMAP1M SYSTP 0 0 0 0.0 19 13 2 0 20 _ NAT00059 SYSTP 0 0 0 0.0 0 0 0 0 346 _ STPMNU1P SYSTP 0 0 0 0.0 4 0 30 4 8 _ NAT42004 SYSTP 0 0 0 0.0 0 0 0 0 9 _ STPMMM1M SYSTP 0 0 0 0.0 7 5 4 0 9 _ SYSTPRET SYSTP 0 0 0 0.0 0 0 13 0 4 _ NAT00030 SYSTP 0 0 0 0.0 0 0 0 0 4 _ NSCC0002 SYSTP 0 0 0 0.0 0 0 14 0 7 _ LOGON SYSTP 0 0 0 0.0 0 0 0 0 1 Top of List 1 of 3 Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Cont Help Menu Exit Sel -- - + ++ Term Canc |
This screen lists all programs/terminals and libraries that have been active in your current Natural session.
PF4 opens a Selection window that can be used to specify selection criteria (see Step 1) to reduce the list of items displayed on the screen.
You can use PF10 to toggle between the program statistics and terminal statistics screen.
The columns contained on a statistics overview screen and the corresponding field names on a detailed statistics screen (see column C below) are explained in the following table:
| Column | Corresponding Field | Explanation |
|---|---|---|
| C | - | Only applies to the statistics
overview screen.
This input field can be used to invoke a detailed statistics screen for a selected program/terminal: Next to the list item about which you require more detailed statistics information, enter any character and press ENTER. Note: |
| Program | Name of program | Only applies to program
statistics.
Name of the active program. |
| Terminal | Name of terminal | Only applies to terminal
statistics.
Name (ID) of the active terminal. |
| Current Program | Current program / library | Only applies to terminal
statistics.
Name of the executed program and the name of the library that contains this program. |
| Library | Name of library | Only applies to program
statistics.
Name of the library that contains the program that is executed. |
| NAT-time | Time in Natural | Time in the Natural nucleus and in the interface. |
| ADA-time | Time in Adabas | Time waiting for response from Adabas. |
| Ext-time | Time in external program | Time needed by a user-written module. |
| Mean-time | Mean evaluation time | Elapsed time of one Natural screen transaction. |
| Screen I/O No | Number of Screen I/Os | Number of screen I/Os. |
| Screen I/O KB | Amount of data transmitted | Amount of data transferred to or from the screen. |
| - | Evaluation time > 3 sec | Only applies to the detailed statistics screen
for a terminal.
Percentage of evaluation time longer than 3 seconds. |
| - | Evaluation time > 6 sec | Only applies to the detailed statistics screen
for a terminal.
Percentage of evaluation time longer than 6 seconds. |
| User Acc | Number of user file accesses | Counter for accesses to Adabas user files. |
| Sys Acc | Number of system file accesses | Counter for accesses to Natural system file, including fetches. |
| Fetch | Number of fetches | Counter for total number of fetches. |
This function provides information about available work files and print files.
You can also invoke this function with the system command
SYSFILE
described in the System Commands documentation.
The information provided by the SYSFILE
command can also be obtained with the application programming interface
USR1007N. See SYSEXT - Natural Application
Programming Interfaces in the Utilities documentation.
This function can also be used in batch mode for CICS sessions.
When you invoke this function, the Work File Information screen appears with a list of all work and print files defined. The following information is provided for each file:
| Column | Explanation |
|---|---|
| No. | Number of the work/print file. |
| Type | Type of assignment; that is, the operating system, TP monitor or Natural product file to which the work/print file is assigned. |
| Name | Name of the work/print file. |
| Recfm | Record format of the work/print file. |
| Lrecl | Logical record length of the work/print file (if applicable). |
| Blksz | Block size of the work/print file. |
| Status | Either of the following status messages:
or
|
In addition to the commands described in Using SYSTP Utility Screens, the Work File Information screen provides the following PF keys and line command:
| PF Key | Line Command | Function |
|---|---|---|
| PF10 | - | Scrolls to the list of print files. |
| PF11 | - | Scrolls to the list of work files. |
| - | D |
Displays the corresponding Natural control block (work file area) in dump format (for internal use by Software AG technical support). |
This function provides statistical information on the usage of Natural buffers: which buffers are allocated for the current Natural session, and how much buffer space is being used. In addition, the Total figures at the end of the list allow you to draw conclusions about the efficiency of buffer compression.
This section covers the following topics:
You can invoke this function either from the
SYSTP menu or with the system command
BUS.
See also Invoking SYSTP and
Executing Functions. As a result, a list is displayed
showing all buffers that are actually being used in the current Natural
session.
The information provided by the BUS
command can also be obtained with the application programming interface
USR1019N. See SYSEXT - Natural Application
Programming Interfaces in the Utilities documentation.
This section gives an overview on items displayed on Buffer Usage Statistics screen:
| Column | Explanation | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| No. | Buffers are numbered sequentially in order of allocation. | ||||||||||||||||||
| Name | Name of the buffer. Only those buffers which have actually been requested in the current session are listed. | ||||||||||||||||||
| Type |
|
||||||||||||||||||
| Size | Size of the buffer (in bytes).
Toggle between decimal and hexadecimal display with PF12. |
||||||||||||||||||
| Used | Number of bytes currently being used. This value is used for buffer compression in environments using threads (for example, CICS). | ||||||||||||||||||
|
Perc. |
Percentage currently being used; that is, the value of the Used column in relation to the value of the Size column. | ||||||||||||||||||
| MaxUsed | Maximum number of bytes which have been used in the
course of the current session so far (not the size being used at
present).
Toggle between decimal and hexadecimal display with PF12. |
||||||||||||||||||
|
Perc. |
Percentage of current session usage; that is, the value of the MaxUsed column in relation to the value of the Size column. | ||||||||||||||||||
| MaxSize | Maximum size (in bytes) that has been allocated to the
buffer in the course of the current session so far (applies to variable buffers
only).
Toggle between decimal and hexadecimal display with PF12. |
||||||||||||||||||
|
Perc. |
Maximum size allocated so far (value of the
MaxSize column) in relation to the current size (value of
the Size column; applies to variable buffers only). A
percentage of 10000 or more is indicated by 9999.9 displayed
intensified.
|
||||||||||||||||||
|
At the end of the list, the following
information is displayed:
|
|||||||||||||||||||
| ThrdSize | Current size (in KB) of the Natural thread. | ||||||||||||||||||
| Total | Sums of all buffer sizes (in both bytes and KB) and
percentages used/allocated. These totals can also be displayed with
PF10 (see below).
For MaxSize, the total shows the maximum additional amount of thread size that would have been needed in the course of the session so far. Toggle between decimal and hexadecimal display with PF12. |
||||||||||||||||||
In addition to the commands described in Using SYSTP Utility Screens, the Buffer Usage Statistics screen provides the following PF keys and line command:
| PF Key | Line Command | Function |
|---|---|---|
| PF4 | D |
Displays the contents of the buffer marked with the cursor/command in dump format (for internal use by Software AG support). |
| - | S |
Displays details of the selected buffer
in a tabular overview, for example Thread Offset,
Address or Buffer Size.
Toggle between decimal and hexadecimal display with PF12. |
| PF10 | - |
|
| PF11 | - | Displays the:
|
| PF12 | - | Toggle beween
|
This function displays permanent storage segments, that is, storage
segments that continue to exist even if the session that allocated the storage
has already terminated. For each allocated segment, its name, address, size,
date and time of the allocation and the ID of the user who allocated the
segment are displayed. The line command D displays
the contents of a storage segment.
This function displays a list of the Natural subsystems available in your environment and the current status (active or inactive) of authorized service managers and roll servers associated with the subsystems.
Column GBP num shows how many buffer pools are connected to this subsystem. You will see the same number when typing B in front of this line.
Column ECSA-D Address shows the address of the ECSA-Directory, which will also be displayed in the header of the popup if you type E in front of this line.
In addition to the commands described in Using SYSTP Utility Screens, the Natural Sub-Systems screen provides the following line commands:
| PF Key | Line Command | Function |
|---|---|---|
| PF4 | - | Toggles between different types of list sorting: sorted by physical order, sorted by name, and sorted by ECSA Address. |
| - | А |
Displays authorized server statistics such as jobname, information about SYSPLEX, and SIP slots. |
| - | B |
Displays information about the buffer pool and buffer pool cache (if available) such as name, type, and size. |
| - | D |
Displays server directory entries from the Session
Information Pool (SIP) in dump format (for internal use by Software AG
technical support).
For information about SIP, refer to Authorized Services Manager under z/OS in the Operations documentation. |
| - | E |
Displays the ECSA-Directory storage. |
| - | L |
Displays and resets entries in the roll server file directory. The message line shows the number of used and total slots, and the occupation ratio in percent. |
| - | M |
Displays the address and version of modules that are linked to NATASMvr. Currently, this concerns NATZPX, NATFSSM, and NATNDVX. |
| PF5 | P or / |
Keeps the selected subsystem on top of the list. |
| - | R |
Displays roll server statistics, such as the number of
roll server slots and roll server files, roll-out and roll-in activities, roll
file I/O, as well as zIIP CPU time usage of the roll server.
This information can help tune the roll server as described in Roll Server Performance Tuning in the Operations documentation. For example, you can use the statistics data to determine an optimum thread size or roll file size for a Natural application. |
| - | S |
Displays a list of Zaps applied to the Authorized Services Manager. |
| - | U |
Displays server directory entries from the Session
Information Pool (SIP).
For information about SIP, refer to Authorized Services Manager under z/OS in the Operations documentation. |
| - | Z |
Displays a list of Zaps applied to the roll server. |
| PF6 | - | Moves to the top of the list. |
| PF7 | - | Moves backward. |
| PF8 | - | Moves forward. |
| PF9 | - | Moves to the end of the list. |
| PF11 | - | Toggles the information between global, detail, and details on only the currently used subsystem(s). |
You can also obtain information in batch. Therefore, you must issue a command like SYSTP R.<subsystem-id>.<option>, e.g.:
SYSTP R.NAT9.A SYSTP R.NAT9.B SYSTP R.NAT9.D SYSTP R.NAT9.E SYSTP R.NAT9.L SYSTP R.NAT9.M SYSTP R.NAT9.R SYSTP R.NAT9.S SYSTP R.NAT9.U SYSTP R.NAT9.V SYSTP R.NAT9.Z
SYSTP will automatically insert a '+' if information does not fit on one screen, so that you get all possible information related to the selected option.
This function is only available under CICS, Com-plete, and IMS TM. It is not available in a z/OS Parallel Sysplex environment.
This function allows you to determine an optimum thread size or roll file size for a Natural application.
You should activate this function only when needed, and deactivate it after you have determined your optimum thread size, because this function occupies space in the Natural buffer pool. When you deactivate it, the space in the buffer pool becomes available again.
To execute the Natural Thread Usage Statistics function
Define an oversized thread in the range of 512 to 1024 KB for your Natural application. Take into account the number of Natural add-on products used.
Start your Natural application, either in production or in test mode.
Invoke the SYSTP utility and choose the function by entering T in
the Code field of the SYSTP Main
Menu.
The Thread Usage Statistics screen appears.
The columns contained on this screen are described in the following table.
Enter A in the Code field to
activate the function.
A message appears indicating that the function has been activated.
Use your Natural application under typical production conditions.
The function runs in the background and logs the buffer sizes used.
When you want to view the statistics, again, invoke the Thread Usage Statistics screen and enter one of the following in the Code field:
S
to show the statistics, or
P
to print the statistics, or
G
to show GETMAIN statistics (see
Show
Physical GETMAIN Statistics), or
D
to print the statistics and deactivate the function.
We recommend that use function code D after
function completion to free buffer pool space.
The following information is displayed on the Thread Usage Statistics screen:
| Column | Explanation |
|---|---|
| No. | Buffers are numbered sequentially in order of allocation. |
| Ext. Buffer | Sizes of these buffers are defined externally (in the Natural parameter module). |
| Defined Size | Buffer size as defined in the Natural parameter module. |
| Max. Allocated Size | Maximum buffer size allocated.
Note that for the internal BB area, 14368 bytes are added
to the value of the |
| Max. Used Size | Maximum buffer size used. |
| Sum of external buffer sizes | Total of all buffer sizes defined in the Natural parameter module. |
| Sum of internal buffer sizes | Total of all buffer sizes requested by Natural internally. |
| Sum of physical GETMAINs | Total of all physical GETMAINs for the
Natural work pools and the variable Natural buffers outside the Natural user
threads.
|
| Max. used thread length | Maximum thread length used by Natural. Define this
length as your minimum (optimum) Natural thread length.
Round it up to the next KB number that can be divided by 2. |
| Max. compressed thread length | Maximum length of a compressed Natural thread that was
written to the Natural roll file.
Define this length as your minimum (optimum) Natural roll file length. |
The physical GETMAIN statistics provide information
about all physical GETMAINs relevant for the Natural work pools
and the variable Natural buffers outside the Natural user threads. They
indicate the original buffer sizes (Org. Size) during the
startup of a Natural session, the number of physical GETMAINs,
(No.) the buffer length for the physical
GETMAIN (Bytes) and the buffer position
(P), above or below the 16-MB line.
The statistics data always refers to the buffers with the greatest
lengths requested within a terminal I/O, for all users of the Natural
application. The statistics provides a maximum of six entries for each buffer.
These entries can be overwritten through the wrap-around procedure. The highest
number equals the maximum number of the physical GETMAINs within a
terminal I/O, for each buffer concerned.
The first two entries in the statistics refer to the Natural work
pools (if available) above (WRKPOOLA), respectively, below
(WRKPOOLB) the 16-MB line. Here, the highest physical
GETMAIN number refers to the amount of work pools simultaneously
available during the terminal I/O. The sum of all work pool lengths amounts to
the total storage requirement of the work pools within a terminal I/O.
All subsequent statistics entries refer to the physical
GETMAINs for the variable Natural buffers, which either could not
be defined in the Natural user thread due to insufficient space, or were
increased outside the Natural user threads. For these buffers, the highest
physical GETMAIN number indicates the greatest space requirement
for each buffer within a terminal I/O. The total storage space requested
earlier was freed before each of the following physical GETMAINs.
That is, the sum of all physical GETMAINs with the highest number
shows the maximum storage requirement for the variable buffers outside the
Natural user threads during a terminal I/O, for all users of the Natural
application.
The SYSTP Main Menu function Natural
License Information (Code L or PF5) shows
the contents of the existing licence files.
To invoke the function directly:
In the command line of the Natural Main
Menu, issue the system command SYSTP and
the letter code L:
SYSTP L
The first screen of the SYSTP Utility function License Information is displayed.
By default, the content of the license file of the base product Natural appears left justified in XML format.
You can change the display format by repeatedly pressing the PF5 key.
Available formats are:
| Format | Letter Code |
|---|---|
| XML, left justified (default) | L |
| Structured XML | S |
| Plain text | F
|
You can also invoke the Natural License
Information function dynamically using the system command
SYSTP L, the letter code S or
F, and optionally the product code of an add-on product, e.g.:
You can also invoke the Natural License
Information function dynamically using the system command
SYSTP L and the letter code S or
F:
SYSTP L.F
Optionally, you may add the product code of an add-on product, for example:
SYSTP L.F.nnn
Where nnn represents
the product code of the desired product.
Example 1:
SYSTP L.F
Directly displays the content of the product license file for the base product Natural in plain text form.
Example 2:
SYSTP L F.NOC
Directly displays the content of the product license file for the add-on product Natural Optimizer Compiler (NOC) in plain text form.
By repeatedly pressing the PF10 key, you can switch between the product license files for the base product Natural and for the add-on products, for example: Natural Batch for zIIP, Natural for CICS for zIIP, Natural for Com-plete for zIIP, Natural Optimizer Compiler or Predict (depending on which product is installed in your current environment).
If a product cannot be found, a corresponding message appears, e.g.:
Requested product key (PRD) not found, take next license (NOC).
Press PF10 to access the next product license file.
Press PF3 (Exit) to terminate the function and to return to the SYSTP Main Menu.