home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / COBTABLE.ZIP / README.CBT < prev    next >
Text File  |  1993-07-23  |  15KB  |  379 lines
  1. ==============================================================================
  2.  
  3.  
  4. TRANTOR LTD                         Home/Office   0639-633072
  5. GREEN HEDGES BUNGALOW               International 44-639-633072
  6. PONTARDAWE ROAD                     Mobile        0836-795445
  7. BRYNCOCH                            Fax       (manual switch, on request)
  8. NEATH  SA10 7YL
  9. WEST GLAMORGAN                      Directors:
  10. SOUTH WALES, UK                     N.H.Jennings, B.Sc., CEng, MBCS, FIAP
  11.                                     D.P.Jennings
  12.  
  13. COMPUSERVE Id: 100040,471
  14.  
  15. ==============================================================================
  16.  
  17.                                  COBTABLE
  18.                          COBOL RECORD LAYOUT PRINT
  19.                                VERSION 1.11
  20.                                 JULY  1993
  21. ==============================================================================
  22.  
  23.  
  24.  
  25.  
  26. ==============================================================================
  27.                                    Contents
  28. ==============================================================================
  29.  
  30.  1.   Conditions of sale
  31.  2.   Registration
  32.  3.   About TRANTOR and our software
  33.  4.   General utilities
  34.  5.   COBOL utilities
  35.  6.   Items supplied on the disk
  36.  7.   Use and Performance
  37.  8.   History
  38.  9.   Documentation
  39.  A.   Aknowledgements
  40.  
  41. This software requires only a single drive, only 384k of memory, and uses
  42. only text-mode screens, so it should run on almost ANY IBM-compatible PC.
  43.  
  44. ==============================================================================
  45.                            1. Conditions of sale
  46. ==============================================================================
  47.  
  48. Copyright is retained by the author. The software on this disk is NOT public
  49. domain, and the purchaser is granted a limited licence to copy,
  50. distribute and use it for PERSONAL USE ONLY, subject to the following
  51. conditions:
  52.  
  53.    No changes are made to any file
  54.  
  55.    All files on the supplied disk are included on the copy
  56.  
  57.    No charge is made other than a reasonable fee for media, postage and copying
  58.  
  59.    If you make use of the software after an initial 30 day evaluation, you
  60.    MUST register. This is a legal requirement.
  61.  
  62.    Corporate users, and anyone using this software for commercial
  63.    purposes, MUST register and purchase the corresponding licence.
  64.  
  65.    The registered version must NOT be copied for distribution. It contains
  66.    a unique serial number which will identify the source of any copies.
  67.  
  68. ==============================================================================
  69.                                2. Registration
  70. ==============================================================================
  71.  
  72.  
  73. Please send £4 for the shareware version, or £12 for the registered version
  74. of any of our PC programs, to the address given at the start of this file.
  75. This includes VAT, currently at 17.5%
  76.  
  77. Registration helps to pay for further development, which is ultimately for
  78. YOUR benefit. We are a SMALL company, and the little income from
  79. registration goes to support myself, my wife and 4 children, (and the Tax
  80. man), NOT into luxury office buildings or executive cars! I still have to
  81. work as a freelance in order to live.
  82.  
  83. For non-UK users, please send $25 or equivalent. This is because the bank
  84. charges a minimum of $4 for currency conversion (cash) or $9 for cashing a
  85. foreign cheque (check). Also, overseas mailing costs more. (The volume of
  86. registrations does not yet allow us to offer credit card facilities.)
  87.  
  88. Note: A VAT receipt can be supplied on request.
  89.  
  90. ==============================================================================
  91.                       3. About TRANTOR and our software
  92. ==============================================================================
  93.  
  94. Trantor Ltd is a small consultancy, originally  specialising in software
  95. for ICL mainframes. Our programs are installed on ICL Mainframes in the
  96. UK, and as far away as Australia. We have recently ported many of our
  97. mainframe COBOL utilities onto IBM PC's.
  98.  
  99. Our current range includes the following items which run under ICL's VME
  100. operating system. Please contact us for further details.
  101.  
  102.     COBFORM  : COBOL reformatter and         PC and IBM/MVS versions available
  103.                Structured programming preprocessor
  104.     MFE      : MULTI_FILE_EDIT               PC demo available on request
  105.     FAM      : File_Amender                  PC demo available on request
  106.     TRANSIT  : Transfers OMF's between machines via
  107.                MS-DOS floppy and/or FTF
  108.     MANTXREF : MANTIS cross reference        PC demo available
  109.                and other utilities
  110.     COBSTR   : COBOL source documentation aid/structure charter
  111.                                              PC & IBM/MVS versions available
  112.  
  113.  
  114. Our PC software includes the following shareware products
  115.  
  116. COBOL utilities
  117.  
  118.     These are compatible with many compilers, including R. Noweck's
  119.     shareware COBOL600 and COBOL650. They can also handle COBOL source
  120.     downloaded from a number of different hardware platforms.
  121.  
  122.     COBFORM  : as above
  123.     COBSTR   : COBOL source analyzer, documentation aid & structure charter
  124.     COBFLOW  : COBOL source logic charter
  125.     COBTABLE : COBOL record and structure layout print
  126.     COBXREF  : COBOL Cross reference list
  127.     PSICO    : Structured COBOL development aid
  128.  
  129. The following PC program is available on a commercial basis only, ie it is NOT
  130. available as shareware. A demo IS available, and the package could be made
  131. available on other hardware, as it is itself written in COBOL.
  132.  
  133.     COBWEB   : COBOL structure analyzer, assists reverse engineering
  134.                and re-engineering of old COBOL.
  135.  
  136. Other shareware
  137.  
  138.     MATCH    : Interactive file compare
  139.     SECURE   : Security aid
  140.     NJTREE   : Yet another directory tree program
  141.     DELTREE  : Directory tree deletion
  142.  
  143. ==============================================================================
  144.                      4. General Software and Utilities
  145. ==============================================================================
  146.  
  147. MULTI_FILE_EDIT
  148. ===============
  149.  
  150. This is a full-screen text editor for ICL 2900 and Series 39 mainframe
  151. computers
  152.  
  153. It features
  154.       Simultaneous editing of a number of files,
  155.       Cut and paste between files
  156.       Split screen working
  157.       Editing of long records (up to 2040 bytes)
  158.       Hexadecimal screen edit
  159.       Built-in COBOL and SCL reformatters
  160.       Insertion of Path Analysis and Trace code into COBOL source
  161.       COBOL Animator, for single step execution with source display
  162.       Text compression
  163.       Built-in structured COBOL preprocessor
  164.  
  165.       and many other useful functions.
  166.  
  167. A PC-based demonstration version, with tutorial file, is available from us
  168. on request, for a nominal charge. (It requires at least 512k of memory.)
  169.  
  170.  
  171. FAM - File Amender
  172. ==================
  173.  
  174. For ICL 2900 and Series 39 mainframe computers.
  175.  
  176. This is an interactive utility for amending a serial or indexed file.
  177.  
  178. It features
  179.  
  180.     Full screen record display, including datanames as well as the data
  181.     Conversion of data to and from COMPUTATIONAL, COMP-3 and hexadecimal
  182.     Automatic record initialisation
  183.     Insertion, amendment and deletion of records
  184.     Optional display of COBOL Group names and redefinitions
  185.     Print of selected records
  186.     Optional Autoprint of changed records
  187.  
  188. A PC demonstration version is available on request.
  189.  
  190. MATCH : File comparison
  191. =======================
  192.  
  193. This IBM/PC interactive file comparison will enable two text files to be
  194. compared, with the differences between individual pairs of records indicated.
  195.  
  196. When a mismatch occurs, the next 8 records of each file are displayed. You
  197. will be able to step one or both files forwards until matching is
  198. re-established, and the program then proceeds to the next mismatching pair.
  199.  
  200. It can display in Hex as well as ASCII, can handle binary data, and allows
  201. left and right margins to limit the range of columns compared.
  202.  
  203. It is accompanied by other MS-DOS utilities:
  204.  
  205.    NJTREE    Directory Tree display
  206.    DELTREE   Directory Tree deletion
  207.    SECURE    Directory Tree renaming
  208.  
  209. ==============================================================================
  210.                             5. COBOL Utilities
  211. ==============================================================================
  212.  
  213. COBOL Reformatter - COBFORM
  214. ===========================
  215.  
  216. This program allows you to reformat COBOL programs to conform to your own
  217. preferred layout. It also contains a structured programming preprocessor which
  218. converts structured programming commands into valid COBOL.
  219.  
  220. The layout of the converted program is defined in a table which specifies the
  221. alignment of selected COBOL verbs, reserved words and datanames. Two sample
  222. tables are supplied, one of which contains the structure verbs.
  223.  
  224. The table also allows you to perform global replacements of selected keywords
  225. througout the text, thus you can change all occurrences of a dataname or a
  226. paragraph name.
  227.  
  228. You can also specify input and output "card" layouts, and can therefore
  229. convert to and from various nonstandard source formats, such as DEC and UTAH.
  230. The other utilities below require a standard source layout, and therefore
  231. COBFORM may be needed in order to convert the source first.
  232.  
  233. In the PC and ICL versions, COBOL MACROs are available. A library of well
  234. designed and tested macros can make a substantial contribution to
  235. productivity, as well as reducing the scope for program errors.
  236.  
  237. COBXREF - COBOL cross reference
  238. ===============================
  239.  
  240. This provides a sorted cross reference of COBOL programs. It includes all
  241. datanames, paragraph and section names.Some COBOL reserved words may
  242. be included, as well as numeric literals and some PICTURE clauses. Most
  243. COBOL verbs are filtered out.
  244.  
  245. All dialects of COBOL are allowed, provided that the standard COBOL card
  246. layout is used, ie columns 1-6 for sequence, 7 for comment, 8-72 for source
  247. text. The program can cope with large programs, up to about 7000 source lines,
  248. depending on the complexity and number of datanames.
  249.  
  250. COBFLOW - COBOL LOGIC CHARTER
  251. ==============================
  252.  
  253. COBSRC produces a file which contains details of all sections, paragraphs, GO
  254. TO's, PERFORMS and STOP's (including EXIT PROGRAM and GOBACK) within a COBOL
  255. source.
  256.  
  257. It is compatible with all versions of COBOL prior to ANS85. (It is not
  258. expected that programs written to ANS85 standard will need this facility)
  259.  
  260. COBFLOW takes this analysis file, and produces a logic chart. Although not yet
  261. a full flowchart, it is nevertheless a useful tool in investigating old
  262. programs.
  263.  
  264. Further development is dependent on YOUR support, by registration.
  265.  
  266. COBWEB - COBOL program analyzer
  267. ===============================
  268.  
  269. This program represents a break-through in COBOL re-engineering, and is a step
  270. on the road to automated restructuring of old code, pre ANS85. (It is not
  271. expected that programs written to ANS85 standard will need this facility)
  272.  
  273. It is developed from COBFLOW and is able to indicate subsets of a COBOL source
  274. which are self-contained and can be taken out of line to be performed.
  275.  
  276. A further program is under development which will perform the actual code
  277. amendments indicated by COBWEB.
  278.  
  279. It is not intended to issue this program as Shareware, although a cut-down
  280. demonstration version is available, which is fully functional except for a
  281. limit on the number of paragraph names within a SECTION.
  282.  
  283. PSICO
  284. =====
  285.  
  286. This is a program for interactive development of structured COBOL programs.
  287.  
  288. It contains formatted screens to capture the body of each program
  289. structure, reducing the development time and ensuring correct structure
  290. syntax is used.
  291.  
  292. The output is a structured program in a suitable form for input to
  293. COBFORM, which will then convert it to standard (ANS74) COBOL.
  294.  
  295.  
  296. ==============================================================================
  297.                              6. Items supplied
  298. ==============================================================================
  299.  
  300. README.CBT      This file
  301. COBTABLE.EXE    The COBTABLE program
  302. STRTABLE.TXT    Table file used by COBTABLE
  303.  
  304. ==============================================================================
  305.                          7. Use and performance
  306. ==============================================================================
  307.  
  308.  
  309. This utility reads a COBOL source file, and creates a print file
  310. containing details of each data structure within the program. It
  311. extracts ALL 01 levels from DATA DIVISION, including record
  312. layouts, WORKING STORAGE and LINKAGE SECTION.
  313.  
  314.        Run the program, and it will ask for the name of the COBOL
  315.        source file. CTRL+BREAK will abandon the job.
  316.        Abandons with error 053 if the named source file does not exist.
  317.  
  318.        STRTABLE.TXT MUST be in the current directory! Otherwise you
  319.        will get error 053.
  320.  
  321.        Print file RECTABLE.DAT will be created in the current directory
  322.  
  323.  
  324. NOTE:
  325.  
  326. The sizes calculated for COMPUTATIONAL items are taken from IBM
  327. mainframe (MVS) standards, which are widely used on other
  328. machines. However, the actual sizes used may depend on the
  329. compiler and hardware in use. For example, the (now obsolete) ICL
  330. 1900 range used 6-bit characters instead of bytes, and is not
  331. compatible.
  332.  
  333. If you find the results are incorrect, please ask for a special
  334. version tailored for your own environment.
  335.  
  336. SOURCE COMPATIBILITY
  337.  
  338. This program is compatible with many variants of COBOL syntax,
  339. for example it will accept literals bounded by either quotes or
  340. apostrophes. It has obviously not been able to test it on ALL
  341. versions of COBOL - if you find a problem, please let us know,
  342. and we will try to fix it.
  343.  
  344. COBTABLE only allows standard COBOL source layout. If you use a
  345. non-standard layout, (eg DEC with 132 columns and no sequence
  346. numbers), you can use COBFORM to convert the source to standard
  347. format first.
  348.  
  349. ==============================================================================
  350.                              8. History
  351. ==============================================================================
  352.  
  353.  
  354. Version  1.00     June 1993   Initial release
  355. Version  1.10     June 1993   Amended to include COMP-3 heading
  356. Version  1.11     July 1993   Amended to reduce EXE size and speed processing
  357.  
  358.  
  359.  
  360. ==============================================================================
  361.                                9. Documentation
  362. ==============================================================================
  363.  
  364.  
  365. All necessary documentation is within this file
  366.  
  367.  
  368. ==============================================================================
  369.                             A. Aknowledgements
  370. ==============================================================================
  371.  
  372.  
  373.   MANTIS is a registered trade mark of CINCOM Systems
  374.   IBM    International Business Machines
  375.   MVS    IBM operating system
  376.   ICL    International Computers Ltd
  377.   VME    ICL operating system for 2900 & Series 39
  378.  
  379.