home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / ASMUTL / PC370.ZIP / ASSIST.DOC < prev    next >
Encoding:
Text File  |  1987-04-25  |  5.9 KB  |  153 lines
  1.  TITLE 'PC/370 ASSIST Facility Documentation'
  2.  
  3.   A.  Overview
  4.   B.  ASSIST extended instructions
  5.   C.  User Guide
  6.  
  7.  EJECT
  8.  
  9.   A.  Overview
  10.  
  11.       The book, "Assembler Language With ASSIST", by Ross A. Overbeek
  12.       and W. E. Singletary published by Science Research Assocaites, Inc.
  13.       in 1976 describes a set of 370 extended instructions to greatly
  14.       simplify input and output for students learning to write 370 assembler
  15.       programs.
  16.  
  17.       PC/370 implements these instructions to allow students to
  18.       code, assemble, and execute ASSIST 370 programs on any 80x86 MS-DOS
  19.       based micro-computer rather than having to use an IBM 370 mainframe.
  20.       This was the original objective for which PC/370 was developed back
  21.       in 1981.  The first students to use PC/370 with ASSIST were volunteers
  22.       at the University of South Florida, College of Engineering.  The
  23.       students used a CP/M based Z80 micro-computer with the original version
  24.       of PC/370 instead of the IBM 3033 mainframe ASSIST system accessed via
  25.       RJE using keypunched card decks.
  26.  
  27.  EJECT
  28.  
  29.   B.  ASSIST extended instructions
  30.  
  31.       1.  XFILI =C'filename'
  32.  
  33.           This extended instruction redirects input source for XREAD.
  34.           If open, the current input source file is closed.  The new
  35.           filename can be any standard MS-DOS path/filename ending with
  36.           suffix .xxx or a zero byte.  If the filename is CON: then the
  37.           input source is the console with a ? prompt.  To set the ASSIST
  38.           end of file condition code for XREAD from the console, use the
  39.           escape (ESC) key.  See TESTACON.ALC for demo of redirection.
  40.  
  41.       2.  XFILO =C'filename'
  42.  
  43.           This extended instruction redirects the output from XPRNT.
  44.           If open, the current output file is closed.  The new file name
  45.           can be any standard MS-DOS path/filename ending with suffix
  46.           .xxx or a zero byte.  If the filename is CON: then the output
  47.           from XPRNT is directed to the console.  The first byte which is
  48.           printer control code is also printed on console.
  49.  
  50.       3.  XREAD area [,length]
  51.  
  52.           Read record into area with default length of 80 padded with
  53.           blanks.  If the input is coming from console, the first
  54.           carriage return defines end of record, and single ESC character
  55.           defines end of file.  Note ASCII charaters from console or file
  56.           are automatically translated to EBCDIC in record area.
  57.           Condition code set as follows:
  58.  
  59.             0 - read successful
  60.             1 - end of file
  61.  
  62.           Default input source is file named ASSIST.DAT.  If the file is
  63.           not found, the input and output source is switched to console.
  64.  
  65.       4.  XPRNT area [,length]
  66.  
  67.           Print record from area with default length of 132.  Trailing
  68.           blanks are stripped off.  The first character is used as standard
  69.           ANSII print control character:
  70.  
  71.            ' ' - space means skip one line
  72.            '/' - slash means skip two lines
  73.            '1' - one means skip a page
  74.            '+' - means skip no lines
  75.            '-' - dash means skip three lines
  76.  
  77.           Output to console includes print control character.  Default
  78.           output is to file named ASSIST.PRN which is also used by
  79.           interactive debug X logging command and XDUMP.
  80.  
  81.       5.  XDECI reg,area
  82.  
  83.           Read ASCII integer number from area and store into register.
  84.           Leading plus or minus signs may be present.  Condition code is
  85.           set as follows:
  86.  
  87.            0 - number is zero
  88.            1 - number less than zero
  89.            2 - number is greater than zero
  90.            3 - no number found in area
  91.  
  92.           Register 1 is set to address of first character after number read.
  93.  
  94.       6.  XDECO reg,area
  95.  
  96.           Convert binary integer number in register to 12 character display
  97.           field with numberic value including sign.
  98.  
  99.       7.  XDUMP [area start, area end]
  100.  
  101.           Dump general purpose registers (default with no args) or
  102.           dump area of memory to output file.
  103.  
  104.  
  105.  
  106.  EJECT
  107.  
  108.   C.  User Guide
  109.  
  110.       To code and execute a 370 demo program, follow the following steps:
  111.  
  112.       1.  Set default MS-DOS drive to floppy disk with executable code files.
  113.  
  114.       2.  Type the command:  SEE DEMO
  115.  
  116.       3.  When the full screen editor (SEE.COM) loads and displays blank
  117.           screen, hit CAPS key and INSERT key until both CAPS and INSERT
  118.           indicators are on.
  119.  
  120.       4.  Enter the following lines of text follwed by carriage returns:
  121.  
  122.           a.  DEMO    CSECT
  123.           b.          USING *,15
  124.           c.          XPRNT LINE
  125.           d.          BR    14
  126.           e.  LINE    DC    CL133' PC/370 ASSIST DEMO PROGRAM'
  127.           f.          END   DEMO
  128.  
  129.       5.  Enter ESC key to save DEMO.ALC file on diskette and exit editor.
  130.  
  131.       6.  To assemble 370 demo program, enter command:  A370 DEMO
  132.  
  133.       7.  If any errors occured in assembly, edit file via command: SEE DEMO
  134.  
  135.           (The SEE editor supports full screen editing via arrow keys etc.
  136.            For more information see SEE.DOC.)
  137.  
  138.       7.  To link 370 demo program, enter command: L370 DEMO
  139.  
  140.       8.  To execute 370 demo program, enter command:  DEMO
  141.  
  142.           (Message line should be displayed on console.  In release 1
  143.            default ASSIST output went to ASSIST.PRN disk file.  To
  144.            change output file assignment, use ASSIST instruction XFILO.)
  145.  
  146.       Two demo programs DEMOAST1.ALC and DEMOAST2.ALC illustrate use of
  147.       all ASSIST extended instructions.
  148.  
  149.       The interactive debug facility (see DEBUG.DOC) also has a command
  150.       X which toggles recording of all interactive debug console output
  151.       to the ASSIST output file (default name is ASSIST.PRN).
  152.  
  153.