Featuring: Call Hierarchy and Program Structure diagrams,

Transcription

1 IBM Software Group Rational Developer for IBM i (RDi) Application Diagram Viewer Featuring: Call Hierarchy and Program Structure diagrams, Last Update: 9/10/ IBM Corporation Agenda Application Diagram Viewer Creating diagrams in RDi Working with diagrams Saving printing diagrams Showing language structures in diagrams 2 1

2 IBM Rational Software Developer Group for Rational System software i Application Diagram overview Application Diagram Provides developers with a graphical overview of the structure of their native IBM i applications Currently supports ILE RPG, ILE COBOL, CL, programs and service programs Source Call Diagram Call graph showing subroutine, procedure, and program calls Program Structure Diagram ILE program and service program bindings Features Subroutine and Procedure invocation hierarchy Program call support Functional zoom Save as image Print selected diagrams 3 Application Diagram workbench views Main canvas Diagram Palette Outline Properties 4 2

3 Launching the Application Diagram Select resources, right click and select Visualize Application Diagram Native members, *PGMs, *SRVPGMs, IFS files and folders Local files and folders iseries project resources Multi-select available within each group Does not use any unsaved editor changes 5 Launching from the Editor Launch for single source member when open in the RSE Source Editor Always uses current contents of editor (saved or unsaved) 6 3

4 Building an Application Diagram Progress Monitor appears while diagram is being built User can click Run in Background and continue working Two phases Resolving resources (download phase) Scanning resources (building phase) 7 Source Call Diagram Aggregated relationship (something inside ORDENTR calls program SLTCUSTR) Functional zoom hides details Member ORDENTR copies member ORDMAIN Click + to see details for member 8 Diagram opens initially showing only selected members, programs, and service programs 4

5 Application Diagram - Functional Zoom Functional Zoom Start with top level resources and drill down to see lower level details as desired Diagram opens showing: Top level resources (members, programs and service programs) Direct relationships between resources Source member includes and copies, service program bindings Aggregated relationships between resources An aggregate relationship is inferred from lower levels For example: subroutine CMTORD in member A invokes subroutine VFYCUST in member B implies an aggregate relationship between member A and member B Expand members to see a call graph for the member Direct relationships still shown between top level resources Aggregate relationships updated to reflect their real source or target 9 Source Call Diagram Subroutine WrtDtaQ calls program QSNDDTAQ Subroutine SLTPART calls something inside the program SLTPARTR Subroutine RqsPart calls subroutine Process ORDENTR ORDENTR member member expanded expanded to to view view a a call call graph graph 10 5

6 Program Structure Diagram Program QQFENDSVR binds to service program QQFUTILS ILE ILE Program Program and and Service Service Program Program Bindings Bindings Selecting a node highlights it s incoming and outgoing connections Modules WFVTACC and WFVTSVR are bound into program QQFVTSVR These *SRVPGMs were not part of initial user selection so details are not shown 11 Application Diagram CL and Program Calls CL supported by the Application Diagram Includes: CL members CL procedures and CL subroutines Relationships for Includes Subroutine, procedure and program calls Program Calls are shown in the Source Call Diagram 12 Represented as a connection from the calling subroutine or procedure node to the called program For *LIBL relative calls: Program object shown in diagram with resolved library name Tooltip on connection and Calls tab of properties view show *LIBL 6

7 Outline View Outline view shows high level overview of the current diagram Two modes Thumbnail mode shows graphical overview Shaded area represents the portion of the diagram currently visible in the editor Text mode shows list of members, programs and service programs Expand member to show list of subroutines and procedures 13 Palette view Contains Zoom tool Note Text Note Attachment Can be opened as separate view Or attached to editor Happens automatically if separate view is not open 14 7

8 Application Diagram Properties Click the tabs to see additional types of information. For example, all exported procedures from a service program. Select a node or connection in the diagram and the Properties view shows additional details Who calls this procedure (or subroutine) and who it is called by. Callable Blocks are subroutines and procedures Includes are included members and copybooks 15 Agenda Application Diagram Viewer Creating diagrams in RDi Working with diagrams Saving printing diagrams Showing language structures in diagrams 16 8

9 Application Diagram Actions Here are just some of the actions you can perform in the application diagram Open source code and position to definition by double clicking on: Subroutine or procedure OPM Program Service program Module inside of an ILE program Subroutine, procedure or program call connection Positions to source line where the call is made Print diagram Document the diagram by adding notes and text Export diagram to a graphics file Re-arrange the diagram Diagrams are automatically arranged to minimize overlap and lines crossing 17 View source for selected subroutine/procedure Double click on subroutine/procedure in diagram Source editor opens member Cursor positioned at first line of subroutine/procedure 18 9

10 View source for selected incoming connection Double click on incoming connection Source editor opens member Cursor positioned at line of invocation of subroutine/procedure 19 View source for selected outgoing connection Double click on outgoing connection Source editor opens member Cursor positioned at line of invocation of subroutine/procedure 20 10

11 Add Notes to document diagram Notes can be attached to nodes and connections Using either pop-up menu or palette tool Can be used for documenting the diagram Diagram must be saved or these changes to the diagram are lost 21 Add text to document diagram Text is standalone Use palette tool to add text Can be used for documenting the diagram Has transparent background Is not attached to anything in diagram Change Properties with workbench toolbar buttons 22 11

