1 CHART

CHARTfor Natural

Take a good look at your system ... with CHART

Presented by Treehouse Software, Inc.

2 CHART

A program structure chart ...

HISPROG1 ________| | | CallNat Fetch HERSUBP1 HISPROG2 |________ | | Fetch InputMap HERPROGA HERMAPA | * CallNat

HERSUBP1

3 CHART

Overview of this presentation ...

What does CHART do ...

When to use CHART ...

Why use CHART ...

Parameters for CHART-ing ...

Symbols used in CHART ...

How to get CHART-ed ...

4 CHART

What does CHART do ...• draws program calling structures, using

source code• all other objects detected are drawn in an

easy-to-read format - a CHART• exclude object types from the CHART• "suppress" objects from "expansion"• can be used on-line or in batch

5 CHART

When to use CHART ...

• during and after application development• before, during, and after maintenance

work on a suite• to permanently document all or part of an

application• to audit your application system

6 CHART

Why use CHART ...

• "a picture tells a thousand words"• we need structure charts during analysis,

specification, development, and maintenance• you can "tailor" a CHART to your particular

needs (with “exclusions”, “don’t explodes”)• CHART detects most ways of

"dynamically" calling an object

7 CHART

Why use CHART ... 10:58:41 ***** P R E D I C T ***** 94-06-23Library: DEVL - Invoked Programs - DBnr: 2 Fnr: 2Command: PROG HISPROG1 (*) USING PROG * (*) WITH * VIA *

T:Program using T:Program via-------------------------------------------------------------- 1 P:HISPROG1 1 N:HERSUBP1 CallNat 2 P:HISPROG2 Fetch***** END OF LIST *****

11:00:08 ***** P R E D I C T ***** 94-06-23Library: DEVL - Invoked Programs - DBnr: 2 Fnr: 2Command: XREF HISPROG1 (*) USING PROG * (*) WITH * VIA *PROGRAM:HISPROG1--------------------------------------------------------------*** Number of referenced Programs at Level 1: 2 *** N:HERSUBP1 P:HISPROG2

*** Number of referenced Programs at Level 2: 2 *** P:HERPROGA M:HERMAPA

8 CHART

Why use CHART ...

HISPROG1 ________| | | CallNat Fetch HERSUBP1 HISPROG2 |________ | | Fetch InputMap HERPROGA HERMAPA | * CallNat HERSUBP1

9 CHART

Why use CHART ... Document and Audit your whole application ...

• pass all the “seeds” of your application to CHART (in a work file)

• program charts will be printed for each seed

• a table of contents will be printed• an index of objects will be printed• an audit list of objects not referenced

will be printed

10 CHART

Invoking CHART On-line ...

• At the "Command" prompt:

Enter Code: Type: Name:

Command: CH PROG1

• or at the “NEXT” prompt:

NEXT chart LIB=CHARTV2

11 CHART

CHART "entry" screen ...18:59:06 **** CHART for Natural V2.2D.1 **** 29/02/97User YOURID Library DEVL Code Function ---- ------------------------- G Generate Program Chart L License Details ? HMC Program Chart Help . Terminate Program Chart ---- ------------------------- Code .. G Seed .. MYPROG__

Exclude .. DC________ M:Map C:Copycode P:Program X:eXtrnl B:Batch R:Routine (N:Subrtn N:Subprog H:Hlprtn) W:WorkFile D:DataArea (G:Global L:Local A:pAram) O:Others (I:Inline Subroutine F:Database Files)

Trace every 5000_ source lines (or Page limit in ‘Batch’) Don't Explode/Show .. ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ Command ===>Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12- Help About Quit Main Order StpLb Batch Excln Shape Parms

12 CHART

CHART "entry" screen ...18:59:06 **** CHART for Natural V2.2D.1 **** 29/02/97User YOURID Library DEVL Code Function ---- ------------------------- G Generate Program Chart L License Details ? HMC Program Chart Help . Terminate Program Chart ---- ------------------------- Code .. G Seed .. rps150i1_

Exclude .. DC________ M:Map C:Copycode P:Program X:eXtrnl B:Batch R:Routine (N:Subrtn N:Subprog H:Hlprtn) W:Work

O:Othe

Trace every 5000_ source lines Don't Explode/Show .. ______ ______ ______ ______ Command ===>Enter-PF1---PF2---PF3---PF4--- Help About Quit Main

Trace of Chart being built ..

