N2O Product Overview
Contents
1.2. N2 NATURAL Change Management with 3GL Support Track and manage changes to business critical applications So urce C om pare J and installations and N20OSCAN Product Overview TREEHOUSE SOFTWARE INC 2605 Nicholson Road Suite 230 Sewickley PA 15143 Phone 724 759 7070 Fax 724 759 7067 E mail tsi treehouse com http www treehouse com This page intentionally left blank Treehouse Software Inc N20 Product Overview Introduction to Change Management Definition The Change Process Change Management is a term used to describe the process of controlling the development maintenance and migration of software within a site s computing environment Change Management ensures that programmers make software modifications in a controlled manner and that these modifications are properly implemented into production environments Change Management also includes the maintenance of proper audit trails which track all change activity and the production of reports of this activity on demand A typical change process begins with a change request often made by an end user of the software This request reaches the programming staff which may prioritize and implement the change To implement the change programmers retrieve copies of the programs that require modification and place them in a development environment n this development environment the programs are modified and debugged Once changed the programs may
3. D230 230 54 LIB ONE PGM Compare D230 230 54 LIB TWO BAK Unique Compared Objects Total Objects Identical Different Total Objects Base 28 30 7 37 65 Compare 1 38 Compared Lines Source Comment Total Base 568 122 690 Compare 568 122 690 503 Lines match in both Libraries Options were as follows Ignore Comments Y Ignore Positions 123 Ignore Spacing Y Ignore Identical Objects Y Enter PF1 PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PF11 PF12 ra eec s YBNDA fee es e M Dee es AU uU eue Treehouse Software Inc N20 Product Overview 13 NATURAL Object Compare Treehouse Software Inc The Object Compare displays information about two NATURAL objects and indicates whether they are identical or not Information from the NATURAL directory record for the object is displayed including the User id of the person who last catalogued each object the date and time of the catalogue the version of NATURAL it was catalogued with and the date time and name of the GDA required by each object The Object Compare utility will also indicate whether the generated code for the two catalogued objects matches or not 01 12 31 OBJECT COMPARE UTILITY 11 38 00 PAYTEST PENSIONP Type Library PAYTEST User ID Date Catalg 19971027 Time Catalg NATURAL Ver 2 16 Size in user area USIZE Size in buffer pool Size in source area ESIZE Number subroutines PERFORM PAYPROD PENS
4. However N2O even prevents overwrites in parallel development situations where programmers share development libraries The Emergency Recovery utility recovers the last archived version of an object from an N2O Archive file when N20 is unavailable For example a site has two databases Database 1 and Database 2 and runs N2O on Database 1 Objects migrated to Database 2 by N2O are archived on Database 2 Database 1 crashes rendering N2O temporarily unavailable Then a problem is discovered in the code on Database 2 requiring the previous version to be retrieved To retrieve archived objects from Database 2 the site uses the Emergency Recovery utility It is not always easy to remember which objects in an application are related especially with large complex applications Therefore N20 utilizes PREDICT cross reference data to provide the user with a list of related objects affected or invoked by a specified object This list can be obtained for NATURAL objects and for 3GL Other objects XREF may be used to ensure that all objects necessary for development are migrated or to ensure that related objects are successfully cataloged in the target environment Despite having all safeguards in place execution errors may occur in production environments When this happens it may be necessary to restore a previous version of an object while the problem is being solved For this reason N2O will optionally archive any number of previous versions
5. DB Name Format s D Comments 1 AA PERSONNEL ID A8 D CNNNNNNN C COUNTRY l HD PERSONNEL ID Descriptor X Ref Information Treehouse Software Inc The Descriptor X Ref Information utility uses PREDICT cross reference data to display print a report on descriptor usage for NATURAL objects The report shows the number of times a descriptor is used to delete read search and update It also shows the number of times a descriptor is used in a data area Optionally the list of NATURAL objects that use the descriptor can be displayed N20 Product Overview 16 Object Flow Analysis The Object Flow Analysis utility displays prints NATURAL object s with connected processing loops and statement blocks for easy debugging e PE RAEE EAA E a Pasa S SS dzec z fi ceeseccs PINEENEEGEGGUN NE OU USE HEREIN eee ea ea ee ee ae oe eee oe eee eee Type Date Time User ID Terminal Ver os TP Mon Trans ese euro ND ono eee eRe aan Shee hoe oo ND FU p MUN Src 01 12 31 11 38 00 TSI0373 TSIOID 2 1 6 CMS VM CMS NT216 Obj 01 12 31 11 38 00 TSI0373 TSIOID 2 1 6 CMS VM CMS NT216 S Source Size 452 Bytes User Area USIZE 370 Bytes Buffer Pool Size 1148 Bytes Source Area ESIZE 10 Bytes Number Subroutines 1 0010 DEFINE DATA 0020 GLOBAL USIBG 0030 0040 LOCAL USING 0050 END DEFI
6. Functions are also provided to purge unwanted output from previous scan runs once they are no longer needed One function allows the user to purge unwanted output from any of their previous scan runs An administrative function is also provided to allow the N2O Administrator or anyone designated through N20 Security to delete any scan output generated by any user Batch Processing N2OSCAN can be run in batch Everything from running scans to generating hardcopy reports to purging unwanted scan output can be performed in batch A full environment scan could generate thousands of calls to the NATURAL FUSER Running the scan in batch allows for this activity to occur at a priority which will not overwhelm the on line system This also provides for the activity to be scheduled overnight or over the weekend if necessary Treehouse Software Inc N20 Product Overview 19 Source Display Treehouse Software Inc The Source Display function will display a specific object that has been scanned and display any hits When run in batch the user is provided with the option of seeing the string in bold if the printer being used supports it or seeing the string underlined using a special character selected by the user PENSION is the string searched for in this example LIBRARY PAYTEST N20SCAN SOURCE LISTING OBJECT PENSIONP REPORT DATE 1999 12 31 11 38 00 TYPE PROGRAM OBJECT SAVE DATE 1997 09 15 16 38 24 DEFINE DATA GLOBAL USING PAYROLL
7. Staging Area Development Environment 1 Development Environment 2 Acceptance Quality Y Testing Assurance Development Environment Environment Environment 3 s The N20 Environment Subsystem is completely flexible N2O can support any site s environment including complex environments like the one shown above N2O can support multiple development test production and other environments If a site s environment setup changes N2O will change with it New environments can be added quickly and obsolete environments can be removed easily Treehouse Software Inc N20 Product Overview 9 The N20 Migration Subsystem The Migration Subsystem is the core of N20 where migration requests are created and processed Migration requests are labeled by an Event name such as PAYROLL For each Event users may migrate NATURAL objects PREDICT objects SYSERR messages and or 3GL Other objects All Events are recorded by N20 They may be recalled at any later date modified if desired to include additional objects and submitted for migration One Event may initiate a migration to a single environment or to multiple target environments This is useful when the same NATURAL objects are used in multiple applications On line Migration The screen below is an example of a user adding the Event PAYROLL to migrate the selected programs from the library PAYPROD in the PROD environment to the library PAYTE
8. be placed in a testing or quality assurance environment Site personnel including the application s end users will examine the modified software If the software is accepted it is returned to the production environment If the software is rejected it is returned to the development environment where further modifications are made As the software is returned to the production environment the previous version is archived The diagram below illustrates a typical change process Production j gt Archive N Development r Test QA Treehouse Software Inc N20 Product Overview 3 Change Management Using N20 and N20 3GL Realizing the importance of Change Management and the need for tools to assist with Change Management Treehouse Software developed N20 in 1989 N20 N20 automates and tracks Change Management activity It eliminates paper trails and minimizes oversights which can occur during the change process N2O adapts to a site s environment and enforces the site s Change Management rules within that environment The product provides many features that allow sites the flexibility of defining Change Management according to their needs N20 3GL The optional and separately priced N2O 3GL feature was introduced in 1992 N20O 3GL extends N20 Change Management capabilities to non NATURAL objects such as COBOL source code JCL etc Programs Subprograms Copyc
9. migrates SYSERR messages which many sites use in their applications Applications often contain non NATURAL components such as COBOL or JCL N2O 3GL a separately priced N2O feature allows the batch migration of 3GL Other objects stored in partitioned datasets PANVALET libraries LIBRARIAN master files or ENDEVOR stages The N20 Batch Migration process provides an alternative to the on line migration process allowing sites to schedule migration activity for specific times Batch migration is required when migrating NATURAL objects between two environments which do not have network connections when migrating PREDICT objects or when migrating 3GL Other objects Batch Events are created through the on line system but the actual migration of objects occurs when the batch migration JCL is submitted N20 Product Overview 5 Checkout Checkin Emergency Recovery XREF Integration Archiving Recovery Automated Compilation Static SQL Support for DB2 Authorization Treehouse Software Inc When programmers share development tasks and libraries it is very easy for them to accidentally overwrite each other s objects Checkout Checkin is a method of controlling and monitoring changes in the Application Life Cycle of an object It protects the integrity of a checked out object by allowing only the checkout user to migrate the Object The N20 Administrator determines the number of concurrent checkouts allowed for parallel development
10. AL maps as they appear in the NATURAL Map Editor Maps may also be printed to include the field table and the list of processing verification rules The Data Area Listing utility displays prints NATURAL data areas as they appear in the NATURAL Data Area editor The File Layouts utility displays prints File Layouts using information from PREDICT or NATURAL DDMs The amount of detail can be varied for the reports to show PREDICT extended descriptions comments keywords and owners for files and extended descriptions and comments for fields COMMENTS EXTENDED D FIELDS CONTAINS UNIQUE DESCRIPTIONS OF EMPLOYEES OF AN INTERN ENTERPRISE COMPAR TO SAG ESCRIPTION KR KR KK RR RR RR RR RR RRR KK KK KKK RR KR KR KR RK KR RR KR KK e ke KK e e ke KR RRR RRR KR ke e ke ke e e K DESCRIPTION OF OBJECTS NOT FIELDS CONTAINED IN THE FILE KR KR KR RR RRR RR RRR KR KKK RK KKK KK RR KR KR KR RK KR RK KK RK kk e KK RRR RR e de ke RRR KR KEK e UNIQUE DESCRIPTION OF EMPLOYEES OF AN INTERN ENTERPRISE KR KR KR RR RRR RR RR e he RRR KR RK ke KR RRR KR KR KR RR KR RR KR kk e ke KR KR e ke kk ec ke kk e de ke kk e ke ke e e e FOR EACH OBJECT THE FOLLOWING INFORMATION IS STORED 1 PURPOSE DATA IS STORED FOR 2 WHAT INFORMATION IS STORED IN GENERAL 3 WHERE DO DATA COME FROM IN GENERAL KR KKK RK RK RK ok ck ok ckokckok ck KR KR KR RR KR RR KR k k k k k k k k k k k k k k k k k k k k k k k k k ck ck ck k k k Ty L
11. G LOCAL USING PENSIONL LOCAL 01 RETIRE DATE A8 01 RETIRE AGE N3 01 EARLY PENSION L END DEFINE INPUT USING MAP PENSIONM WRITE PENSION FOR SOCIAL SECURITY NUMBER SS WRITE NAME LAST NAME FIRST NAME MIDDLE I WRITE SALARY SALARY WRITE YEARS OF WORK YEARS INCLUDE PENSIONC WRITE PENSION RATE PENSION RATE PERFORM PENSIONS END END OF LISTING N20 Product Overview 20 Standard Report Options are available to limit the statistics and the level of detail printed on the standard report For example an option is provided to inhibit the display of statistics for any objects without hits Generated 2001 12 31 11 38 00 N20SCAN Output Standard Report KR KK KKK e ke e ke e ke e ke e RR KR RR RRR RRR RRR RRR RRR RRR RR RRR RRR RRR RRR KR RR RRR RRR RR ck ck ck ck kckckckckckckckckckckckckckckokckokckokckckckckckckckckckckckckckckckckckckockckckckockokock okk kx e x Scan Output Set User ID TREE24 100 0 Scan Parm Set PAYTSCAN Environment DB1 36 6 End Object Scan Completed Start Library PAYTEST End Library Start Object 1999 12 31 11 38 00 Libraries Scanned Objects Scanned Lines Hit Lines Scanned Non comment Lines Hit Non comment Lines Scanned Libraries Hit Objects Hit Pct Libraries Hit Pct Objects Hit 60 39 Pct Lines Hit 3 044 38 Pct Non comm Lines 2 770 kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk
12. IONP Library PAYPROD User ID 398 1164 10 1 Date Catalg 19961005 Time Catalg NATURAL Ver 2 16 Size in user area USIZE Size in buffer pool Size in source area ESIZE Number subroutines PERFORM 01 12 31 TSIO1 11 38 10 Compare 390 1120 10 1 PROGRAM TREE27 09 55 39 Bytes Bytes 10 34 23 Bytes Bytes Bytes Object The two object codes do not match N20 Product Overview TSIO1 TSI703 Structured Mode Jobname TREE27 Terminal ID TSI703 GDA Name PAYROLLG GDA Date 19931201 GDA Time 14 04 55 Structured Mode Jobname TREE11 Terminal ID TSI706 GDA Name PAYROLLG GDA Date 19941005 GDA Time 15 33 36 LS 80 PS 23 OBJECT COMPARE UTILITY TSI703 Library PAYPROD 14 The N20 Toolbox Subsystem Documentation Tools The Documentation Toolbox function provides utilities to display print NATURAL Objects File Layouts Descriptor X Ref Cross Reference Information Object Flow Analysis and Object X Ref in local N20 environments NATURAL Object Listing Treehouse Software Inc The NATURAL Object Listing utility displays prints NATURAL source code A number of options are provided including the ability to explode copycode and data areas in the listing of the source member the ability to display print maps and data areas as they appear in their respective editors the ability to exclude specific object types in the printing of ranges and th
13. NE 0060 END DEFINE 0070 LOCAL REPEAT 0080 REPEAT INPUT USING MAP 0090 0110 0120 0130 0140 0150 0160 0170 WRITE WRITE WRITE INCLUDE PERFORM INCLUDE PERFORM INPUT 0180 ESCAPE BOTTOM 0190 ESCAPE END IF 0200 END IF END REPEAT 0210 END REPEAT 0220 END TAX PROGRAM FEDTAXP DEFINE DATA GLOBAL USING PAYROLLG INPUT USING MAP FEDTAXM 0100 WRITE TOTAL TAXES DUE FOR SOCIAL SECURITY IF DECISION INPUT FUNCTION TERMINATED USING FEDTAXL FIRST NAME FIRST NAME MIDDLE MIDDLE I LAST NAME LAST NAME FEDTAXC FEDTAXS NO BOTTOM Object X Ref The Object X Ref utility displays prints PREDICT cross reference information for NATURAL object s identifying copycode data areas DDMs files programs subroutines subprograms variables within data areas and views referenced Treehouse Software Inc N20 Product Overview 17 The N2O Toolbox Subsystem The N2OSCAN Utility N2OSCAN goes beyond the capabilities of the NATURAL SCAN utility to provide Programmers and Analysts with extensions and flexibility which make searching for specific strings within NATURAL objects easier than ever With N2OSCAN not only can entire NATURAL libraries be searched but also ranges of NATURAL objects and ranges of NATURAL libraries within a NATURAL FUSER Absolute scans are supported to allow for searching of strings starting with or containing a specif
14. RROR objects in the Event received compile errors during the Autocompile process and RECOVERD objects in the Event received compile errors during the Autocompile process and the Event was automatically recovered Messages Valid Values E Event Details O Object Details 01 12 31 N 2 O EVENT REPORTING TSIO0373 11 38 00 EVENTS WITH WARNING MESSAGES TSI1 Change Page 1 Closed Control A12345 A12345 A12345 A12345 01 10 05 kockck ck kk kA 01 10 01 01 10 03 08 43 21 KRKKKKKKK 11 34 55 12 14 16 Warning RECOVERD AC ERROR OVERRIDE RECOVERD Enter PFl PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PF11 PF12 Sect esse END haaa see boa LIESS ee eee ee 62 STOP Custom Reporting File layouts are distributed with N2O to permit the site to create custom reports based on all of the information retained by N2O Treehouse Software Inc N20 Product Overview 12 The N20 Toolbox Subsystem Compare Utilities The N2O Toolbox Subsystem provides tools which can assist programmers in their development activities These tools include NATURAL object comparison source code comparison and source display Source Compare The Source Compare utility identifies differences between the source code of a pair of NATURAL objects located on an FUSER or an N20 Archive file local to N20 The ability to compare a single pair of objects a range of objects or two complete NATURAL libraries is provided
15. SERVIEWS MODULES VERIFICATION RULES REPORTS The migration of PREDICT objects is performed in batch mode only N20 migrates user supplied SYSERR error messages in short and or extended format based on the language type of the message With the optional N2O 3GL feature an Event can also include 3GL Other objects This capability enables a site to have a single point of control for all migration activity The example screen below shows a user selecting COBOL programs as part of a migration request The Event 3GL MIG will migrate the selected objects from the PDS specified by TEST to the PANVALET library specified by PROD N2O 3GL can also migrate 3GL Other objects between PDSs LIBRARIAN Master Files and ENDEVOR Stages 01 12 31 09 00 00 N 2 O ADD AN EVENT Event COBOL PAYROLL To Env PROD Starting Member Member Member Type COBOL PGM COBOL COBOL 2 COBOL COBOL 4 COBOL COBOL 6 COBOL TSI0373 3GL MIG Sequence TSI1 DSN Name From Env TEST Category COBOL COBOL PGM Member Member Type Message COBOL 1 COBOL ADD COBOL 3 COBOL COBOL 5 COBOL Message S REPLACE A REPLACE Enter PFl PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PFl11 PF12 HELP END TOP UP DOWN BOT STOP N20 with N20 3GL migrates ASSEMBLER COBOL FORTRAN PL I and RPG source code as well as JCL and other data types N20O 3GL provides Checkout Checkin and audit trails for 3GL migrations which allow th
16. ST in the TEST environment Type A to Add Program to the Event D to Delete 01 12 31 N 2 O ADD AN EVENT TSIO0373 11 38 00 Event PAYROLL Sequence 30 TSI1 From Env PROD From Library PAYPROD To Env TEST To Library PAYTEST Starting Program FEDDISP1 Program Program Program Type S C Message S Program Type S C Message FEDDISP1 MAP REPLACE FEDDISP2 MAP FEDTAXC COPYCODE FEDTAXS SUB RTN FEDTAX2 PROGRAM LIFEINSC COPYCODE LIFEINS2 PROGRAM S REPLACE FEDTAXL LOCAL S FEDTAX1 PROGRAM S REPLACE LIFDISP1 MAP S ADD LIFEINS1 PROGRAM S REPLACE S S S S S S Enter PFl PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PF11 PF12 HELP ALL END TOP UP DOWN BOT STOP The selection process may be affected by these optional N2O features Checkout Checkin XREF Verification of the existence of PREDICT documentation Object code timestamp verification Verification of the existence of PREDICT XREF data The migration process may be affected by these N2O features Move or copy Batchor on line Authorization levels and order of authorization Migration of source code cataloged objects or both Autocompile automated compilation Archiving Treehouse Software Inc N20 Product Overview 10 PREDICT Migration SYSERR Migration 3GL Migration Treehouse Software Inc These PREDICT objects are migrated by N20 KEYWORDS RELATIONSHIPS USERS SYSTEMS DATABASES PROGRAMS FILES U
17. The following screen is displayed to show the differences found between a pair of objects 01 01 15 N 2 O SOURCE COMPARE UTILITY Report Page ag 14 08 00 Source Code Object Page a Base gt gt gt gt Env Def D230 Library LIB ONE PROGRAM PGM ONE Mode REPORT gt gt gt gt Comp Env Def D230 Library LIB TWO PROGRAM PGM TWO Mode REPORT mmmm SHES ete cee Leta che ele ce tive ct Sine we here edie bel Die totems sce tes 0010 0010 THIS IS A PROGRAM IN THE PAYROLL SYSTEM WHICH eee sooo lt lt lt MATCHING BLOCK gt gt gt 0050 0050 MOVE 1 TO INDEX 0060 ADD 3 TO TOTAL 0070 IF TAX 1 TAX 2 0080 DO 0090 WRITE THE FIGURES DO NOT MATCH DOEND 0060 ADD 2 TO TOTAL 0100 0070 CALCULATION ROUTINE eee ES lt lt lt MATCHING BLOCK gt gt gt 0140 0110 SUBTRACT 1 FROM REMAINDER 0150 RESET I J 0160 0120 Enter PFl PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PF11 PF12 END INFO LEFT RIGHT Range Statistics include the total number of identical changed and total unique NATURAL objects broken down by object type compared for the range of objects and the cumulative number of NATURAL source comment and total lines compared for the range of objects 01 12 31 N 2 O SOURCE COMPARE UTILITY Report Page 4 11 38 00 Range Statistics Object Page 1 Env Dbid Fnr Library Start Object End Object Base
18. Utilities Documentation Tools Audit Trails Reporting Integration with SECURITRE User Friendly Interface Treehouse Software Inc A Program Locking option is available to prevent users from editing an object once it has been selected for migration Program Locking may occur when an Event is created or when the Event is authorized for migration The program is automatically unlocked after migration is completed The Source Compare utility identifies differences between the source code of a pair of NATURAL objects located on an FUSER or an N2O Archive file local to N2O The ability to compare a single pair of objects a range of objects or two complete NATURAL libraries is provided The NATURAL Documentation Toolbox provides the user with a number of utilities that allow to printout NATURAL source code that goes beyond the NATURAL LIST COMMAND It provides utilities to print NATURAL objects File Layouts Descriptor X REF Information Object Flow Analysis and Object X REF The user may printout one Object or a Range of Objects A number of options allow the user to select the amount of detail required Managers auditors and others must be able to determine the origin of program changes As part of its function N2O maintains a complete audit trail of all migrations An extensive selection of reports is provided to assist auditors the N2O Administrator and programmers Additionally the Project Tracking Subsystem is availabl
19. e N2O Administrator to effectively manage the changes in 3GL environments The migration of 3GL Other objects is performed in batch mode only N20 Product Overview 11 The N20 Reporting Subsystem The Reporting Subsystem gives a site immediate access to the details of an Event the migration history of an object Checkout Checkin status directory lists user and approval profiles and archived objects History of an Object One of the many N20 reports is the History of an Object The following report shows the history of the NATURAL program PAYPROG indicating its migration between various development test and production environments Type X to display Event Details or Utility Details 01 12 31 11 38 00 01 10 14 01 10 13 01 10 12 01 10 10 01 10 10 01 10 03 01 09 30 01 09 25 01 09 21 01 09 20 Enter PFl PF2 PF3 PF4 PF5 PF6 END Object Event Utility Seq CHECKOUT CANCEL PAY OUT PAY IN PAY TEST N 2 O OBJECT REPORTING TSIO0373 HISTORY OF AN OBJECT TSI1 PAYPROG From To Env PROD TEST DEV TEST DEV DEV DEV DEV PROD TEST Added Message UserID S C kk KKK KK S S C S C PF7 PF8 PF9 PF10 PF11 PF12 STOP Events with Warning Another N2O report identifies Events that received a warning message Warning messages include the following OVERRIDE objects in the Event were migrated without proper authorization AC E
20. e ability to display print XREF data after the source listing VM CMS VM CMS eee Se Se a E a ee ea Se a ee ae eee Type Date Time User ID Terminal Ver oS oszk uredcgcIcQ e LLLLc eceldezcusdllc E A HAA comam cimus Src 01 12 31 11 38 00 TSI0373 TSIOID 2 1 6 CMS Obj 01 12 31 11 38 00 TSI0373 TSIOID 2 1 6 CMS a a E EE EIEEE EE EIE A E AEE EE E E E E E A Se Oe EEE Source Size 452 Bytes User Area USIZE 370 Bytes Buffer Pool Size Source Area ESIZE 10 Bytes Number Subroutines Nn Ne a a Na 0010 TAX PROGRAM FEDTAXP 0020 DEFINE DATA 0030 GLOBAL USING PAYROLLG gt TOTAL 0040 0050 LOCAL USING FEDTAXL gt SALARY gt TAX RATE gt LAST NAME gt FIRST NAME gt MIDDLE I gt SS gt DECISION 0060 END DEFINE 0070 0080 REPEAT 0090 INPUT USING MAP FEDTAXM 0100 WRITE TOTAL TAXES DUE FOR SOCIAL SECURITY SS 0110 WRITE FIRST NAME FIRST NAME 0120 WRITE MIDDLE MIDDLE I 0130 WRITE LAST NAME LAST NAME 0140 INCLUDE FEDTAXC gt 0010 gt 0020 WILL CALCULATE THE TOTAL TAXES OWED gt 0030 gt 0040 COMPUTE TOTAL TAX RATE SALARY 0150 PERFORM FEDTAXS 0160 0170 IF DECISION N 0180 INPUT FUNCTION TERMINATED 0190 ESCAPE BOTTOM 0200 END IF 0210 END REPEAT 0220 END N20 Product Overview 15 Map Listing Data Area Listing File Layouts The Map Listing utility displays prints NATUR
21. e to document and report every change made to an application N20 can be secured by its own security mechanism or by Treehouse Software s SECURITRE Sites using SECURITRE a separate product can optionally use their System Security Facility SSF i e RACF ACF2 or TOP SECRET to secure migrations and access to N2O and N20O 3GL functions This reinforces the use of an SSF as a single security rule base for the site N20 is menu driven and provides the ability to navigate through the System using direct commands or PF keys The Direct Command line may be used to execute NATURAL system commands within N2O On line help screens display information about the current function or identify the data entry requirements for a field N20 Product Overview 7 The N20 Environment Subsystem After installing N2O sites define the specific information which constitutes their environment N20 adjusts to users environments and their Change Management procedures N2O uses a site s existing FUSER and FDIC files as well as databases libraries and naming conventions N20 3GL uses a site s 3GL repositories for migrating 3GL objects and follows a site s 3GL naming conventions The N2O Environment Subsystem allows the DBA or N2O Administrator to specify the following information to N2O Environment Environment Definitions represent NATURAL FUSER and FDIC files PDSs or a Definitions site s PANVALET LIBRARIAN ENDEVOR repositories These definitions a
22. ic set of characters Because it is a character string search and the user specifies what to search for it can search strings in any language including English French and German Searches are not limited to a single string Multiple search strings may be specified within a single pass of the NATURAL objects Additionally to eliminate false hits from the scan output the user may specify strings to exclude from the search For example this permits an absolute scan for the string DATE which excludes occurrences of the NATURAL statement UPDATE Search parameters and strings are created and maintained using the NATURAL Editor These parameters and strings which are called Scan Parm Sets are stored as NATURAL text objects allowing them to be specified modified and used multiple times Results from a scan run include a detailed list of all hits indicating the specific lines where strings were found as well as summary data showing statistics at the object library and complete run levels All scan results are stored in an ADABAS file allowing for further analysis and reporting The results can be viewed either on line or printed out in batch Environment Scan The Environment Scan Utility permits scans to be conducted on an entire Utility Environment a range of libraries a single library a range of objects or a single object Library Scan Utility The Library Scan Utility permits scans to be conducted on an entire library a
23. k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k kk k k kk kk kk kk kk kk kkk kk kk kk kk kkk kkk kkkkkk Scan Output Set Scan Output Set Statistics User ID TREE24 Start Library PAYTEST Libraries Hit Pct Libraries 100 0 Scan Parm Set PAYTSCAN End Library Libraries Scanned Environment DB1 Start Object Objects Hit Pct Objects Hit 36 6 End Object Objects Scanned Lines Hit Pct Lines Hit Scan Completed 1999 12 31 11 38 25 Lines Scanned Non comment Lines Hit Pct Non comm Lines Non comment Lines Scanned Obj Nbr Library Object Type Line Hits C String Found PAYTEST KAH0100M PAYTEST PAY0100M PAYTEST PAY0100T PAYTEST PAY0110M PAYTEST PAY0110T PAYTEST PAY0120M PAYTEST PAY0120T PAYTEST PAY0130M PAYTEST PAY0130T PAYTEST PAY0140M PAYTEST PAYO140T 0015 0015 0011 0018 0011 0024 0011 0020 0011 0016 0011 SSS ESSER SSS PAYTEST CITYTAXM PAYTEST FEDTAXM PAYTEST FICAM PAYTEST LIFEINSM PAYTEST PENSIONM PAYTEST SALARYM 0022 0022 0022 0021 0020 0018 SSSSES PAYTEST CITYTAXM PAYTEST FEDTAXM PAYTEST FICAM PAYTEST KAH0100M PAYTEST LIFEINSM PAYTEST PAY0100M PAYTEST PAYO100T PAYTEST PAY0O110M PAYTEST PAYO110T PAYTEST PAY0120M 0024 0024 0024 0019 0023 0019 0015 0022 0015 0028 UGSGE EGGS EGRE GEGR OR Treehouse Software Inc N20 Product Overview 22 The N20 Project Tracking Subsystem The Project Tracking Subsystem allows users
24. kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk Library Objects Hit 22 Objects Scanned 60 Lines Hit 39 Lines Scanned 3 044 Non comment Lines Hit 38 Non comment Lines Scanned 2 770 kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk Object Type Pct Objects Hit 36 6 PAYTEST Pct Lines Hit Pct Non comm Lines Hit 3 Lines Hit 2 Lines Scanned 76 Non comment Lines Hit 2 Non comment Lines Scanned 67 Pct Lines Hit CITYTAXM M Pct Non comm Lines Hit kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk Object Type Lines Hit 2 Lines Scanned 76 Non comment Lines Hit 2 Non comment Lines Scanned 67 Pct Lines Hit FEDTAXM Pct Non comm Lines Hit kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk Object Type Lines Hit Pct Lines Hit Lines Scanned Non comment Lines Hit Non comment Lines Scanned Pct Non comm Lines Hit Treehouse Software Inc N20 Product Overview 21 String Found Report The Strings Found report will show the user all of the strings found during a scan run The report which is sorted by the string found displays the library object line number and number of hits Generated 2001 12 31 11 38 00 N20SCAN Output String Found Report Sorted by String Found gt KR KKK RRR koe koe ko k k k k k k k k k k k k k k k k k k k k k k
25. ode Maps Helproutines Subroutines etc SYSERR PREDICT gool ume Code not found P Files toc Nui er not oun D t b DDMs etc Controlled by N 0 3GL PARTITIONED ipRARIES MASTER STAGES PDSs FILES COBOL COBOL COBOL COBOL PLA PLA PLA PLA JCL JCL JCL JCL FORTRAN FORTRAN FORTRAN FORTRAN Assembler Assembler Assembler Assembler etc etc etc etc Controlled by N50 with the optional N 0 3GL feature Treehouse Software Inc N20 Product Overview 4 N2O Features N20 offers a feature set which is unmatched by any other Change Management product N20SCAN Documentation Toolbox Project Tracking Subsystem On Line Request System Migrating NATURAL Objects Migrating PREDICT Objects Migrating SYSERR Messages Migrating 3GL Other Objects Batch Migration Treehouse Software Inc The N2OSCAN utility processes the source of NATURAL objects scanning for strings over the object library range specified by the user and reports on and records for future lookup all matches In the past this incredibly robust tool was the missing piece in the Y2K puzzle for many sites However it can be used for more than just date related conversions and it will certainly be useful well beyond the year 2000 The Documentation Toolbox provides utilities to print NATURAL objects File Layouts Descriptor X Ref Cross Reference Information Object Flow Analysis and Object X Ref in local N2O envi
26. of NATURAL objects and SYSERR messages replaced during a migration N2O 3GL will optionally archive 3GL Other objects migrated to PDSs Archived objects may be recovered as needed through a simple Event request Currently PREDICT objects are not archived Manual compilation of migrated programs can be a tedious and error prone process N2O can facilitate the compilation of migrated NATURAL objects and 3GL objects in the target environment During automated compilation Autocompile XREF information may optionally be obtained on the target to determine related objects which are to be included as part of a NATURAL compilation N20 automates processing tasks at NATURAL for DB2 sites N2O can automatically generate DBRMs containing the Static SQL used in NATURAL for DB2 objects N2O will then BIND the DBRMs into a DB2 Package or Plan Sites often want to ensure that changes to important environments are properly authorized For this reason N2O provides the ability to assign authorization levels to a migration path Routine migrations between development environments may occur without authorization Migrations targeted for production or system test environments may require one or more levels of authorization A complete audit trail of authorizations is provided through an on line facility in N2O N20O also enables sites to specify the order in which authorizers must approve an Event N20 Product Overview 6 Program Locking Option Comparison
27. oject to reflect the addition of new benefits In this report we see the history of this task from the moment it was defined on November 21 1998 up to the point that it was officially completed on January 25 1999 The Project Tracking Subsystem is a feature not available in other NATURAL Change Management products Treehouse Software Inc N20 Product Overview 24 Documentation and Installation N20 documentation includes a User Manual and an Administrator Manual These manuals contain sample screens along with complete descriptions The manuals are fully indexed All TSI documentation is available on our Web site at www treehouse com or on CD ROM N20 Reference Cards are also available from Treehouse Software These cards provide basic information needed by N2O users and administrators Any NATURAL site may request free N20 Reference Cards N20 executes under all IBM and compatible operating systems that can run ADABAS and NATURAL including OS 390 MVS VM VSE and BS2000 N2O 3GL currently interfaces with PANVALET LIBRARIAN and ENDEVOR and migrates objects contained in OS 390 MVS PDSs Installation and setup are easy Customer Support Treehouse Software provides support for N2O and its other products from its headquarters in Sewickley Pennsylvania and on the Web at www treehouse com Treehouse affiliates provide first level support for sites in their market areas refer customer problems to Treehouse Software as needed N20
28. on line and batch migrations checkout checkin PREDICT XREF integration archiving and recovery automated compilation static SQL support for NATURAL DB2 authorization and many more N20 provides complete project tracking capabilities that can be integrated with the migration request system e N20 provides complete audit trails and full reporting capabilities including the option to produce custom reports e N2Ois flexible as it adjusts to a site s Change Management needs e N20 is continually being enhanced by a staff of full time developers who are highly responsive to customer requests e N20 is installed easily and it is operating system and TP system independent N20 is the ideal Change Management system for NATURAL objects PREDICT objects SYSERR messages and 3GL Other objects that has been available since 1989 Visit Treehouse Software s web site at www treehouse com or contact us at 412 741 1677 NATURAL NATURAL Security System ADABAS and PREDICT are products of Software AG ENDEVOR PANVALET ACF2 TOP SECRET and LIBRARIAN are products of Computer Associates RACF and DB2 are products of IBM The information used in the examples in this product overview is for illustrative purposes only Treehouse Software Inc N20 Product Overview 27 TREEHOUSE SOFTWARE INC 2605 Nicholson Road Suite 1230 Sewickley PA 15143 Phone 724 759 7070 Fax 724 759 7067 E mail tsi treehouse com http www treehouse com
29. range of objects or a single object Select Object Scan The Select Object Scan Output Set function displays statistical information about Output Set the objects that were scanned Valid Values L List strings found S Source View 01 12 31 N 2 O SELECT OBJECT SCAN OUTPUT SET TSI004 11 38 00 TSI019 User ID TREE18 Environment PROD Scan Parm Set SAMPLEOI Start Library PAYROLL Start Object PAY End Library End Object PAYPGM6 Start List at Object Obj Lines Lines Lns NonCom NonCom NonC Object Type Hit LnsHit LnsTot LnHit PAYCALC PAYPGM1 PAYPGM2 PAYPGM4 PAYPGM5 Enter PF1 PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PF11 PF12 Statistics shown include the number of lines where any of the strings specified were found Lines Hit the total number of lines in the object Lines Total and the percentage of lines within the object which have any of the strings specified Lns Hit N2OSCAN will also differentiate between comment and non comment lines showing the same statistics for non comment lines NonCom LnsHit NonCom LnsTot and NonC LnsHit Treehouse Software Inc N20 Product Overview 18 Object Source View The Object Source View function displays the source code of a scanned object with found strings hits highlighted This scan was performed using the SAMPLEO1 Scan Parm Set delivered with N2OSCAN as input SUB PGM PAYCALC Lib PAYROLL saxea lac ee 62 oe Se Hie ve Bsc Sie Pies SES wre el es
30. re given names such as TEST PROD or DEV Migration Profiles Migration Profiles represent the paths that Objects follow through the Application Life Cycle Migration Profiles include a number of options to make migrations as flexible as possible Migration Profiles determine whether the migration occurs in batch or on line whether it involves source code cataloged objects or both whether it includes target compilation and whether it requires authorization Master Events All Migration requests in the N2O system are uniquely identified by a Master Event name such as PAYROLL This name represents parameters necessary to migrate objects from one environment to another environment or environments e g TEST to PROD Security Rules Security for N2O is based on profiles that control who may access N20 functions and sub functions and who may migrate between various environments Menus display only the functions that a particular user may access Sites using Treehouse Software s SECURITRE product have the option of using a SSF i e RACF ACF2 or TOP SECRET to control N2O use and migration activity Treehouse Software Inc N20 Product Overview 8 Can you manage change requests in a complex environment like this gt Cc Producten End User Remote ud Production 3 Training Production Environment 1 Ervirofment Environment 2 Environment X Remote Production Archive Archive Base Environment Pre Production
31. ronments The N20 Project Tracking Subsystem maintains information about organizational activities It is designed to provide a framework for sites to use in developing the project information they require The Project Tracking Subsystem can be used to manage NATURAL and non NATURAL application development projects Project Tracking can also manage hardware and software installations documentation efforts and other non programming activities The N2O on line request system makes Change Management user friendly for programmers and administrators The request system is used to create modify and authorize requests for the migration of objects from one environment to another Programmers use the on line system to create an Event which is a request to migrate objects from one location to another Detailed information about Events is recorded automatically by N2O An Event may involve the migration of any combination of the following objects NATURAL objects PREDICT objects SYSERR messages and 3GL objects N20 migrates NATURAL objects inlcuidng programs subprograms copycode maps subroutines data areas helproutines and text Many sites enhance their development efforts through the use of PREDICT making the management of PREDICT objects an important issue N2O allows the batch migration of PREDICT databases files and DDMs keywords modules program documentation relationships reports systems users and verification rules N20
32. ses Diss bo bese MOdEs STRUCT DEFINE DATA PARAMETER 01 NAME A30 LOCAL USING EMPVIEW LOCAL 01 CURRENT DATE A6 01 LAST YY A2 END DEFINE MOVE EDITED DATX EM YYMMDD TO CURRENT DATE Kk FIND EMP INFO BY KEY WHERE EMP NAME NAME ACCEPT IF EMP RAISE Y REJECT IF EMP HIRE DATE gt CURRENT DATE IF CURRENT DATE GE EMP RAISE DATE COMPUTE EMP SALARY EMP SALARY EMP SALARY 0 05 UPDATE ELSE INPUT WITH TEXT RAISE DATE FOR THIS EMPLOYEE NOT REACHED USING MAP INVALID DATE MAP END IF PF3 EXIT PF4 UPDATE INFO Scan Output Detail The Scan Output Detail function displays strings found and the line numbers of Function the lines on which they were found in the object selected However if the object selected is a data area lines will be numbered sequentially 01 12 31 N 2 O SELECT OBJECT SCAN DETAIL TSI004 11 38 00 TSI019 User ID TREE18 Environment PROD Scan Parm Set SCPRD1 Start Library PAYROLL Start Object PAY End Library End Object PAYPGM6 Library PAYROLL Object PAYCALC Type N Line Nbr C String Found CURRENT DATE LAST YY CURRENT DATE DATX EMP HIRE DATE CURRENT DATE CURRENT DATE EMP RAISE DATE DATE INVALID DATE MAP DATE Enter PF1 PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PF11 PF12 Scan Output MaintenanceWhenever a user generates new scan output using the same parameters N2OSCAN will automatically delete the old version of the output first
33. site may wish to have task groups such as Enhancements Maintenance or Training One site may wish to have priority values that are numeric such as 1 for low priority and 10 for high priority Another site may wish to have mnemonic priority values such as H for High M for Medium and L for Low N20 Product Overview 23 Reports The Project Tracking Subsystem includes a number of reports that display project tracking information For example consider the History of a Task report shown below N 2 O PROJECT TRACKING REPORTS TSIO373 HISTORY OF A TASK BENEFITS 000001 TSI1 Project PAYROLL User ID COMPLETED 01 01 25 3 3 TSIO171 TASK COMPLETED TO SPECIFICATIONS APPROVAL 2 01 01 23 3 TSI0197 APPROVED BY SYSTEM MANAGER APPROVAL 1 01 01 22 TSI0191 APPROVED BY DEPT LEADER DEVELOPED 01 01 20 TSI0174 ADJUSTED TO STANDARDS REJECT 01 01 18 TSI0191 DID NOT MEET CODING STANDARDS DEVELOPED 01 01 08 3 TSIO171 CODING COMPLETED FOR NEW BENEFITS INITIATED 98 12 27 TSI0171 BEGAN CHANGES FOR NEW BENEFITS DEFINED 98 11 21 3 TSIO171 ADD NEW BENEFITS TO PAYROLL APPL Enter PFl PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PFl1 PF12 seer eee END ete Eee Sees uL Lez eL lol l2 STOP This report displays the progression of task number 000001 for the BENEFITS task group in the PAYROLL project From the information in the Comments column we see that this task relates to changes needed in the PAYROLL pr
34. to track a project from the moment it is proposed to its approval and use in production The screen below shows a Project PAYROLL that has been defined to N20 Project Definition Task Information User Defined Values Treehouse Software Inc TSIO373 TSI1 01 12 31 11 38 00 N20 PROJECT DEFINITION PAYROLL 01 12 31 10 32 27 TSI0171 THIS IS A SAMPLE PROJECT Project Updated Short Desc Priority Values Impact Values Task Groups BENEFITS TAXES INSURNCE MISC PRE DESIGN High A1 INITIATED A2 DEVELOPED A3 APPROVAL 1 APPROVAL 2 COMPLETED Q Xo 00 1 OY Ul i C N r2 m Low Low Enter PFl1 PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PF11 PF12 END STOP Each project has certain tasks associated with it Task groups are used to logically separate related tasks within a particular project Stages relate to the logical progression of a task from beginning to end such as milestones Each task can have a priority value assigned to it indicating its relative urgency A task may also have an impact value associated with it to indicate the impact of a particular task on the entire project The task groups stages priority values and impact values are all user defined values allowing for complete flexibility For example one site may wish to have task groups that relate to a specific functional area such as Documentation Programming or Testing Another
35. users have direct access to the product developers User questions are answered quickly problems are discussed directly with developers and change enhancement requests are reviewed and implemented in a timely manner Technical representatives are available to assist in the setup and operation of N2O during installation Treehouse Software Inc N20 Product Overview 25 Free Trials N20 is available under a no obligation 30 day free trial agreement and is available either on tape or for download from our Web site at www treehouse com N20 is attractively priced N2O 3GL which is provided at a separate price includes support for PDSs PANVALET ENDEVOR and LIBRARIAN Please contact Treehouse Software to obtain reference names or the Treehouse Documentation CD free of charge Change Management and N20 Evaluator Kit To assist sites in evaluating N2O and other Change Management products Treehouse Software developed an N20 Evaluator kit which is available on our Web site at www treehouse com Evaluator kits for other products are also available Treehouse Software Inc N20 Product Overview 26 Summary e N20 provides comprehensive and flexible Change Management for NATURAL objects PREDICT objects and SYSERR messages N20O 3GL provides Change Management for 3GL Other objects stored in PDSs PANVALET LIBRARIAN or ENDEVOR e The N2O features include a string search capability N2ZOSCAN documentation tools on line request system
Download Pdf Manuals
Related Search