ZZUtils Tools for Natural Developers LEN C ONSULTING LLC Ralph Zbrog

2 Over 20 years of experience with SAG products California-based consultancy LEN C ONSULTING LLC ZZUtils Consulting and application development services Training Software AG Technology Partner

3 ZZUtils is a set of over two dozen utilities for the Natural developer, administrator, and DBA Natural is a full-featured product ZZUtils Introduction Available for MVS; planned for VM/CMS, VSE, and BS2000; WinXP in development ZZUtils fills in some of the holes

4 Does your organization adhere to the policy? Does your organization have a policy of source code review? Source Code Reviews Organizational Policy Why is such a policy instituted? (benefits) Why is it not followed? (excuses)

5 Improved application performance Enforce shop standards Source Code Reviews Benefits Improved code quality Mentoring Improved developer performance Review by DBA and performance teams

6 Deleted code Manual effort to create an effective document Volume of data to be reviewed Source Code Reviews Excuses Developer reluctance to be involved Lack of consistency Distribution logistics

7 Accurate source comparison Automate document creation List Adabas commands Source Code Reviews Solutions Training, mentoring, management support Review checklist Soft-copy document

8 Pagination Natural, COBOL, JCL, PROC, control Sample reports Source Code Reviews Effective Document Highlighting Softcopy

9 Sample output Sample “set” Set verification Source Code Reviews ZZTDOC Example ZZTDOC Word macro Generated document

10 ZZTDOC – Generate walkthrough document ZZTDOC LEN Consulting LLC 06/09/ :55 Natural Utilities ZZUtils v2.1 Generate Code Walkthrough Document Profile: ZZUTIL/ZBROG Old: Env: D Library: ZZUTIL__ Member: ________ Type: N PDS: ZBROG.PROD.JCL______________________________ New: Env: D Library: ZZUTIL__ Member: ________ PDS: ZBROG.TEST.JCL______________________________ Set: Library: ________ Member: ________ Listing: Compare: F Context: 10 Delta: N Summary: N Ada Cmd: Y ILRC: N Type: L Print: ID: LASERJET Class: 2 Hold: Y Copies: 1 Sysout: N File: Disp: O Name: ZBROG.TDOCLIST________________________________________ Job: Suffix: T Account: ABCDEF__ Info: 1234 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Vrfy Help Auth Exit SetV MPswd Membr JCL Sub Set Verification will clear the editor work area

11 ZZTDOC – Set selection ZZTDOC LEN Consulting LLC 06/09/ :13 Natural Utilities ZZUtils v2.1 Generate Code Walkthrough Document Profile: ZZUTIL/ZBROG Old: Env: D Library: ZZUTIL__ Member: ________ Type: N PDS: ZBROG.PROD.JCL______________________________ New: Env: D Library: ZZUTIL__ Member: ________ PDS: ZBROG.TEST.JCL______________________________ Set: Library: zzutil__ Member: zzmatchd Listing: Compare: F Context: 10 Delta: N Summary: N Ada Cmd: Y ILRC: N Type: L Print: ID: LASERJET Class: 2 Hold: Y Copies: 1 Sysout: N File: Disp: O Name: ZBROG.TDOCLIST(zzmatchd)______________________________ Job: Suffix: T Account: ABCDEF__ Info: 1234 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Vrfy Help Auth Exit SetV MPswd Membr JCL Sub

12 ZZTDOC – Set example > > + Text ZZMATCHD Lib ZZUTIL All Mode Structured * ZZMATCHD 0020 * 0030 env-old=d,lib-old=zzutil, env-new=d,lib-new=zzutil, mem-type=n 0060 * 0070 mem-old=zzmatch,mem-new=rgzmatch, compare=c,context=10,delta=n,summary=n,adacmd=n,ilrc=y,list=l mem-old=zzmatch,mem-new=rgzmatch, compare=f,delta=y,summary=y,adacmd=y,ilrc=n pds-new=zbrog.jcl,mem-new=zzmatch,mem-type=j 0140 pds-new=zbrog.punch,mem-new=mstr,mem-type=u 0150 pds-new=zbrog.punch,mem-new=tran 0160 pds-new=zbrog.list,mem-new=rgzmatch,mem-type=r mem-new=zzmatchd,mem-type=n,list=c, delta=n,summary=n,adacmd=n Current Source Size: 549 Char. Free: S 19 L 1

13 ZZTDOC – Set verification 1 ZZTDOC LEN Consulting LLC 06/10/ :48 Page: 1 Natural Utilities ZZUtils v2.1 Natural Set Verification ZZUTIL / ZZMATCHD Selection screen defaults: Old New ======== ======== Env D D Library ZZUTIL ZZUTIL Listing L Compile DAC Compare F Context 10 Delta N Summary N Ada Cmd Y ILRC N Xref N ENTR to continue PF3 to Return

14 ZZTDOC – Set verification 2 ZZTDOC LEN Consulting LLC 06/10/ :49 Page: 2 Natural Utilities ZZUtils v2.1 Natural Set Verification ZZUTIL / ZZMATCHD Old PDS ZBROG.DEVL.JCL New PDS ZBROG.DEVL.JCL ENTR to continue PF3 to Return

