360 likes | 536 Views
CHART for Natural. Presented by Treehouse Software, Inc. Take a good look at your system ... with CHART. A program structure chart. HISPROG1 ________| | | CallNat Fetch HERSUBP1 HISPROG2 |________
E N D
CHARTfor Natural Presented by Treehouse Software, Inc. Take a good look at your system ... with CHART
A program structure chart ... HISPROG1 ________| | | CallNat Fetch HERSUBP1 HISPROG2 |________ | | Fetch InputMap HERPROGA HERMAPA | * CallNat HERSUBP1
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 ...
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
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
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
Why use CHART ... 10:58:41 ***** P R E D I C T ***** 94-06-23 Library: DEVL - Invoked Programs - DBnr: 2 Fnr: 2 Command: 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-23 Library: DEVL - Invoked Programs - DBnr: 2 Fnr: 2 Command: 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
Why use CHART ... HISPROG1 ________| | | CallNat Fetch HERSUBP1 HISPROG2 |________ | | Fetch InputMap HERPROGA HERMAPA | * CallNat HERSUBP1
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 referencedwill be printed
Invoking CHART On-line ... • At the "Command" prompt: Enter Code: Type: Name:Command: CH PROG1 • or at the “NEXT” prompt:NEXT chart LIB=CHARTV2
CHART "entry" screen ... 18:59:06 **** CHART for Natural V2.2D.1 **** 29/02/97 User 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
CHART "entry" screen ... 18:59:06 **** CHART for Natural V2.2D.1 **** 29/02/97 User 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 processed23 objects placed in Chart (7P 5N 9M 2L)6 objects still to be checked--Enter-Continue--PF5-ShowChart--PF3-Exit--
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 > ________________________________________
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)
Exclude Object Types in CHART ... • Exclude Maps and DataAreas and only programs and subprograms will be drawn: • HISPROG1 • ________| • | | • CallNat Fetch • HERSUBP1 HISPROG2 • | • | • Fetch • HERPROGA
Exclude Object Types in CHART ... • Exclude only DataAreas and programs, subprograms, and maps will be drawn: • HISPROG1 • _________________|________ • | | | | • CallNat Fetch InputMapInputMap • HERSUBP1 HISPROG2 HISMAP1 HISMAP2 • | | | | • | | * | • WrteForm Fetch HelpRoutHelpRout • HERFORM1 HERPROGA HISHELP HISHELP • | | • | | • InptMap# InputMap • HERMAPA HISMAP3
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
Symbols used in CHART ... • ..# (Dynamically Invoked): | | | | CallNat Fetch InputMapInputMap HERSUBP1 HISPROG2 HISMAP1 HISMAP2 | | | | InptMap# InputMap HISMAP1 HISMAP2 | | HelpRout HISMAP3
Symbols used in CHART ... • * (Descendants Suppressed): | | • | | • InputMapInputMap • HISMAP1 HISMAP2 • | | • * | • HelpRoutHelpRout • HISHELP HISHELP • | • | • InputMap • HISMAP3
Symbols used in CHART ... • + (Don’t Explode):| CallNat HISSUBP | + Fetch ERRORHDL
Symbols used in CHART ... • ? (Source Code Not Found):| | InputMap HERMAP1 | ? HelpRout HERHELP2
Symbols used in CHART ... • <n> (Descendants could not be placed):| CallNat HISSUBP | <3> Fetch ERRORHDL
Symbols used in CHART ... • i: .. (Inline Subroutines) f: .. (Database Files):| | | i:CHECK- Fetch f:CLIENT CLIENTS HISPROG2 -DETAILS | | InputMap HISMAP2
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 UpDown Lines Left Right
Objects with over 15 descendants ... Descendants are split over as many rows as necessary:
Running CHART in Batch ... JCL to runCHART formany seeds(in work file): Extra CHARTsare drawnautomatically(whenevernecessary)
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
CHART Version 2for Natural Take a good look at your system ... with CHART