home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / pascal-p / pp319doc.lbr / FILES.MZN / FILES.MAN
Encoding:
Text File  |  1987-02-03  |  5.5 KB  |  113 lines
  1. .macro chttl =  Runtime File Assignments
  2. .ch .chttl
  3.  
  4. .hl 1 General
  5. A number of run time errors can occur while running Pascal programs.  The
  6. messages  are  generally accompanied by a source code line number  if  the  N+
  7. option was in effect on compilation.   File errors are also accompanied
  8. by the file name.
  9.  
  10. Files  named in the Program line of the Pascal source are external to the
  11. Pascal program.  They may be defined .bb by the run command, .eb or may be
  12. temporary or
  13. permanent user files.   Files declared within procedures are unnamed temporary
  14. files (unless opened with a second parameter in the opening RESET or  REWRITE,
  15. as described below).  The files "input" and "output" normally connect to
  16. the user's console.
  17.  
  18. .hl 1 On 8080/z80 under CPM:
  19. The program command line is normally of the form:
  20.  
  21. .i 5       d>RUNPCD program (fileparameters) [parm]; _<inputfile >outputfile
  22.  
  23. (with "RUNPCD" omitted for _.COM files) but is not restricted to that,
  24. i.e. use of the command line is entirely under
  25. the  control of the application program.   Any section after "program" may  be
  26. omitted,  and defaults apply.  The file parameters replace the files mentioned
  27. in  the Pascal PROGRAM heading.   If omitted the Pascal internal  filename  is
  28. used.   Files input and output cannot be redirected by this mechanism, but use
  29. the  "Unix" flavored "_<" and ">" (comesfrom and goesto) redirection  commands.
  30. By  default input and output connect to the users console.  Parm is an integer
  31. in the range 0..32767,  with a default value of 0.  Use is up to the executing
  32. program,  however  odd values are used to cause an initial debug trap,  and to
  33. enable various run-time debugging aids.  Thus it is suggested that application
  34. programs rely primarily on even values.
  35.  
  36. .hl 2 CPM device files
  37. Under CPM and other systems the following device files  are
  38. normally  available (and their names cannot be used for other  files).  Unless
  39. mentioned these are text files. Any devicefile may be used interchangably with
  40. a disk file of the same type.
  41. .rem end itemize with .res
  42. .macro itemize = .sav .tabs 10 20 .p -10 1 5 .lm 20 .rm $$rm-10;
  43. .itemize
  44. .pp  CON .t    the system console, .bb buffered for input or output. .eb
  45. .pp  KBD .t   the  system console keyboard,  without  buffering  or
  46. echoing of input.   Correct use of this file requires
  47. either modification to CPM 2.2. or (interpreters 2.8
  48. up) prevents use of the  CNTRL-P CPM function.  This
  49. avoids  loss of input characters during console  output. 
  50. See the STATUS procedure.
  51. .pp  RDR .t   The system "reader" device, line buffered.
  52. .pp  PUN .t   The system "punch" device
  53. .pp  LST .t   The system "list" device
  54. .pp  AUX .t   Identical to RDR device with no line buffering. _<lf>s
  55. are translated to _<nul>.  See STATUS procedure.
  56. .pp  NUL .t   a null file (bit bucket).  Any type.
  57. .pp  CMD .t   A one line file containing the run command line.
  58. .res
  59.  
  60. Various other device files can exist at various installations.   Examples
  61. are:
  62. .itemize
  63. .pp  KBB .t   Identical to KBD, except that "reset(kbb)" causes all
  64. console  i/o to be performed through interrupt driven
  65. buffers.   The  close operation on kbb (either  
  66. specifically  performed  or by exit  from  the  declaring
  67. procedure) restores the normal unbuffered drivers.
  68. .pp  AD1..AD8 .t  A set of 8 analog/digital converters. FILE OF real.
  69. .pp  RS1, RS2 .t   Direct access to RS232 i/o ports. See STATUS.
  70. .pp  R1B, R2B .t   As RS1 and RS2, but buffered via interrupt system.
  71. These  files will not cause "waits" in the  executing
  72. program,  unless the buffers fill or are empty.  This
  73. can be pre-checked with the STATUS function.
  74. .res
  75. .hl 2 File Redirection
  76. Under .bb CPM .eb file redirection is  available,  by
  77. substituting the desired files in the program header.   Files not specified by
  78. this  method default to the Pascal filename.   A pair of commas can skip  file
  79. redirection for any one file.   Note that INPUT and OUTPUT connect to "CON" by
  80. default and cannot be redirected by this mechanism, but that the sequence
  81.  
  82. .i 10     A>RUNPCD progfile(whatever) _<inputfilename >outputfilename .b
  83. .i 35            will redirect INPUT and OUTPUT.
  84.  
  85. .note NOTE
  86. The "lf" character is normally ignored .bb  on input. .eb
  87. However input of a lf will cause the STATUS function to return a
  88. 2 bit (see below) because the hardware is physically loaded.   If a get is now
  89. performed  the system will flush the lf and perform the following get  
  90. automatically.   This can cause unexpected delays when performing 
  91. direct device I/O.
  92. For this reason some device drivers are modified to translate lf into nul  and
  93. the user must specifically discard it.   The AUX file translates all lf's into
  94. nulls for this reason.
  95. .res
  96. .hl 2 Under CPM the file search order is:
  97. .list 1
  98. .le            The default disk,  if  no drive  specified,
  99. .le         The system disk. .b
  100. and then, for code files (.PCD) to be executed only:
  101. .le            within the library file PCDS.LBR on the default disk.
  102. .le         within the library file PCDS.LBR on the system disk ONLY
  103. when no library was found on the default disk.
  104. .endlist
  105.  
  106. If  a  drive  has been specified the search is limited to  the  specified
  107. drive.   If  the  modified CCP and JOB (for submit) files are  installed  this
  108. search order is implemented at all levels,  otherwise it is limited to  Pascal
  109. program executions.
  110.  
  111. Files  INPUT and OUTPUT default to "CON" (the console) under  CPM.   See
  112. above for run-time re-direction.
  113. ╕╫