12 Preferences Application Diagram Default Diagram Layout : Oblique Horizontal Diagram Layout switched to: Rectilinear Vertical 23 Preferences Text and Fonts More preferences under General Appearance Color and Fonts Change font in diagram Change line colors for incoming and outgoing lines 24 12

13 Preferences for individual diagrams 25 Change appearance of individual diagram Change font in diagram Change line color for connecting lines Preferences for individual diagrams 26 Change appearance of individual diagram Change font in diagram Change line color for connecting lines 13

14 Agenda Application Diagram Viewer Creating diagrams in RDi Working with diagrams Saving printing diagrams Showing language structures in diagrams 27 Saving a Diagram Diagrams are saved to workspace projects Saved as two files: Application Diagram model file (appmdl) Contains model This file is always required to open a diagram Application Diagram model diagram file (appmdl_diagram) Contains UI information Layout, notes, text, colors, fonts Optional for opening a diagram On workbench menu use File Save. 28 Select project to save files to 14

15 Saving a Diagram as image file Images are saved to windows folder Several image formats: Select Folder, name, and image format Checkbox to gen HTML tags to show image in browser Select in diagram what you want to save Right click File Save as Image File 29 Printing a Diagram Print to workstation printer Select in diagram what you want to print File Print Choose diagrams to print Choose scaling 30 15

16 Agenda Application Diagram Viewer Creating diagrams in RDi Working with diagrams Saving printing diagrams Showing language structures in diagrams 31 Technical Details - RPG Source Language Language Feature Representation in Diagram ILE RPG Main line code Subroutine Procedure Subroutine call Procedure call Program call /copy Main entry point node Subroutine node Procedure node Connection from the caller to the called subroutine Connection from the caller to the called procedure Connection from the caller to the called program. Includes connection between current member and copied member. /include Includes connection between current member and copied member

17 Technical Details - COBOL ILE COBOL Procedure division Main entry point node with name as specified on PROGRAM-ID paragraph. Sections COBOL procedure node. An implicit connection is created from the main entry point node to each section node. Paragraph COBOL procedure node. An implicit connection is created from the section node to each contained paragraph node. COBOL Procedure call (PERFORM, GO TO, MERGE, SORT, XML PARSE) Connection from the calling COBOL procedure to the called COBOL procedure. ILE Procedure call (CALL) Connection from the calling COBOL procedure to the called ILE procedure. Program call (CALL) Connection from the calling COBOL procedure to the called program. COPY statement Includes connection between current member and copied member. 33 Technical Details - CL CL Source member Subroutine (SUBR / ENDSUBR) Subroutine call Procedure call Program call INCLUDE Main entry point node with the same name as the member. Subroutine node. Connection from the caller to the called subroutine Connection from the caller to the called procedure Connection from the caller to the called program. Includes connection between current member and copied member

18 35 Summary Remote System Explorer (RSE) Application Diagram Viewer Quick program hierarchy diagram creation Navigate through the application Drill down to source code for: Nodes Connections Program Structure diagram for ILE programs See what modules are used See binding relations Use properties view to get module details The easy way to understand your application structure Lots of resources available to get you started: RPG Café with RDi hub midrange mailing list Webcasts and System i magazines COMMON and IBM Power Technical Conferences User group meetings 36 18

19 Trademarks & Disclaimers 8 IBM Corporation All rights reserved. References in this document to IBM products or services do not imply that IBM intends to make them available in every country. The following terms are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both: AS/400 IBM(logo) i5/os AS/400e iseries e (logo) business OS/400 IBM System i Lotus, Freelance Graphics, and Word Pro are registered trademarks of Lotus Development Corporation and/or IBM Corporation. Domino is a trademark of Lotus Development Corporation and/or IBM Corporation. C-bus is a trademark of Corollary, Inc. in the United States, other countries, or both. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. ActionMedia, LANDesk, MMX, Pentium and ProShare are trademarks of Intel Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. SET and the SET Logo are trademarks owned by SET Secure Electronic Transaction LLC. Other company, product and service names may be trademarks or service marks of others. Information is provided "AS IS" without warranty of any kind. All customer examples described are presented as illustrations of how those customers have used IBM products and the results they may have achieved. Actual environmental costs and performance characteristics may vary by customer. Information in this presentation concerning non-ibm products was obtained from a supplier of these products, published announcement material, or other publicly available sources and does not constitute an endorsement of such products by IBM. Sources for non-ibm list prices and performance numbers are taken from publicly available information, including vendor announcements and vendor worldwide homepages. IBM has not tested these products and cannot confirm the accuracy of performance, capability, or any other claims related to non-ibm products. Questions on the capability of non-ibm products should be addressed to the supplier of those products. All statements regarding IBM future direction and intent are subject to change or withdrawal without notice, and represent goals and objectives only. Contact your local IBM office or IBM authorized reseller for the full text of the specific Statement of Direction. Some information in this presentation addresses anticipated future capabilities. Such information is not intended as a definitive statement of a commitment to specific levels of performance, function or delivery schedules with respect to any future products. Such commitments are only made in IBM product announcements. The information is presented here to communicate IBM's current investment and development activities as a good faith effort to help with our customers' future planning. Performance is based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput or performance that any user will experience will vary depending upon considerations such as the amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an individual user will achieve throughput or performance improvements equivalent to the ratios stated here. Photographs shown are of engineering prototypes. Changes may be incorporated in production models