5000 source lines processed 23 objects placed in Chart (7P 5N 9M 2L) 6 objects still to be checked

--Enter-Continue--PF5-ShowChart--PF3-Exit--

13 CHART

15 CHART

17 CHART

19 CHART

21 CHART

23 CHART

25 CHART

Extra CHARTsare drawn for“unplaced ...

26 CHART

Step Libraries in CHART ...

• PF6 displays this window: current step libraries are shown

• up to ten step libraries can be specified

Step Libraries ... DEVL____ TEST____ PROD____ ________< to be searched ________ in order after ________ CURRLIB > ________ ________ ________ ________ ________

27 CHART

Exclude ObjectTypes in CHART ...

• PF9 displays this window: currentexclusions (if any) are shown

• Allows different “exclusions”to be easily chosen

Exclusions ... X M MapX D Data Areas G Global L Local A Parameter P Program_ K Set Key R Routines_ S Subroutine N Subprogram H HelproutineX C Copycode X External Calls B Batch Calls W Work FilesX O Other Types_ I Inline Subrtns_ F Database Files

Input/Output (MDHWF) Program Calls (DPSNXB)

28 CHART

Exclude Object Types in CHART ...

• Exclude Maps and DataAreas and only programs and subprograms will be drawn:

• HISPROG1• ________|• | |• CallNat Fetch• HERSUBP1 HISPROG2• |• |• Fetch• HERPROGA

•

29 CHART

Exclude Object Types in CHART ...• Exclude only DataAreas and

programs, subprograms, and maps will be drawn:

• HISPROG1• _________________|________• | | | |• CallNat Fetch InputMap InputMap• HERSUBP1 HISPROG2 HISMAP1 HISMAP2• | | | |• | | * |• WrteForm Fetch HelpRout HelpRout• HERFORM1 HERPROGA HISHELP HISHELP• | |• | |• InptMap# InputMap• HERMAPA HISMAP3

30 CHART

Don’t Explode/Show in CHART ...

Don't Explode/Show .. MJ*_____

• objects starting with ‘MJ’ will have descendant objects suppressed

Don't Explode/Show .. ^MJ*____

• objects starting with ‘MJ’ will not be shown in the CHART at all

34 CHART

Symbols used in CHART ...

• ..# (Dynamically Invoked):

| | | | CallNat Fetch InputMap InputMap HERSUBP1 HISPROG2 HISMAP1 HISMAP2 | | | |

InptMap# InputMap HISMAP1 HISMAP2 | | HelpRout HISMAP3

35 CHART

Symbols used in CHART ...

• * (Descendants Suppressed):

| |• | |• InputMap InputMap• HISMAP1 HISMAP2• | |• * |• HelpRout HelpRout• HISHELP HISHELP• |• |• InputMap• HISMAP3

36 CHART

Symbols used in CHART ...

• + (Don’t Explode):

| CallNat

HISSUBP | + Fetch ERRORHDL

37 CHART

Symbols used in CHART ...

• ? (Source Code Not Found):

| |

InputMap HERMAP1 | ? HelpRout HERHELP2

38 CHART

Symbols used in CHART ...

• <n> (Descendants could not be placed):

| CallNat

HISSUBP | <3> Fetch ERRORHDL

39 CHART

Symbols used in CHART ...

• i: .. (Inline Subroutines)

f: .. (Database Files):

| | | i:CHECK- Fetch f:CLIENT CLIENTS HISPROG2 -DETAILS | |

InputMap HISMAP2

40 CHART

Paging around CHARTs on-line ...Page: 1L of 2 left side of first page being displayed

1L 1R

2L 2R

Use PF7, PF8, PF10, and PF11 to scroll around on-line:

--PF5---PF6---PF7---PF8---PF9---PF10--PF11-- Find Chart Up Down Lines Left Right

41 CHART

Objects with over 15 descendants ... Descendants are split over as many rows as necessary:

42 CHART

Running CHART in Batch ...

JCL to runCHART formany seeds(in work file):

Extra CHARTsare drawnautomatically(whenevernecessary)

43 CHART

How to get CHART-ed ...

• Free trial of CHART at your site• Can be purchased short term or long term • Includes installation, training sessions, reference

manuals, and version upgrades• CHART can be “tailored” to suit special

documentation needs your site may have

44 CHART

CHART Version 2for Natural

Take a good look at your system ... with CHART

45 CHART