15 ZZTDOC – Set verification 3 ZZTDOC LEN Consulting LLC 06/10/ :49 Page: 3 Natural Utilities ZZUtils v2.1 Natural Set Verification ZZUTIL / ZZMATCHD 0010 * ZZMATCHD Blank/comment line ignored 0020 * Blank/comment line ignored 0030 env-old=d,lib-old=zzutil,- Line continued 0040 env-new=d,lib-new=zzutil,- Line continued 0050 mem-type=n No members - default values set 0060 * Blank/comment line ignored 0070 mem-old=zzmatch,mem-new=rgzmatch,- Line continued 0080 compare=c,context=10,delta=n,summary=n,adacmd=n,ilrc=y,list=l ENTR to continue PF3 to Return

16 ZZTDOC – Set verification 4 ZZTDOC LEN Consulting LLC 06/10/ :50 Page: 4 Natural Utilities ZZUtils v2.1 Natural Set Verification ZZUTIL / ZZMATCHD 0090 Blank/comment line ignored 0100 mem-old=zzmatch,mem-new=rgzmatch,- Line continued 0110 compare=f,delta=y,summary=y,adacmd=y,ilrc=n 0120 Blank/comment line ignored 0130 pds-new=zbrog.jcl,mem-new=zzmatch,mem-type=j 0140 pds-new=zbrog.punch,mem-new=mstr,mem-type=u 0150 pds-new=zbrog.punch,mem-new=tran 0160 pds-new=zbrog.list,mem-new=rgzmatch,mem-type=r 0170 Blank/comment line ignored 0180 mem-new=zzmatchd,mem-type=n,list=c,- Line continued ENTR to continue PF3 to Return

17 ZZTDOC – Set verification 5 ZZTDOC LEN Consulting LLC 06/10/ :50 Page: 5 Natural Utilities ZZUtils v2.1 Natural Set Verification ZZUTIL / ZZMATCHD 0190 delta=n,summary=n,adacmd=n >> ENTR to continue

18 ZZTDOC – Set verified ZZTDOC LEN Consulting LLC 06/10/ :51 Natural Utilities ZZUtils v2.1 Generate Code Walkthrough Document Profile: ZZUTIL/STRGZ Old: Env: D Library: ZZUTIL__ Member: ________ Type: N PDS: ZBROG.DEVL.JCL______________________________ New: Env: D Library: ZZUTIL__ Member: ________ PDS: ZBROG.DEVL.JCL______________________________ Set: Library: ZZUTIL__ Member: ZZMATCHD Listing: Compare: F Context: 10 Delta: N Summary: N Ada Cmd: Y ILRC: N Type: L Print: ID: LASERJET Class: 2 Hold: Y Copies: 1 Sysout: N File: Disp: O Name: STRGZ.TDOCLIST(ZZMATCHD)______________________________ Job: Suffix: T Account: ST398T__ Info: ST01 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Vrfy Help Auth Exit SetV MPswd Membr JCL Sub Set verified

19 ZZTDOC – JCL sample //ZBROGT JOB (ABCDEF,1234,RGZ),'TDOC: ZZMATCHD', // MSGLEVEL=(1,1), // USER=RGZ,PASSWORD=$JPSWD$, REMOVE IF NOT #JPSWD // MSGCLASS=N,NOTIFY=RGZ //* //******** NATURAL OLD SOURCE ******** //NATOLDP0 EXEC NATBT, // DEPT=xx,DB=DEVL,TIME=50,SYSOUT=N, // PRM='IM=D,AUTO=ON,MADIO=0,MAXCL=0,MT=0' //CMPRINT DD SYSOUT=N,OUTPUT=*.FORM //CMWKF01 DD DSN=&&OLDLST0,DISP=(NEW,PASS,DELETE), // UNIT=SYSDA,RECFM=FB,LRECL=133,SPACE=(CYL,(5,5)) //SYSIN DD * %* LOGON ZZUTIL %U %D ENTR to continue PF3 to Return

20 ZZTDOC – Customization > > + Subprogram ZZCUSTOM Lib ZZUTIL Mode Structured #EPARM (A50/40) INIT /* Parameters for Natural PROC 2500 <'MADIO=0,MAXCL=0,MT=0' /* D 2510,'MADIO=0,MAXCL=0,MT=0' /* T 2520,'MADIO=0,MAXCL=0,MT=0' /* U 2530,'MADIO=0,MAXCL=0,MT=0' /* P 2540,'MADIO=0,MAXCL=0,MT=0' /* A 2550,'MADIO=0,MAXCL=0,MT=0' /* B 2560,'MADIO=0,MAXCL=0,MT=0' /* C 2570 > 2580 /* #3GL (L) INIT /* Include other module types #COBOL (L) INIT /* Include COBOL (#3GL subset) #COBCMP (A8) INIT /* COBOL compiler 2620 /* 2630 /* 2640 /* JCL/Script parameters: 2650 /* #JCLMEM (A8) INIT /* JCL source member #COMPARE (A8) INIT /* SuperC #SORT (A8) INIT /* DFSort/SyncSort Current Source Size: Char. Free: S 285 L 249

21 ZZTDOC – Natural ZZTDOC LEN Consulting LLC 06/09/ :31 Natural Utilities ZZUtils v2.1 Generate Code Walkthrough Document Profile: ZZUTIL/ZBROG Old: Env: D Library: ZZUTIL__ Member: ________ New: Env: D Library: ZZUTIL__ Member: ________ Set: Library: ________ Member: ________ Listing: Compare: F Context: 10 Delta: N Summary: N Ada Cmd: Y ILRC: N Type: L Print: ID: LASERJET Class: 2 Hold: Y Copies: 1 Sysout: N File: Disp: O Name: ZBROG.TDOCLIST________________________________________ Job: Suffix: T Account: ABCDEF__ Info: 1234 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Vrfy Help Auth Exit SetV MPswd Membr JCL Sub Set Verification will clear the editor work area

