home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PROG_GEN / PEO.ZIP / WHATSNEW.DOC < prev   
Text File  |  1994-01-30  |  10KB  |  233 lines
  1.                   
  2.                   WHAT'S NEW WITH THIS VERSION OF PEO
  3.  
  4.  
  5.         Since we first offered our custom analysis tool, PEO, we've 
  6.         made significant enhancements that have greatly increased 
  7.         the efficacy of PEO. The enhancements 
  8.  
  9.         *  make it easy to document the results of the analysis
  10.         *  help the user keep track of the locations along the data 
  11.            transformation paths and logic flow paths
  12.         *  "filter" data element names for specified character strings
  13.         *  recognize CICS and IMS DL/I language elements 
  14.         *  display the hiearchy of subprograms.
  15.  
  16.         The most significant enhancement is Code Lifter PLUS. Now you 
  17.         can copy code from the COBOL program into a buffer area and add 
  18.         notes and comments. This is an easy way to build documentation 
  19.         about the results of the program analysis. 
  20.  
  21.         The other important advances are:
  22.  
  23.         PEO now automatically returns the cursor to the proper location 
  24.         on the PEO ELEMENT DISPLAY SCREEN when you return from the PEO 
  25.         SOURCE CODE DISPLAY SCREEN. This eliminates the need for the 
  26.         user to re-position the cursor.
  27.  
  28.         The parser (SEO) can produce a file of selected data element 
  29.         names based upon specified strings of characters in the data
  30.         element name. The "filter" can be helpful to guide the user to 
  31.         those data elements which likely contain dates, for example.
  32.  
  33.         CICS commands that contain the INTO, FROM, COMMAREA, and RIDFLD 
  34.         clauses are recognized and related to the elements referenced 
  35.         by the commands.
  36.  
  37.         IMS DL/I calls ("CBLTDLI") are recognized and related to the 
  38.         elements referenced by the call.
  39.  
  40.         The parser automatically produces a file showing the hierarchy 
  41.         of subprograms. This can be helpful to view the overall structure 
  42.         of a program. The subprograms are listed in the order in which 
  43.         they were encountered as the parser reads sequencially through 
  44.         the main program and subprograms.
  45.         
  46.         PEO / Code Lifter PLUS
  47.  
  48.         PEO / Code Lifter PLUS gives the user the ability to lift text 
  49.         from the source code and copy it into a buffer. You can edit the 
  50.         code and add your own notes and comments. It's a fast, powerful 
  51.         tool to quickly document the things you learn about the program. 
  52.         After you have finished you can save the buffer into a file.  
  53.         It's easy to use: 
  54.  
  55.                 On the PEO ELEMENT DISPLAY SCREEN:
  56.  
  57.                 Press F-8. The TARGET element will be copied to the 
  58.                 buffer and identified as the TARGET ENTITY.
  59.                 
  60.  
  61.                 On the PEO SOURCE CODE DISPLAY SCREEN:
  62.  
  63.                 Just position the cursor on the line of code you want
  64.                 to copy into the buffer and press F-8. The cursor will 
  65.                 automatically advance to the next line. 
  66.  
  67.                 To enter the editor simply press F-9. After you've 
  68.                 finished you can exit back to the PEO screens by 
  69.                 pressing CTL+W to keep the changes; or, you can press 
  70.                 ESC to exit the editor without saving the changes. The
  71.                 buffer is not written to a file until you exit PEO.
  72.  
  73.                 When you exit from PEO you'll be asked if you want to 
  74.                 save the buffer in a file. If you do you simply type  
  75.                 in a name without an extension. PEO automatically adds 
  76.                 .cap as the extension. 
  77.  
  78.         It's reccommended that you do not attempt to do all analysis 
  79.         required and document the analysis in a single file, especially 
  80.         if it's a large project. Instead, break the project up into 
  81.         small fragments and name the files you save in a manner that 
  82.         will suggest some hiearchy or structure. Later, you can assemble 
  83.         the information from all the files into a final document.
  84.  
  85.  
  86.         DATA NAME FILTER.
  87.  
  88.         This feature provides the capability to tell the parser to 
  89.         select and write to a file all the data element names which 
  90.         contain specified strings of characters. 
  91.  
  92.         The specified strings are entered into a file called, 
  93.         seofiltr.fil. This file must reside in the application 
  94.         identifier sub directory of MACHY. There must be only one 
  95.         string per record and the string should start in column one. 
  96.         The file must be an ASCII text file. You can edit the file to 
  97.         suit your needs. If the file is missing or empty, the parser 
  98.         simply bypasses the filter logic. Here is a sample file 
  99.         containing strings of characters which pertain to date fields. 
  100.         E.g.,
  101.  
  102.                 DATE
  103.                 DTE
  104.                 DT
  105.                 MDY
  106.                 DMY
  107.                 YMD
  108.                 YY
  109.                 MM
  110.                 DD
  111.  
  112.         The file that contains the selected data element names is 
  113.         called progid.dte; where progid is the name of the COBOL 
  114.         program or the name you typed into the parser when you 
  115.         combined programs for parsing. The file is written to the
  116.         EXS sub directory of the application identifier.
  117.  
  118.         CICS commands and IMS DL/I
  119.  
  120.         CICS commands that contain the INTO, FROM, COMMAREA, and 
  121.         RIDFLD clauses are recognized and related to the elements 
  122.         referenced by the commands. The relations are defined in 
  123.         terms of data entering the program or leaving the program, 
  124.         i.e., a READ or WRITE, including group read and group write.
  125.  
  126.         IMS DL/I calls ("CBLTDLI") are recognized and related to the 
  127.         elements referenced by the call. This is accomplished by a 
  128.         skeleton COBOL program that contains and entry point, "CBLTDLI". 
  129.         The arguments associated with the entry point are the parameters 
  130.         normally passed to DL/I. The skeleton program is included with 
  131.         PEO install diskette and resides in the MACHY directory. 
  132.  
  133.         SUBPROGRAM HIEARCHY
  134.  
  135.         The parser writes the called entry point and the name of the 
  136.         COBOL source file containing the entry point to a file called 
  137.         progid.hih; where progid is the name of the COBOL program or 
  138.         the name you typed into the parser when you combined programs 
  139.         for parsing. The file is written to the EXS sub directory of 
  140.         the application identifier. The names are indented to suggest 
  141.         the hiearcical relation of the nested subprograms. Here is an 
  142.         example:
  143.  
  144.                 000 MACHYM20
  145.                 001   M20MAT
  146.                 002     XMATSE
  147.                 003      MINMAX
  148.                 003      MAT006
  149.                 004        MAT002
  150.                 004        MAT010
  151.                 005          MAT011
  152.                 006            MAT012
  153.                 007              MAT020
  154.                 007              MAT004A (MAT004)
  155.                 006            MAT004C (MAT004)
  156.                 006            MAT004B (MAT004)
  157.                 006            MAT004D (MAT004)
  158.                 005          MAT004A (MAT004)
  159.                 005          MAT004B (MAT004)
  160.                 005          MAT011
  161.                 004        MAT030
  162.  
  163.  
  164.         A NOTE ABOUT THE SORT
  165.  
  166.         The sort that the parser uses is actually a series of merges. 
  167.         The sortin file is split into strings. The strings are merged 
  168.         and split into other strings that are then merged and split 
  169.         again until all the records are in ascending sequence. Each 
  170.         string is displayed as a dot (.) in order to show that something 
  171.         is happening and the computer has not "hung up". Large files 
  172.         will fill the screen with dots and may cause some concern if 
  173.         you did not know what is happening.  
  174.  
  175.         A NOTE ABOUT THE COBOL SOURCE CODE
  176.  
  177.         The COBOL source code must be in 80-column card image format. 
  178.         That is, the source code must be in columns eight through 
  179.         seventy-two. The CR/LF can terminate the record in any column.
  180.         The sequence columns, columns one through six must be physically 
  181.         present and the indicator column (column 7) must be present.
  182.         The current version of the parser edits for this format.  
  183.  
  184.         BUG FIXES
  185.  
  186.         The data definition clause, PIC X VALUE '''', is now processed 
  187.         correctly. Note: the clause will appear on the PEO SOURCE CODE 
  188.         DISPLAY screen as: PIC X VALUE '#'.
  189.  
  190.         The COPY ... REPLACING == ... == BY == ... == logic has been 
  191.         corrected. Before the fix, the REPLACING clause, 
  192.  
  193.                        ==OPERAND1== BY ==OPERAND2==
  194.  
  195.         was not processed correctly because the parser expected a space 
  196.         to preceed the operand within the == delimiter.
  197.  
  198.         The logic has been changed to process the RENAMES clause 
  199.         correctly. 
  200.  
  201.         The first source statement that is not a comment must be one 
  202.         of the following:
  203.  
  204.                 IDENTIFICATION DIVISION
  205.                 ID DIVISION
  206.                 PROGRAM-ID
  207.                 AUTHOR
  208.                 REMARKS
  209.                 INSTALLATION
  210.                 DATE-WRITTEN
  211.                 DATE-COMPILED
  212.                 SECURITY
  213.                 ENVIRONMENT DIVISION
  214.                 CONFIGURATION SECTION
  215.                 SOURCE-COMPUTER
  216.                 OBJECT-COMPUTER
  217.                 SPECIAL-NAMES
  218.                 INPUT-OUTPUT SECTION
  219.                 FILE-CONTROL
  220.                 SELECT file-name ASSIGN [TO] ....
  221.                 I-O-CONTROL
  222.                 DATA DIVISION
  223.                 FILE SECTION
  224.                 WORKING-STORAGE SECTION
  225.                 LOCAL-STORAGE SECTION
  226.                 LINKAGE SECTION
  227.                 COMMUNICATION SECTION
  228.                 REPORT SECTION
  229.                 SCREEN SECTION
  230.                 PROCEDURE DIVISION
  231.  
  232.  
  233.