Version: 1.0.3
Date: 03/24/2005


I. Introduction

This directory contains several utilities that I've written for the IBM 7090.


II. Build utilities

Lunix/Unix:

$ make

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

WinBlows:

$ nmake nt


III. To run the utilities

III.1 bsplit

This utility takes the input binary tape image file and splits it into
seperate files.  The command is:

$ bsplit intape outfileroot


III.2 obj2bin

This utility takes the asm7090 object and makes a scatter load tape image.
The command is:

$ obj2bin [options] objectfile tapefile

Where options are:

   -l loadaddr  - Load address for relocatable objects.
   -s objnum    - Object segment number.


III.3 bd

This utility performs a BCD dump of a file. The command is:

$ bd [options] bcdfile

Where options are:

   -r           - Process record boundaries


III.4 bincmp

This utility performs a binary compare of two binary tape images. The command
is:

$ bincmp tapefile1 tapefile2


III.5 disasm

This is a simple disassembler for the binary tape images. The command is:

$ disasm tapefile

The disassembled source is written to standard out.


III.6 gelbl2txt

This program reads GE labeled BCD tapes, deblocks and writes out text records.
The command is:

$ geblb2txt gelabeltape.bcd textfile.txt


IV. To create a new IBSYS load tape

1. Copy the current load tape into a directory:

   $ cp ../images/ASYS1.BIN ./

2. Split it apart:

   $ bsplit ASYS1.BIN asys1

   This will create files for all the parts as asys1_fffrrr.bin
   Where fff is the file number and rrr is the record number.

3. Copy in the new IBSYS nucleus and convert to scatter load:

   $ obj2bin ../ibsysdir/ibsys.obj asys1_001002.bin
   $ obj2bin -s 1 ../ibsysdir/ibsys.obj asys1_001003.bin

   This will take the IBSYS object file from asm7090 and convert it into
   the tape file. The IBSYS nucleus is ALWAYS file 001 record 002 of the
   load tape. The second obj2bin copies in the SYSDMP which matches the
   IBSYS configuration.

4. Glue the parts back together:

   $ cat asys1_*.bin >ASYS1.BIN

5. The new image is now ready to be loaded.

There are two shell scripts, update1.sh and update8.sh, that updates various
parts of the IBSYS tapes. To use the scripts you must have split apart the
tape prior to execution. Also, If want to use the check option you must have
split it apart under a different root. For example:

1. Split apart the ASYS1 tape:

   bsplit ASYS1.BIN asys1
   bsplit ASYS1.BIN Asys1

2. Update FORTRAN II compiler and check it:

   update1.sh fortII check

3. Glue it back together:

   $ cat asys1_*.bin >ASYS1.BIN