22 ZZTDOC – Natural + 3GL ZZTDOC LEN Consulting LLC 06/09/ :32 Natural Utilities ZZUtils v2.1 Generate Code Walkthrough Document Profile: ZZUTIL/ZBROG Old: Env: D Library: ZZUTIL__ Member: ________ Type: N PDS: ZBROG.PROD.JCL______________________________ New: Env: D Library: ZZUTIL__ Member: ________ PDS: ZBROG.TEST.JCL______________________________ Set: Library: ________ Member: ________ Listing: Compare: F Context: 10 Delta: N Summary: N Ada Cmd: Y ILRC: N Type: L Print: ID: LASERJET Class: 2 Hold: Y Copies: 1 Sysout: N File: Disp: O Name: ZBROG.TDOCLIST________________________________________ Job: Suffix: T Account: ABCDEF__ Info: 1234 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Vrfy Help Auth Exit SetV MPswd Membr JCL Sub Set Verification will clear the editor work area

23 ZZTDOC – Natural + 3GL + COBOL ZZTDOC LEN Consulting LLC 06/09/ :34 Natural Utilities ZZUtils v2.1 Generate Code Walkthrough Document Profile: ZZUTIL/ZBROG Old: Env: D Library: ZZUTIL__ Member: ________ Type: N PDS: ZBROG.PROD.JCL______________________________ New: Env: D Library: ZZUTIL__ Member: ________ PDS: ZBROG.TEST.JCL______________________________ Set: Library: ________ Member: ________ Listing: Compare: F Context: 10 Delta: N Summary: N Ada Cmd: Y ILRC: N Type: L Compile: DAC Xref: N Print: ID: LASERJET Class: 2 Hold: Y Copies: 1 Sysout: N File: Disp: O Name: ZBROG.TDOCLIST________________________________________ Job: Suffix: T Account: ABCDEF__ Info: 1234 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Vrfy Help Auth Exit SetV MPswd CpyBk Membr JCL Sub Set Verification will clear the editor work area

24 ZZTDPMNT – User profile ZZTDPMNT LEN Consulting LLC 06/09/ :36 Natural Utilities ZZUtils v2.1 Technical Walkthrough Documentation - Profile Maintenance *** Profile maintenance will overwrite the Natural source work area *** Action: U (A,I,R,U,.) Library: ZZUTIL__ Profile: ZBROG Module Type: N Default: ZZUTIL ZZTDPROF Old: Nat Lib: ZZUTIL__ Environment: D (DTUP) 3GL PDS: ZBROG.PROD.JCL______________________________ New: Nat Lib: ZZUTIL__ Environment: D (DTUP) 3GL PDS: ZBROG.TEST.JCL______________________________ List: Compare: F (F|C) Context: 10 Delta: N Summary: N Adacmd: Y ILRC: N Src/Cmpl: L (C|L|S) Compile: DAC (D|A|C) Xref: N Print: ID: LASERJET Copies: 1 Class: 2 Hold: Y Sysout: N File: Disp: O DSN: ZBROG.TDOCLIST________________________________________ (N|O|X) Job: Class: 2 Suffix: T Account: ABCDEF__ Info: 1234____ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Actn Help Auth Exit CpyBk

25 ZZPUNCHsource punch ZZTDOCcode walkthrough documentation ZZLISTsource listing ZZUtils ZZTDOC Components ZZADACMDdisplay cataloged Adabas commands IBM SuperCsource comparison utility

26 ZZLIST – Source module listing ZZLIST LEN Consulting LLC 06/09/ :38 Natural Utilities ZZUtils v2.1 Natural Source Module Listing Library: ZZUTIL__ Module: ________ Expand included code?: N Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Dsply Help Auth Exit

27 ZZLIST – Program report ZZLIST LEN Consulting LLC 06/09/ :42 Natural Utilities ZZUtils v2.1 Natural Source Module Listing Page: 1 Library: ZZUTIL Program: ZZMATCH Natural: Saved by ZZUTILS on 11/11/ :01:01 Termid: * Module: ZZMATCH (c) 2002 LEN Consulting LLC 0020 * System: ZZUtils 0030 * Function: Sequential Match 0040 * Author: R. Zbrog 0050 * Date: 02/18/ ************************************************************************ 0070 * Date * Name * Summary of Changes 0080 ************************************************************************ 0090 * 11/04/03 * R. Zbrog * Orphans and Widows to WORK files 0100 * 09/11/01 * R. Zbrog * Demo files 0110 * 09/23/94 * R. Zbrog * Nat * 09/29/93 * R. Zbrog * Comments requesting custom code * 12/16/92 * R. Zbrog * Trace 0140 ************************************************************************ 0150 * Press ENTER to continue PF3 to exit Enter X for new selection

