home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / coders / jËzyki_programowania / cobol / nrcobol1a / nrcobol.readme < prev    next >
Text File  |  1997-08-06  |  12KB  |  360 lines
  1. NRcobol Version 1.0a  by cHArRiOTt August 97
  2.  
  3.  
  4.  
  5.   1.Introduction
  6.   2.Installation
  7.   3.Usage
  8.   4.Syntax
  9.   5.Implemented?
  10.   6.History
  11.   7.Todo
  12.   8.Bugs
  13.   9.Feedback
  14.  10.Contacts
  15.  11.Distribution
  16.  12.Credits
  17.  13.Disclimer
  18.  
  19.  
  20.  
  21. NUff REsPEct.....peace n more time.
  22.  
  23. -------------------------------------------------------------------------
  24.    1.Introduction ...Why COBOL?
  25.  
  26.  
  27. To those of you thinking not another new language, COBOL is in fact one
  28. of the oldest high-level languages, its roots going back to the late
  29. 1950's. Ofcourse there are those of you who already know this but regard
  30. COBOL as not so much an high-level language, as the original computer
  31. virus. To these people i say RESPECT the source of the mother tounge. (sic!)
  32.  
  33. When so many languages have come and gone (what ever happended to
  34. Modulus II), COBOL has seen in the advent of STRUCTURED,and now OBJECT
  35. methodologies, its adapted absorbing the latest in Database Management, SQL
  36. etcetera, and gone on from strength to strength. Indeed as an introduction
  37. to records there's alot to be said in its favour. So when people say why,
  38. i say why not?
  39.  
  40.  
  41. This implementation of COBOL is largely ANSI 85 compatable and takes the
  42. form of MicroSoft(TM) COBOL, with maybe the exception of some stuff in
  43. ENVIRONMENT DIVISION - SPECIAL-NAMES. And some stuff left over from the days
  44. when memory was premium and no one had the imagination to contemplate speed.
  45. see Implementation?
  46.  
  47.  
  48. This would have been bought to you sooner, if it weren't for the moron, in
  49. the bedsit down stairs, with something of an habit!! which in lean times
  50. even extend to a fixation with gas. 'would you adam n eve it'.
  51.  
  52. WARNING dope really @&*$% you up! something to do with short term memory
  53. going to pot!
  54.  
  55.  
  56.  
  57. STOP THE PRESS!.
  58.  
  59. "COMPUTING" MAY 8th 97
  60.  
  61. 'Cobol crisis looms' The skills cris is luring Cobol programmers out of
  62. retirement with offers  of up to £1000 ($1700) per day......  hmm :-)
  63.  
  64.  
  65.  
  66. -------------------------------------------------------------------------
  67.    2.Installation
  68.  
  69.  
  70. Nothing could be simpiler, Just copy the runtime program 'RUNCOB' anywhere
  71. in your path, that's ram: c: or in the same directory as the created .INT
  72. files.
  73.  
  74. Files with the extension .INT are created as a result of successfully
  75. running NRCOBOL ..see Usage
  76.  
  77.  
  78. -------------------------------------------------------------------------
  79.    3.Usage
  80.  
  81.  
  82. After creating your cobol source file with your favourite text editor,
  83. and saving it with the .COB extention you have a choise of evoking the
  84. compiler from CLI/shell or Workbench.
  85.  
  86. From CLI/SHELL
  87.  
  88.      NRCOBOL <sourcefile>.COB [-l] [-d]
  89.  
  90. where the optional flags:
  91.  
  92.      -l   produces a simple listing  <sourcefile>.LST
  93.      -d   produces a debug  listing  <sourcefile>.DBG
  94.  
  95. A successfull compilation produces <sourcefile>.INT
  96. to run type...  RUNCOB <sourcefile>.INT
  97.  
  98.  
  99.  
  100.  
  101. From Workbench
  102.  
  103.      Use of the program from workbench is self explanatory, but for those
  104.      too dim.
  105.  
  106.  
  107.      +--------------------------------------+
  108.      |                                 [.][#]
  109.      |+-----------------------------------+-|
  110.      ||Titles                            || |    <-- What When Who
  111.      ||                                  || |
  112.      ||                                  || |
  113.      |+----------------------------------+| |
  114.      |File: |                            || |    <-- current sourcefile.COB
  115.      |      +----------------------------+| |
  116.      |___________________________________ | |
  117.      ||                                  || |
  118.      || IDENTIFICATION             *     || |    <-- status block
  119.      || ENVIRONMENT                *     || |         *'s replaced by
  120.      || DATA                       *     || |        PASSED or FAILED
  121.      || PROCEDURE                  *     || |
  122.      ||                                  || |
  123.      ||                                  || |    <-- current line
  124.      |+----------------------------------+| |
  125.      |+----------+      +----+       +---+| |    <-- ancillary output files
  126.      ||          | List +----+ Debug +---+| |        as  .LST  and/or .DBG
  127.      || COMPILE  | +---------+ +---------+| |
  128.      ||          | |  LOAD   | |  EXIT   ||_|
  129.      |+----------+ +---------+ +---------+|=|
  130.      +------------------------------------+-+
  131.  
  132.           ^            ^            ^
  133.           |            |            |
  134.           |            |            |
  135.           |       filerequester     |
  136.     Make it so #1              Exit  program or
  137.                                Abort compilation or
  138.                                RUN   successful compilation
  139.  
  140. In both cases an ICON is produced named <sourcefile>.INT
  141. to execute just double click.
  142.  
  143.  
  144. The debug option produces a file which you may find useful in locating
  145. runtime errors, which sadly is normal for cobol. Usually this is to do with
  146. uninitialised variables, you know, finding alpha data in a numeric field.
  147.  
  148. Runtime errors usually return a value in the form 0x????, where 0x???? is an
  149. offset into the data space allocated in the Data Division. Stradling values,
  150. ie value between offset values indicates a postion within a table,
  151. (a subsripted identifier).
  152.  
  153. -------------------------------------------------------------------------
  154.    4.Syntax
  155.  
  156.  
  157.    I may at a later date add the syntax, in the mean time the following
  158.    books are recomended:
  159.  
  160.  
  161.    -  COBOL for the IBM Personal Computer by kip R Irvine
  162.  
  163.    -  COBOL for the 80's                  by J Wayne Spence
  164.  
  165.    -  Structured  Programming in COBOL    by B J Holmes
  166.  
  167.    -  COBOL 85 for programmers            by Jim Inglis
  168.  
  169.  
  170.    OK go on then..
  171.  
  172. -------------------------------------------------------------------------
  173.    OK go on then..  The basics.
  174.  
  175.  
  176.    In Every Dam Program there are four division.
  177.  
  178.       INTRODUCTION DIVISION.
  179.       PROGRAM-ID.  <>.
  180.  
  181.       ENVIRONMEMT  DIVISION.
  182.  
  183.  
  184.       DATA         DIVISION.
  185.  
  186.  
  187.       PROGRAM      DIVISION.
  188.  
  189.  
  190.            ACCEPT           ADD           CALL           CANCEL
  191.            CLOSE            COMPUTE       CONTINUE       DELETE
  192.            DISPLAY          DIVIDE        EVALUATE       EXIT
  193.            GO               IF            INITIALIZE     INSPECT
  194.            MERGE            MOVE          MULTIPLY       OPEN
  195.            PERFORM          READ          RELEASE        RETURN
  196.            REWRITE          SEARCH        SET            SORT
  197.            START            STOP          STRING         SUBTRACT
  198.            UNSTRING         USE           WRITE
  199.  
  200.  
  201. -------------------------------------------------------------------------
  202.    5.Implemented?
  203.  
  204.  
  205.    IDENTIFICATION DIVISION.
  206.  
  207.    The program-id is required to be the same as the filename bar the
  208.    .COB file extention. This allows for consistent CALLs to subprogram
  209.    and nested programs ie via their program-ids.
  210.  
  211.  
  212.    ENVIRONMEMT  DIVISION.
  213.  
  214.  
  215.    The only options supported in SPECIAL-NAMES are CURRENCY and DECIMAL-POINT.
  216.    I-O-CONTROL SECTION. recodnised but not implemented!
  217.  
  218.    DATA         DIVISION.
  219.  
  220.    There is no support for the REPORT SECTION or communications.
  221.    BLOCK and RECORD clauses recodnised but not implemented!
  222.    USAGE IS default always ie no support yet for PACKED / BINARY etc..
  223.    SYNCHRONISED is recodnised but not implemented!
  224.    SCREEN SECTION is as defined by Microsoft 2.XX , i may add some supports
  225.    for basic BUTTON GADGETS later!
  226.  
  227.    PROGRAM      DIVISION.
  228.  
  229.    All keywords above have been implemented!
  230.  
  231.    CORR/CORRESPONDING not supported.
  232.    reference modification pending!
  233.  
  234. -------------------------------------------------------------------------
  235.    6.History
  236.  
  237.  
  238.    July   97  -  first release CU Amiga Magazine
  239.    August 97  -  CU Amiga Magazine / Aminet
  240.                  resort to pre 'reference moddification' version, since
  241.                  last minute addition of reference modification option introduced
  242.                  strange/terminal errors ...sorry!
  243. -------------------------------------------------------------------------
  244.    7.Todo
  245.  
  246.  
  247.    -   font sensitive main program
  248.    -   font sensitive runtime screen
  249.    -   own rather than system input
  250.    -   Totally ANSI 85 see Implemented?
  251.    -   Intrinsic functions ANSI 89
  252.    -   support for SQL trainer module
  253.    -   OBJECT?????  Hmmmm :-)
  254.    -   port to collage unix environment
  255.        as soon as i find a suitable cross compiler to translate
  256.        condition/maths routines from hand coded M68k to ....
  257.  
  258.  
  259. -------------------------------------------------------------------------
  260.    8.Bugs
  261.  
  262.    -
  263.  
  264. -------------------------------------------------------------------------
  265.    9.Feedback
  266.  
  267.  
  268.    -   'things aint wot they ougt a'
  269.    -   unexpected output or syntax ... well you never know
  270.    -   congratulations
  271.    -   bribes not to continue
  272.    -   buy outs / takeovers
  273.    -   Donations of money / hardware ;-)
  274.    -   or even a post card from what ever part of the planet you and your
  275.        Amiga reside. Amiga dead? Long live Amiga.
  276.    -   OBJECT COBOL example code???
  277.    -   Spare copy of latest ANSI COBOL standard??
  278.        this comes via limited access to Ansi74 plus the stuff at the back
  279.        of most books on COBOL
  280.    -   Offers of work :-(
  281.  
  282.  
  283.    email : HARRIOTT@cardiff.ac.uk    (curtesy of Mike Evans @ cardiff uni)
  284.  
  285.    snail mail
  286.  
  287.            C Harriott
  288.            14a Splott Road
  289.            Splott
  290.            Cardiff
  291.            Cf2 2BZ
  292.            UK
  293. -------------------------------------------------------------------------
  294.    10.Contacts
  295.  
  296.    For further information on the COBOL scene you might try the FAQ
  297.    created and maintained by
  298.  
  299.       jfid@mfltd.co.uk (James Fidell)
  300.       http://www.mfltd.co.uk/~jfid/
  301.  
  302.  
  303. -------------------------------------------------------------------------
  304.    11.Distribution
  305.  
  306.  
  307.    Distribution is granted to anyone via floppy and internet/ BBS provided
  308.    documentation remains as is, only a nominal fee is charged for copying
  309.    and no attempt is made to reverse engineer the program.
  310.    Distribution is also granted to anyone compiling a CDROM provided the
  311.    above conditions are met AND i am sent a copy of the CDROM. Please??
  312.  
  313. -------------------------------------------------------------------------
  314.    12.Credits
  315.  
  316.    Would you belive i wrote this with the public domain 'C' compiler
  317.    NorthC 1.3 ...if you're out there S Hawtin thanks dude. Although i have to
  318.    say it makes for lazy programing. Hopefully GNU C will induce disipline!
  319.    Ouch!
  320.  
  321.  
  322.    Thanks expressed to Thore Böckelmann for the use of his disclimer (quite
  323.    frankley i couldn't have put it better myself) also thanks for gifting
  324.    the Amiga community his EXCELENT CyberAVI and CyberQT. A real babe of a
  325.    program. SHwing?? Now how about some avi/mov files AF/CUCD/ANOther?
  326.  
  327.  
  328.    Thanks also to those unknown warriors who gave their all to bring us the
  329.    freedom to program in assembler.. the authors of A68K and BLINK
  330.    without which.....  RESPECT!
  331.  
  332. -------------------------------------------------------------------------
  333.    13.Disclimer
  334.  
  335.  
  336. No warranty, either express or implied, is made with respect to the fitness  or
  337. merchantability of NRCOBOL.
  338.  
  339. cHArRiOTt (referred to as "the  author"),  reserves  the  right  to  not
  340. develop any future versions of NRCOBOL.
  341.  
  342. The author will try to make a good faith attempt at correcting any problems  if
  343. any are discovered, but is in no way required, nor bound to correct them.
  344.  
  345. The author neither assumes nor accepts any responsibility for the use or misuse
  346. of  these  programs.  He  will  also  not  be  held  liable  for damages or any
  347. compensation due to loss of profit or any other damages arising out of the use,
  348. or inability to use this program.
  349.  
  350. The author will not be liable for any damage arising from the failure  of  this
  351. program  to  perform as described, or any destruction of other programs or data
  352. residing on a system attempting to run the programs.
  353.  
  354. The user of this program uses it at his or her own risk.
  355.  
  356. -------------------------------------------------------------------------
  357.  
  358.   'yep, it's so much more...jealous?'
  359.  
  360.