Version: 2.0.4
Date: 02/17/2005


I. Introduction

s709 is an emulator for the IBM 709/709x family of computers. The sources also
contain utility programs for reading and writing files, both tape and card 
image. Changes have been made to these utilities to run in the IBSYS mode as
default.


II. Build s709

Lunix/Unix:

$ make

The make attempts to figure out which system to make for using uname.

Windows:

$ nmake nt


III. To run s709

The command line for s709 is as follows:

$ s709 [options] [r=reader] [u=punch] [p=printer] [CUU=tapefile]

Where the options are:

    -cCOMMANDS   - Command file
    -mCPU        - CPU mode, CPU = 709, 7090 or 7094, default = 7090
    -p           - Turn off panel mode
    -wNN         - Window size for panel, default = 25

The I/O units are defined as:

   r=reader      - Card Reader, CBN file.
   u=punch       - Card Punch, CBN file.
   p=printer     - Line Printer, BCD file.
   CUU=tapefile  - Channel/Unit tapefile, BIN or BCD file.


IV. Running IBSYS using SYSIN1 tape

Use the runibsys shell script, or batch file for Windows, to run IBSYS using
tape as the input. This script tries to encapsulate the entire process of
running the job(s). The command is:

$ runibsys inputjob outputlisting

Where the arguments to the runibsys command are:

   inputjob      - The JOB to be run starting with the JOB card.
   outputlisting - The resultant output listing converted to ASCII.

After entering the runibsys command the input job will be copied into the
SYSIN1 tape image with IBSYS control cards before and after the job. The 
emulator will startup reading the ibsys.cmd file for execution commands.

After the job(s) run the SYSOU1 tape will be converted and written into
the output listing file.

On Windows the program will be run in non panel mode.


V. Running IBSYS using Card input

Use the runibsysc shell script to run IBSYS using cards as the input. This
script tries to encapsulate the entire process of running the job(s). The
command is:

$ runibsysc inputjob outputlisting

Where the arguments to the runibsys command are:

   inputjob      - The JOB to be run starting with the JOB card.
   outputlisting - The resultant output listing converted to ASCII.

After entering the runibsys command the input job will be copied into the
SYSIN1 tape image with IBSYS control cards before and after the job. The 
emulator will startup reading the ibsysc.cmd file for execution commands.

After the job(s) run the SYSOU1 tape will be converted and written into
the output listing file.


VI. Known problems/issues


1. Recognizing traps in multichannel mode can result in the second trapping
   channel to get lost.


2. Parity checking in the simulator is turned off, due to there being parity
   errors on the IBSYS "tapes". This allows the system to operate with the
   current tapes.


3. The FORTRAN II runtime library has a checksum error. Causing the simulator
   to go into a loop (actually the FORTRAN loader is in retry). May be related
   to problem 2.