28 ZZLIST – Program report 2 ZZLIST LEN Consulting LLC 06/09/ :43 Natural Utilities ZZUtils v2.1 Natural Source Module Listing Page: 9 Library: ZZUTIL Program: ZZMATCH Natural: Saved by ZZUTILS on 11/11/ :01:01 Termid: #TRACE-MSTR (L) INIT /* >>> #TRACE-TRAN (L) INIT /* >>> #TRACE-MISC (L) INIT /* >>> 1240 * #MISC #DATE (A8) INIT /* Constant for report #TIME (A5) INIT /* Constant for report 1280 * #NAME (A20) 1300 END-DEFINE 1310 * 1320 FORMAT (01) PS=60 LS= */ Press ENTER to continue PF3 to exit Enter X for new selection

29 ZZLIST – Include ZZLIST LEN Consulting LLC 06/09/ :43 Natural Utilities ZZUtils v2.1 Natural Source Module Listing Page: 1 Library: ZZUTIL Program: SMPLPGM Natural: Saved by ZBROG on 12/16/ :45:11 Termid: DEFINE DATA LOCAL EMP VIEW EMPLOYEES PERSONNEL-ID FIRST-NAME NAME BIRTH 0070 END-DEFINE 0080 INCLUDE SMPLINC 'EMP' 0090 'PERSONNEL-ID' 0100 'FIRST-NAME' 0110 'NAME' 0120 'BIRTH' 0130 END *** End of list *** Press ENTER for a new selection PF3 to exit

30 ZZLIST – Expanded Included ZZLIST LEN Consulting LLC 06/09/ :44 Natural Utilities ZZUtils v2.1 Natural Source Module Listing Page: 1 Library: ZZUTIL Program: SMPLPGM Natural: Saved by ZBROG on 12/16/ :45:11 Termid: DEFINE DATA LOCAL EMP VIEW EMPLOYEES PERSONNEL-ID FIRST-NAME NAME BIRTH 0070 END-DEFINE 0080 INCLUDE SMPLINC 'EMP' 0000-*** Saved in ZZUTIL by ZBROG on 12/16/2003 at 16:43:30 *** 0010-READ &1& BY &2& DISPLAY &3& &4& &5& 0050-END-READ 0090 'PERSONNEL-ID' Press ENTER to continue PF3 to exit Enter X for new selection

