For programs optimized with the Natural Optimizer Compiler, certain statements can be directly converted into machine code when cataloged. As a result, when executing the optimized objects with Natural at runtime, the performance can be improved considerably.
The NOCSTAT command
analyses cataloged objects and provides statistical information to help decide
whether program statements benefit from optimization with the Natural Optimizer
Compiler and, if so, to what extent they can be optimized.
If a program is cataloged (STOW,
CATALL), the Natural compiler generates an internal
(pseudo) object code based on the statements in the source program. In most
cases, one source statement is transformed into one pseudo-code instruction.
However, for complex statements, such as FOR and
REPEAT, several pseudo-code instructions are generated. The
NOCSTAT analyses are based on the generated
pseudo-code instructions. Therefore, the number of statements indicated in the
statistical reports may exceed the number of statements in the source
program.
This document covers the following topics:
To use the Natural NOCSTAT command
Enter the direct command NOCSTAT.
The main NOCSTAT screen is displayed:
14:02:01 ***** NATURAL NOCSTAT COMMAND ***** 2000-09-04
Name .................. ________
Library ............... SAGTEST_
NOCable Objects only .. _
Output Report ......... X Statement Category
_ Statement Type
_ Code Profile
Output Destination .... X Screen
_ CSV to Work File 1
_ XML to Work File 1
with XSL ________________________________
Progress Control ...... X
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Canc
|
To obtain field-specific help information, either enter a question mark
in the relevant field and press ENTER, or place the cursor in the
field and press PF1. Press PF3 to exit
NOCSTAT.
You can generate statistical reports for a single program or a set of programs. If you analyze more than one program at a time, the reports are produced in series. When you have finished looking at one report, press ENTER to view the next report.
The main NOCSTAT menu provides the following options:
| Field | Explanation | |
|---|---|---|
Name |
Enter a name or a range of names to specify the program(s) you want to examine: | |
value is any combination
of one or more characters.
|
||
value |
Single program. | |
* |
All programs. | |
value* |
All programs whose names begin with
value.
|
|
value> |
All programs whose names are greater/equal
value.
|
|
value< |
All programs whose names are less/equal
value. |
|
Library |
Enter the name of a library or
specify a range; the same applies as described for the Name field above.
The current library is the default. |
|
|
|
Mark this option to exclude
programs already compiled with the Natural Optimizer Compiler.
Otherwise, the |
|
Output Report |
Mark any of the options to select
statements by category, type or code profile.
See Statement Category, Statement Type and Code Profile below. |
|
Output
Destination |
Mark any of the following options to determine the output format and destination: | |
Screen |
Online display. | |
CSV to Work File 1 |
Generates spreadsheets with comma-separated
values. Use the file extension .csv to write the work file
directly to your PC for further processing.
You can only route reports to a PC if Entire Connection is installed. |
|
XML to Work File 1 |
Generates XML documents. Use the file extension
".xml" to write the work file directly to your PC for further
processing.
If a value is entered in the field "with XSL", a processing instruction is added at the top of the XML output document: <?xml-stylesheet type="text/xsl" href=" value "?> The value entered should be the absolute or relative url of the style sheet, for example: nocstat.xsl or http://natural.software-ag.de/nocstat.xsl The processing instruction causes the document to be transformed according to the given style sheet when it is viewed by an XSLT-capable browser or transformed by a batch XSLT run. A typical use of this feature is to convert the output XML to an HTML page. There are two XSLT style sheets delivered with Natural as text
objects
Download the style sheets with file extension You can only route reports to a PC if Entire Connection is installed. |
|
Progress
Control
|
Only applies to Work File 1 output
destinations.
If this option is marked, a brief message appears online for each program listed in the report generated. |
|
You can choose between three output formats described below to display
the statistics NOCSTAT provides for the statements analyzed.
Different report layouts are produced for programs already optimized with the
Natural Optimizer Compiler and for programs to be considered for optimization.
The example reports below show the difference. Press PF3to interrupt
report processing and return to the NOCSTAT menu.
Below is information on:
The statistical report generated with the option Statement
Category lists various categories of statements with the corresponding
number of occurrences and the total number of statements already optimized or
suitable for optimization, depending on whether or not the program was
optimized with the Natural Optimizer Compiler.
14:07:17 ***** NATURAL NOCSTAT COMMAND ***** 2000-09-04
Library SAGTEST Name NOCTEST1 Type Program
MCG Options: (ON,OVFLW,INDX,MIX,IO)
Database Loop: 0
Database Simple: 0
SORT / WORK I/O: 29
FOR / REPEAT: 0
Screen / Printer: 59
String Manipulation: 6
Arith / Logical: 0
Program Calls: 3
Control Transfer: 49
Block Start: 25
Set Environment: 2
System Functions: 0
Miscellaneous: 0
Total Statements: 949
NOC optimized: 762 ( Ratio: 80 % )
Longest NOC Run: 180 Statements
|
14:13:01 ***** NATURAL NOCSTAT COMMAND ***** 2000-09-04
Library SAGTEST Name NOCTEST2 Type Program
No NOC NOCable
-------- --------
Database Loop: 0 0
Database Simple: 0 0
SORT / WORK I/O: 0 0
FOR / REPEAT: 0 5
Screen / Printer: 57 0
String Manipulation: 4 8
Arith / Logical: 0 491
Program Calls: 3 0
Control Transfer: 19 69
Block Start: 15 0
Set Environment: 0 0
System Functions: 0 0
Miscellaneous: 0 0
Total Statements: 672
NOC optimizable: 573 ( Ratio: 85 % )
Longest NOC Run: 192 Statements
|
| Column | Explanation |
|---|---|
No NOC |
Statements not suitable for optimization. |
NOCable |
Statements suitable for optimization. |
| Field | |
Database Loop |
The number of database statements that generate a processing
loop, such as FIND and READ.
|
Database Simple |
Database statements that do not generate a processing loop,
such as STORE, UPDATE, DELETE and
GET.
|
SORT / WORK I/O |
SORT and work file statements.
|
FOR / REPEAT |
Statements generating loops. |
Screen / Printer |
Screen and printer I/O, such as WRITE,
DISPLAY and INPUT.
|
String Manipulation |
String statements, such as EXAMINE and
COMPRESS.
|
Arith / Logical |
Arithmetic and logical statements, such as MOVE,
COMPUTE and IF.
|
Program Calls |
Transfer of control to a subroutine or subprogram, such as
PERFORM, CALLNAT and FETCH.
|
Control Transfer |
Jumps within the program, such as ESCAPE BOTTOM,
FOR and REPEAT loops.
|
Block Start |
Non-executed statements that demarcate code blocks, such as
DEFINE SUBROUTINE and AT END. These statements are
never optimized because they are never executed.
|
Set Environment |
Statements that set the environment, such as SET
CONTROL, SET GLOBALS and SET KEY.
|
System Functions |
Statements, such as TOTAL, SUM,
COUNT, MAX, MIN and
*COUNT.
|
Miscellaneous |
Pseudo-code statements not relevant for optimization and, therefore, ignored by the NOC. |
| Totals | |
Total Statements |
The total number of statements found in the program. This
number may not correspond to the actual source statements as described in the
introduction to NOCSTAT command above.
|
NOC optimized |
For an optimized program, these are the actual pseudo-code
statements (as described in the introduction to NOCSTAT command
above) that have been NOC-optimized to machine code.
|
NOC optimizable |
For non-optimized programs, this is the possible number of
statements that could be optimized. The figure may be slightly higher than the
actual number, since certain factors are not considered in the
NOCSTAT program. For example, a SUBSTRING statement
that has more than four arrays will be indicated as "optimizable"
though it will not be optimized.
|
Ratio |
Relation between Total Statements and NOC-optimized statements or Total Statements and NOC-optimizable statements in percent. |
Longest NOC Run |
NOC-optimized program:
The number of contiguous optimized statements - the fewer fragment sequences, the better the performance. |
| Non-optimized program:
The number of contiguous statements to be expected if the program were optimized. |
The statistical report generated with the option Statement
Type lists single statements with the corresponding number of
occurrences and the NOC coding generated for optimized objects.
09:21:45 ***** NATURAL NOCSTAT COMMAND ***** 2000-09-06
Library SAGTEST Name NOCTEST1 Type Program
Statement Number
------------------------ --------
DB AT CONDITION 6
READ/WRITE WORK FILE 29
EXAMINE 6
WRITE 51
INPUT 3
NEWPAGE 2
REINPUT 3
FIND 1
READ 2
NOC CODE 760
BLOCK START 18
ON ERROR 1
END 1
STOP 2
RETURN 3
RETURN INLINE 15
ESCAPE ROUTINE 3
ESCAPE ROUTINE IMMEDIATE 1
MORE |
09:23:15 ***** NATURAL NOCSTAT COMMAND ***** 2000-09-06
Library SAGTEST Name NOCTEST2 Type Program
Statement No NOC NOCable
------------------------ -------- --------
DB AT CONDITION 6 0
MOVE/COMPUTE/ASSIGN 0 371
EXAMINE 4 0
COMPRESS 0 7
WRITE 47 0
INPUT 2 0
NEWPAGE 2 0
REINPUT 6 0
FIND 1 0
READ 1 0
HISTOGRAM 1 0
ELSE/CLOSE LOOP 0 55
LOOPEND FOR/REPEAT 0 5
BLOCK START 8 0
ON ERROR 1 0
END 1 0
STOP 2 0
RETURN 2 0
MORE |
The statistical report generated with the option Code
Profile displays contiguous sequences of statements grouped by
categories in a source program suitable for optimization, or lists the NOC
coding generated for an optimized program. Occurrences are highlighted.
09:59:04 ***** NATURAL NOCSTAT COMMAND ***** 2000-09-06
Library SAGTEST Name NOCTEST1 Type Program
Line Statement
----- -------------------------
0000 ON ERROR
0000 MCG OPTIONS
0045 MCG OPTIONS
0050 NOC CODE
0050 NOC CODE
0050 NOC CODE
0050 NOC CODE
1110 SET KEY
1140 NOC CODE
1140 NOC CODE
1145 NOC CODE
1145 NOC CODE
1150 NOC CODE
1150 NOC CODE
1155 NOC CODE
1155 NOC CODE
1160 NOC CODE
1160 NOC CODE
MORE |
10:01:36 ***** NATURAL NOCSTAT COMMAND ***** 2000-09-06
Library SAGTEST Name NOCTEST2 Type Program
Line Statement
----- -------------------------
0000 ON ERROR
0000 MCG OPTIONS
0100 MOVE/COMPUTE/ASSIGN <-- NOCable
0100 MOVE/COMPUTE/ASSIGN <-- NOCable
0100 MOVE/COMPUTE/ASSIGN <-- NOCable
1920 MOVE/COMPUTE/ASSIGN <-- NOCable
1920 FOR <-- NOCable
1920 MOVE/COMPUTE/ASSIGN <-- NOCable
1920 FOR/REPEAT IF <-- NOCable
1930 COMPRESS <-- NOCable
1940 LOOPEND FOR/REPEAT <-- NOCable
1960 MOVE/COMPUTE/ASSIGN <-- NOCable
1960 MOVE/COMPUTE/ASSIGN <-- NOCable
1970 MOVE/COMPUTE/ASSIGN <-- NOCable
1970 MOVE/COMPUTE/ASSIGN <-- NOCable
1980 MOVE/COMPUTE/ASSIGN <-- NOCable
1980 MOVE/COMPUTE/ASSIGN <-- NOCable
1990 MOVE/COMPUTE/ASSIGN <-- NOCable
MORE |
Below are job examples for processing NOCSTAT reports in
batch mode to create a CSV work file. After job execution, the work files
generated can be transferred from host to PC for further processing with
standard transfer tools.
//NOCBATCH JOB (NOC,,,30),CLASS=K,MSGCLASS=X 00000100
//NATEX EXEC PGM=NATvrsBA,REGION=6200K,PARM=('IM=D') 00000200
//STEPLIB DD DISP=SHR,DSN=TESTNAT.LOAD 00000300
//CMPRINT DD SYSOUT=X 00000400
//CMWKF01 DD DSN='NOC.NOCSTAT.OUT',DISP=(NEW,CATLG), 00000500
SPACE=(CYL,(1,1)),UNIT=SYSDA,VOL=SER=SAG001 00000600
//SYSOUT DD SYSOUT=X 00000700
//CMSYNIN DD * 00000800
NOCSTAT 00000900
*,library,,X,,,,X 00001000
. 00001100
FIN 00001200
/* 00001300
* $$ JOB JNM=NOCTST,CLASS=5,DISP=D * $$ LST CLASS=Q,DISP=D // JOB NOCTST // ASSGN SYS001,DISK,VOL=xxxxxx,SHR // DLBL CMWKF01,'NOCSTAT.FILE.ONE',0 // EXTENT SYS001,xxxxxx,1,0,1,150 // EXEC NATvrsBA,SIZE=NATvrsBA,PARM='SYSRDR' IM=D,OBJIN=R /* ADARUN DBID=185 /* NOCSTAT *,library,,X,,,,X . FIN /* /&
/.BAT234 LOGON NAT,1
/ SYSFILE SYSOUT=NATvrs.OUT
/ SYSFILE SYSLST=NATvrs.LST
/SKIP .NOP000
======================================================================
NAME : E.NATvrs S T A R T B A T C H N A T U R A L
======================================================================
/.NOP000 REMARK
/ OPTION DUMP=YES,MSG=FL
/ FILE NOCSTAT.OUT,LINK=W01
/ FILE ADAUSER ,LINK=DDCARD
/ FILE $SAG.ADAvrs.MOD ,LINK=BLSLIB00
/ SYSFILE TASKLIB=MODvrs
/ SYSFILE SYSDTA=(SYSCMD)
/ FILE NATvrs.CMPRMIN,LINK=CMPRMIN
/ DCLJV NATJV1,LINK=*NATB2JV
/ FILE $NAT.ADALNK.PARMS,LINK=DDLNKPAR
/ REMARK %%%%%%%%%% BATCH-PHASE %%%%%%%%%%%%%%
/ EXEC NATvrs
NOCSTAT
*,library,,X,,,,X
.
FIN