31 ZZLIST – LDA ZZLIST LEN Consulting LLC 06/09/ :44 Natural Utilities ZZUtils v2.1 Natural Source Module Listing Page: 1 Library: ZZUTIL Data Area: SMPLLDA Natural: Saved by ZBROG on 03/12/16 16:46:19 Termid: ZBROG L R Field Name F Len Occ/Comment Begin End 1 V EMPLOYEES-VIEW 2 PERSONNEL-ID A 8 /*CNNNNNNN FIRST-NAME A 20 /*FIRST/CHRISTIAN NAM NAME A 20 /*SURNAME/FAMILY NAME BIRTH N 6.0 /*BIRTH-DATE (YYMMDD) *** End of list *** Press ENTER for a new selection PF3 to exit

32 ZZPUNCH – Source module punch ZZPUNCH LEN Consulting LLC 06/09/ :47 Natural Utilities ZZUtils v2.1 Natural Source Module Punch Library: ZZUTIL__ From Module: ________ Thru Module: ________ Header: N (Y/N/F/X) Separator: N View: Y Remove L/R: N Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Actn Help Auth Exit

33 ZZPUNCH – Help ZZPUNCH LEN Consulting LLC 06/09/ :47 Natural Utilities ZZUtils v2.1 Natural Source Module Punch Header----(PF3=Exit; PF7=Up; PF8=Down) | Specify whether a header record should be inlcuded | | for each module. The header contains the location | | of the module, and date and timestamp information. | | | | Valid values are | | F force a different header (for comparisons) | | N no module header | | X exclusive - header only | | Y include module header | | | Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Actn Help Auth Exit

34 ZZPUNCH – Selection ZZPUNCH LEN Consulting LLC 06/09/ :50 Natural Utilities ZZUtils v2.1 Natural Source Module Punch Library: ZZUTIL__ From Module: rgz_____ Thru Module: rgz9____ Header: N (Y/N/F/X) Separator: y View: Y Remove L/R: N Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Actn Help Auth Exit

35 ZZPUNCH – Report >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 0010 IF *DEVICE <> 'BATCH' 0020 THEN 0030 STACK TOP COMMAND 'ZZUTILS' 0040 END-IF 0050 STACK TOP COMMAND 'GLOBALS SM=T SA=F' 0060 END >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 0010 DEFINE DATA LOCAL EMP VIEW EMPLOYEES PERSONNEL-ID VEH VIEW VEHICLES PERSONNEL-ID #A (A100) #I (P10) 0080 END-DEFINE 0090 STOP 0100 * 0110 GE GET EMP UPDATE (GE.) /* A1 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Actn Help Auth Exit

36 ZZADACMD – ADABAS command analysis ZZADACMD LEN Consulting LLC 06/09/ :44 Natural Utilities ZZUtils v2.1 Natural Module ADABAS Command Analysis Required: Library name: ZZUTIL__ Starting module name: ________ Optional: Ending module name: ADABAS Command: __ ADABAS File: ___ DBID display: N Search Buffer display: N WORK file: N Commands reported: A1 L1/L2/L3/L4/L5/L6/L9 BT N1/N2/N4 E1 RE ET S1/S2/S4/S8/S9 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Dsply Help Auth Exit

37 ZZADACMD – Selection ZZADACMD LEN Consulting LLC 06/09/ :44 Natural Utilities ZZUtils v2.1 Natural Module ADABAS Command Analysis Required: Library name: ZZUTIL__ Starting module name: rgz_____ Optional: Ending module name: rgz99999 ADABAS Command: __ ADABAS File: ___ DBID display: y Search Buffer display: y WORK file: N Commands reported: A1 L1/L2/L3/L4/L5/L6/L9 BT N1/N2/N4 E1 RE ET S1/S2/S4/S8/S9 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Dsply Help Auth Exit

38 ZZADACMD – Report – page 1 ZZADACMD LEN Consulting LLC 06/09/ :45 Natural Utilities ZZUtils v2.1 Natural Module ADABAS Command Analysis Page: 1 Library: ZZUTIL Modules: RGZ - RGZ99999 Parms:,0,Y,Y,N Module Line ADABAS Command File Search Buffer RGZADA L4 Get with hold 0/ 4 EMPLOYEES-FILE A1 Update 0/ 4 EMPLOYEES-FILE BT Backout Transaction ET End Transaction 0160 E1 Delete 0/ 4 EMPLOYEES-FILE L1 Get 0/ 4 EMPLOYEES-FILE 0190 L2 Read Physical 0/ 4 EMPLOYEES-FILE 0210 L3 Read Logical 0/ 4 EMPLOYEES-FILE AA,8,A. L4 Get with hold 0/ 4 EMPLOYEES-FILE A1 Update 0/ 4 EMPLOYEES-FILE 0250 L5 Read Physical w/hold 0/ 4 EMPLOYEES-FILE A1 Update 0/ 4 EMPLOYEES-FILE 0280 L6 Read Logical w/hold 0/ 4 EMPLOYEES-FILE AA,8,A. A1 Update 0/ 4 EMPLOYEES-FILE Press ENTER to continue PF3 to Stop Enter X for a new selection

39 ZZADACMD – Report – page 2 ZZADACMD LEN Consulting LLC 06/09/ :46 Natural Utilities ZZUtils v2.1 Natural Module ADABAS Command Analysis Page: 2 Library: ZZUTIL Modules: RGZ - RGZ99999 Parms:,0,Y,Y,N Module Line ADABAS Command File Search Buffer RGZADA 0310 L9 Histogram 0/ 4 EMPLOYEES-FILE AA,8,A. N1 Store 0/ 4 EMPLOYEES-FILE RE Get ET Data 0380 S1 Find 0/ 4 EMPLOYEES-FILE AA,8,A. S1 Find Number 0/ 4 EMPLOYEES-FILE AA,8,A S2 Find Sorted by 0/ 4 EMPLOYEES-FILE AA,8,A S4 Find with hold 0/ 4 EMPLOYEES-FILE AA,8,A. A1 Update 0/ 4 EMPLOYEES-FILE 0460 S1 Find 0/ 4 EMPLOYEES-FILE 0500 S1 Find 0/ 4 EMPLOYEES-FILE AA,8,A S1 Find 0/ 4 EMPLOYEES-FILE AO,6,A S8 Process ISN Lists 0/ 4 EMPLOYEES-FILE S1 Find 0/ 4 EMPLOYEES-FILE Press ENTER to continue PF3 to Stop Enter X for a new selection

40 ZZADACMD – Report – page 3 ZZADACMD LEN Consulting LLC 06/09/ :47 Natural Utilities ZZUtils v2.1 Natural Module ADABAS Command Analysis Page: 3 Library: ZZUTIL Modules: RGZ - RGZ99999 Parms:,0,Y,Y,N Module Line ADABAS Command File Search Buffer RGZADA 0520 S1 Find 0/ 4 EMPLOYEES-FILE AA,8,A S1 Find 0/ 4 EMPLOYEES-FILE AO,6,A S8 Process ISN Lists 0/ 4 EMPLOYEES-FILE 0520 S9 Sort ISN List 0/ 4 EMPLOYEES-FILE RGZMATCH 1520 S1 Find 0/ 4 EMPLOYEES-FILE AA,8,A. RGZSRC 0320 L3 Read Logical 255/255 System/FNAT LJ,18,A. RGZ L9 Histogram 0/250 UTILITY-NAT-DOC XX,248,LE. RGZ250D 0300 L6 Read Logical w/hold 0/250 UTILITY-NAT-DOC XX, E1 Delete 0/250 UTILITY-NAT-DOC ET End Transaction End of Command List Press ENTER for a new selection PF3 to Stop

41 ZZSCANlibrary scan ZZLOCATEfind a module in the current FUSER ZZSEARCHfind a module in all FUSERs ZZUtils Sample Utilities ZZVPARMcreate a PDA from a view

42 ZZLOCATE – Find a module in FUSER ZZLOCATE LEN Consulting LLC 06/09/ :47 Natural Utilities ZZUtils v2.1 Locate a Natural Module Enter module name: ________ (or wildcard: ?._*) Timestamp since: __________ (yyyy-mm-dd) Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Actn Help Auth Exit

43 ZZLOCATE – Report ZZLOCATE LEN Consulting LLC 06/09/ :48 Natural Utilities ZZUtils v2.1 Locate a Natural Module Page: 1 ZZMATCH exists in the following libraries Source Object Library T Userid Date Time Nat T Userid Date Time Nat DLSTSYS P LEWIS :46: SYSTEM P ZBROG :11: P ZBROG :11: WKSTRS99 P LEWIS :46: ZZUTIL P ZZUTILS :01: P ZZUTILS :01: source libraries scanned; 4 hits Press ENTER for a new selection PF3 to exit

44 ZZLOCATE – Wildcard report ZZLOCATE LEN Consulting LLC 06/09/ :49 Natural Utilities ZZUtils v2.1 Locate a Natural Module Page: 1 ZZUTL0* exists in the following libraries Source Object Library Module T Userid Date Time T Userid Date Time SYSTEM ZZUTL000 N ZZUTILS :01:00 ZZUTL001 N ZZUTILS :01:00 ZZUTL002 N ZZUTILS :01:00 ZZUTL003 N ZZUTILS :01:00 ZZUTL004 N ZZUTILS :01:00 ZZUTL005 N ZZUTILS :01:00 ZZUTL006 N ZZUTILS :01:00 ZZUTL007 N ZZUTILS :01:00 ZZUTL008 N ZZUTILS :01:00 ZZUTIL ZZUTL000 N ZZUTILS :01:00 ZZUTL001 N ZZUTILS :01:00 ZZUTL002 N ZZUTILS :01:00 ZZUTL003 N ZZUTILS :01:00 Press ENTER to continue PF3 to exit Enter X for new selection

45 ZZSEARCH – Find a module in FUSERs ZZSEARCH LEN Consulting LLC 06/09/ :50 Natural Utilities ZZUtils v2.1 Search Environments for a Natural Module Enter module name: ________ (or wildcard: ?._*) Timestamp since: __________ (yyyy-mm-dd) _ D Development _ T Sys Integration _ U User Acceptance _ P Production _ A CB Development _ B CB Test _ C CB Production Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Actn Help Auth Exit

46 ZZSEARCH – Selection ZZSEARCH LEN Consulting LLC 06/09/ :54 Natural Utilities ZZUtils v2.1 Search Environments for a Natural Module Enter module name: zzmatch_ (or wildcard: ?._*) Timestamp since: __________ (yyyy-mm-dd) x D Development x T Sys Integration x U User Acceptance x P Production _ A CB Development _ B CB Test _ C CB Production Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Actn Help Auth Exit

47 ZZSEARCH – Report ZZSEARCH LEN Consulting LLC 06/09/ :55 Natural Utilities ZZUtils v2.1 Search Environments for a Natural Module Page: 1 ZZMATCH exists in the following environments Source Object E Library T Userid Date Time T Userid Date Time D DLSTSYS P LEWIS :46:43 SYSTEM P ZBROG :11:26 P ZBROG :54:17 WKSTRS99 P LEWIS :46:43 ZZUTIL P ZZUTILS :01:01 P ZZUTILS :01: environments, 301 source libraries scanned; 4 hits -- Press ENTER for a new selection PF3 to exit

48 ZZSCAN – Source string scan ZZSCAN LEN Consulting LLC 06/09/ :56 Natural Utilities ZZUtils v2.1 Natural Library Scan Enter library: ZZUTIL__ Enter starting program: ________ Optional ending program: ________ WORK file output: N Enter scan value(s): _________________________ (case sensitive) _________________________ (OR'd) _________________________ _________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Dsply Help Auth Exit

49 ZZSCAN – Selection ZZSCAN LEN Consulting LLC 06/09/ :56 Natural Utilities ZZUtils v2.1 Natural Library Scan Enter library: ZZUTIL__ Enter starting program: zz______ Optional ending program: zz9_____ WORK file output: N Enter scan value(s): ZZUtil___________________ (case sensitive) _________________________ (OR'd) _________________________ _________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Dsply Help Auth Exit

50 ZZSCAN – Report ZZSCAN LEN Consulting LLC 06/09/ :57 Natural Utilities ZZUtils v2.1 Scan Natural Library ZZUTIL Range: ZZ - ZZ9 Page: 1 Program Line Source Scan value: ZZUtil ZZADAR T 'ZZUtils v2' ZZADAR T 'ZZUtils v2' ZZCUSTOM #ZZUTILIB (A8) INIT /* ZZUtils Natural library ZZMATCH 0020 * System: ZZUtils T 'ZZUtils v2' (YEI) ZZMONTH 0030 * System: ZZUtils T 'ZZUtils v2.1' (YEI) ZZNAME 0030 * System: ZZUtils ZZNATRJE 0030 * System: ZZUtils ZZWHOR T 'ZZUtils v2' End of Scan Press ENTER for a new selection PF3 to STOP

51 ZZVPARM – Parameter list for a view ZZVPARM LEN Consulting LLC 06/09/ :57 Natural Utilities ZZUtils v2.1 Generate a Parameter List for a View File Name: ________________________________ Prefix?: N (Y/N) Specify a file name and press ENTER to generate a field list in the Natural Work Area. *** ZZVPARM will replace any source code currently in the Work Area. *** Press PF3 to cancel this utility and leave the Work Area intact. Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Dsply Help Auth Exit

52 ZZVPARM – Output 1 > > + Program Lib ZZUTIL Top Mode Structured */ 0020 DEFINE DATA LOCAL #SYSDIC VMS-FILCHUNK (A128/8) FILENAME (A75) FILENR (B2) FILCHUNK (A250/8) ERRNR (N4) ERROR (10) /* << ERRTXT (A79) SRCID (A18) SRCTX (A94/60) OBJID (A18) OBJCHUNK (A250/8) INTERNA01 (A75) INTERNA02 (A75) INTERNA03 (A8) INTERNA04 (A8) INTERNA05 (A8) INTERNA06 (A8) Current Source Size: 9507 Char. Free: S 346 L 1

53 ZZVPARM – Output 2 > > + Program Lib ZZUTIL Bot Mode Structured OBJECT-STATUS (A1) FILE-FIELD (A64) SYSTEM-REC-ALF (A42) PROPERTY (A32/30) INTERFACE-METHOD (A64) INTERFACE-GUID-METHOD (A64) N-LIB-PGM (A32) INT-REC-TYPE (A7) ATTRIBUTES-DE (80) /* << NUMERIC-FIELDS-DE (P27) ALPHA-FIELDS-DE (A253) SP-PARENT-CHILD (A135) OLD-FILE-REC (A33) UREL-CODE (A2) SMS-NO-ATTR (A8) N-RESOURCE (A235) N-RESOURCE-USAGE (A2) S-DA-NAME-PGM (A52) 3450 END-DEFINE 3460 END Current Source Size: 9507 Char. Free: S 346 L 327

54 ZZSEARCHlibrary scan of multiple FUSERs ZZUTILSmenu ZZLOCATElibrary scan of FUSER ZZUtils Customization

55 Main menu ZZUTILs Organization Name LIB: ZZUTIL ID: ZBROG v2.1 Natural Utilities Menu 06/09/ :02 After 4. Downhill, Ralph. 1 ZZADACMD ADABAS command analysis 16 ZZWHOIS Identify a Userid by name 2 ZZBLKSIZ Block size computation 17 ZZWHOLST Userid list 3 ZZCALC Calculator 18 4 ZZDATES Date conversions 19 ZZNATPUN ZZPUNCH via RJE 5 ZZDUMP Module formatted dump 20 RGZ250 TDOC log 6 ZZLIST List a Natural module 7 ZZLOCATE Locate a Natural module 8 ZZMONTH Monthly date calculations 9 ZZPUNCH Punch Natural module 10 ZZSCAN Source library scan 11 ZZSEARCH Multi-environment Locate 12 ZZTDOC Technical walkthrough doc 13 ZZTDPMNT Maintain TDOC profile 14 ZZTIME Timestamp to/from time 15 ZZVPARM Parm list from a view Selection: __ Command: ______________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Cmd Help Auth Exit Rfrsh Up Down Crsr

56 Main menu - Customized ZZUTILs LEN Consulting LLC LIB: ZZUTIL ID: ZBROG v2.1 Natural Utilities Menu 06/09/ :03 After 4. Downhill, Ralph. 1 ZZADACMD ADABAS command analysis 16 ZZWHOIS Identify a Userid by name 2 ZZBLKSIZ Block size computation 17 ZZWHOLST Userid list 3 ZZCALC Calculator 18 4 ZZDATES Date conversions 19 ZZNATPUN ZZPUNCH via RJE 5 ZZDUMP Module formatted dump 20 RGZ250 TDOC log 6 ZZLIST List a Natural module 7 ZZLOCATE Locate a Natural module 8 ZZMONTH Monthly date calculations 9 ZZPUNCH Punch Natural module 10 ZZSCAN Source library scan 11 ZZSEARCH Multi-environment Locate 12 ZZTDOC Technical walkthrough doc 13 ZZTDPMNT Maintain TDOC profile 14 ZZTIME Timestamp to/from time 15 ZZVPARM Parm list from a view Selection: __ Command: ______________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Cmd Help Auth Exit Rfrsh Up Down Crsr

57 ZZUTILS – Menu customization > > + Program ZZUTILS Lib ZZUTIL Mode Structured #MAX (I4) CONST #TABLE (A33/#MAX) INIT <'ZZADACMD' - 'ADABAS command analysis ' 0620,'ZZBLKSIZ' - 'Block size computation ' 0630,'ZZCALC ' - 'Calculator ' 0640,'ZZDATES ' - 'Date conversions ' 0650,'ZZDUMP ' - 'Module formatted dump ' 0660,'ZZLIST ' - 'List a Natural module ' 0670,'ZZLOCATE' - 'Locate a Natural module ' 0680,'ZZMONTH ' - 'Monthly date calculations' 0690,'ZZNATPUN' - 'ZZPUNCH via NatRJE ' 0700,'ZZPUNCH ' - 'Punch Natural module ' 0710,'ZZSCAN ' - 'Source library scan ' 0720,'ZZSEARCH' - 'Multi-environment Locate ' 0730,'ZZTDOC ' - 'Technical walkthrough doc' 0740,'ZZTDPMNT' - 'Maintain TDOC profile ' 0750,'ZZTIME ' - 'Timestamp to/from time ' 0760,'ZZVPARM ' - 'Parm list from a view ' 0770,'ZZWHOIS ' - 'Identify a Userid by name' 0780,'ZZWHOLST' - 'Userid list ' 0790,' ' - 'Client tools: ' Current Source Size: 7066 Char. Free: S 124 L 60

58 Multi-page menu 1 ZZUTILs LEN Consulting LLC LIB: ZZUTIL ID: ZBROG v2.1 Natural Utilities Menu 06/09/ :08 After 4. Downhill, Ralph. Page: 1 1 ZZADACMD ADABAS command analysis 16 ZZVPARM Parm list from a view 2 ZZBLKSIZ Block size computation 17 ZZWHOIS Identify a Userid by name 3 ZZCALC Calculator 18 ZZWHOLST Userid list 4 ZZDATES Date conversions 19 Client tools: 5 ZZDUMP Module formatted dump 20 COMPARE N2O on-line comparison 6 ZZLIST List a Natural module 21 NS Scan Natural source 7 ZZLOCATE Locate a Natural module 22 N2O Natural 2 Organizer 8 ZZMONTH Monthly date calculations 23 OCU On-line Case Unload 9 ZZNATPUN ZZPUNCH via NatRJE 24 OCUI Case Unload Inquiry 10 ZZPUNCH Punch Natural module 25 PAC Predict Applic Control 11 ZZSCAN Source library scan 26 PK PEEK Adabas File Editor 12 ZZSEARCH Multi-environment Locate 27 PRTUTIL Print utility 13 ZZTDOC Technical walkthrough doc 28 TESTMENU Select a test database 14 ZZTDPMNT Maintain TDOC profile 29 XREF Subprogram calls 15 ZZTIME Timestamp to/from time Selection: __ Command: ______________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Cmd Help Auth Exit Rfrsh Up Down Crsr

59 Multi-page menu 2 ZZUTILs LEN Consulting LLC LIB: ZZUTIL ID: ZBROG v2.1 Natural Utilities Menu 06/09/ :08 After 4. Downhill, Ralph. Page: 2 1 Screen Prints: 16 Not Yet Ported to XP: 2 ZZCOPYBK COBOL copybook from xDA 17 ZZERRMSG SYSERR message list 3 ZZCOPINC LDA from COBOL copybook 18 ZZLOC ZZLOCATE via RJE 19 ZZPCHLIB Punch Natural library 20 ZZSRCNT Source line count 21 ZZSWITCH Switch a module's type Selection: __ Command: ______________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Cmd Help Auth Exit Rfrsh Up Down Crsr

60 Multi-page menu 3 ZZUTILs LEN Consulting LLC LIB: ZZUTIL ID: ZBROG v2.1 Natural Utilities Menu 06/09/ :09 After 4. Downhill, Ralph. Page: 3 1 Verrule functions: 2 ZZVECOPY Copy verrule to work area 3 ZZVEDATE List verrule time stamps 4 ZZVELIST List verification rules 5 ZZVEPNCH Punch verification rules 6 ZZVESCAN Scan verrules (beta) Selection: __ Command: ______________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Cmd Help Auth Exit Rfrsh Up Down Crsr

61 Field-level help PF key help Screen-level help ZZUtils Miscellaneous

62 PF-key help ZZUTILs LEN Consulting LLC LIB: ZZUTIL ID: ZBROG v2.1 Natural Utilities Menu 06/09/ :10 After 4. Downhill, Ralph. 1 ZZADACMD ADABAS command analysis 16 ZZVPARM Parm list from a view 2 ZZBLK +---ZZUtils--v (PF3=Exit; PF7=Up; PF8=Down)----+ serid by name 3 ZZCAL | Main menu | 4 ZZDAT | | 5 ZZDUM | PF1/Help - This screen | 6 ZZLIS | PF3/Exit - Return to Natural | 7 ZZLOC | PF7/Up - Scroll menu up | 8 ZZMON | PF8/Down - Scroll menu down | 9 ZZNAT | PF2/Auth - How to contact the author | 10 ZZPUN | PF12/Crsr - Execute the utility | 11 ZZSCA | indicated by the cursor | 12 ZZSEA | PF4/Rfrsh - Refresh the screen | 13 ZZTDO | | 14 ZZTDP ZZTIME Timestamp to/from time Selection: __ Command: ______________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Cmd Help Auth Exit Rfrsh Up Down Crsr

63 Screen-level help ZZSEARCH LEN Consulting LLC 06/09/ :12 Natural Utilities ZZUtils v2.1 Search Environments for a Natural Module +---ZZSEARCH Help----(PF3=Exit; PF7=Up; PF8=Down)----+ | Locate a Natural Member | | | | This utility is an enhanced version of ZZLOCATE. | _ D Deve | | Production _ A CB D | Where ZZLOCATE will search all libraries within a | | single environment, as many as 40 environments | | may be defined to ZZSEARCH. The environments are | | specified by the ZZUtils administrator. | | | | An environment is synonymous with an FUSER file, | | | Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Actn Help Auth Exit

64 Field-level help ZZSEARCH LEN Consulting LLC 06/09/ :13 Natural Utilities ZZUtils v2.1 Search Environments for a Natural Module Module----(PF3=Exit; PF7=Up; PF8=Down) | Specify the name of the module to be found. A | | member name or wild card value may be specified. | | | _ D Deve | Use standard Natural wildcard characters: | Production _ A CB D | | | ?. _ * | | | | If the Natural Source Area is not empty, the name | | of the source module is used as the default value. | | | Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Actn Help Auth Exit

65 NATLOAD ZZUtils customization (ZZCUSTOM) JCL customization (ZZTDJMVS) Menu customization (ZZUTILS) TDOC customization (ZZTDPMNT) ZZUtils Installation Upload to mainframe

66 1 or 2 days of on-site support (North America only) for installation, customization, training 1 year of updates 20% discount on 1 training class (contiguous with on-site support) Technical support via /telephone ZZUtils Purchase Purchase includes: ZZTDOC User’s Guide Natural Source Code Quality Review checklist

67 Limited technical support 30-day expiration ZZUtils Trial Disk Subset of functions

68 Documentation Samples in PDF format Screen shots ZZUtils Additional Information

69 Q & A

ZZUtils Tools for Natural Developers LEN C ONSULTING LLC Ralph Zbrog