Roadtech Administrative Toolkit History 1991

In limited form these date back to the original CBASIC version of roadrunner. Running on CPM-80 in 1986.

This was followed by the first multi user version written using RMcobol-74 on concurrent CPM in 1988

In there current form these date from 1991, and the migration of Roadrunner from RMcobol-74 on Concurrent CPM. To RMcobol-85 on the then new IBM AIX operating system on the new IBM RS6000 model 320.

Administrative scripts
INET servers

Administrative scripts.

While a few of the previous utilities written in C were also relevant to early AIX systems, most of the administration was different. The administrative programs for UNIX systems are written mainly in Korn shell script, to aid in administering and using UNIX based systems with Roadtech software.

In there current form, the administration suite will run on the following platforms. There are some platform specific differences in the functionality.


AIX 3.1, 3.2, 4.1, 4.2, 4.3
UNIX_System_V version 3.0

1991

Initial porting for AIX 3.1

Administrative user to own the programs and data files	rr85
Group for programs and files	rm85
Directory for Roadrunner Data	/usr/share/rr85
Directory for COBOL applications programs	/usr/share/rr85/cobs
Directory for temporary applications data files	/usr/share/rr85/tmp
Directory for installation programs and configuration	/usr/share/rr85/instbits
Directory for Program data	/usr/share/rr85/instbits
Directory for Customer data templates	/usr/share/rr85/instbits/base
Directory for temporary administration files	/var/tmp

Program configuration Data

Files that ship with an install or program update set.

Program Data Files
AAPGMPGM.DAT	?
RRFILCTL.DAT	Map of data files to storage group?
RRFILDAT.DAT	Map of data files to storage group?
RRHELP01.DAT	Main Help File. Provides help messages.
RRHELPE1.DAT	?
RRHELPH1.DAT	Hungarian?
RRHELPM1.DAT	MOD?
RRLAY00E.DAT	Main layout file English.
RRMENSDT.DAT	Main Menu configuration file German?.
RRMENSET.DAT	Main Menu configuration file English.
RRMENSMT.DAT	Main Menu configuration file MOD?.
RRPRNDEF.DAT	Printer Definition File
RRSCRDEF.DAT	Terminal Screen Definition File
RRTRMDEF.DAT	Terminal Keyboard Definition File
SCREENSD.DAT	Main Program prompt configuration file German?
SCREENSE.DAT	Main Program prompt configuration file English.
SCREENSH.DAT	Main Program prompt configuration file Hungarian?
SCREENSM.DAT	Main Program prompt configuration file MOD.
SCRMERGE.DAT	Partial screen file, shipped with program update.
SCRNAUXD.DAT	Auxiliary screen file German.
SCRNAUXE.DAT	Auxiliary screen file English.
SCRNAUXH.DAT	Auxiliary screen file Hungarian.
SYSCHK.DAT	CRC values for programs in install set.
SYSDEF.DAT	?
WHFONT01.DAT	Extended font data used by warehouse report generator?
WHLAY00E.DAT	Warehouse report layout templates English?

System Data files.

Files created during install, that do not relate to a specific company. These should not be copied to an install tape. These should not be copied while copying a company.

System Data Files
RRCNTROL.DAT	Control file for data set.
RRCOMP01.DAT	Main Company Control file.
CHKLOG.DAT	Program validation check, output log.

Sample Data files, or templates.

Copy to install tape. Copy to Initial company, while installing system

Template Files
AAACCAUA.DAT
AACOS00A.DAT	Per company, Cost Center data.
AANOM00A.DAT	Per company, Nominal account data.
AANOMLRA.DAT	Per company, Nominal ledger structure.
RRCOMCNA.DAT	Per company, control data
RRUSRLGA.DAT	Per company, user activity log. Only needed as it is not getting created when you run RRFMAKE1, or when a user logs in.

1992

Initial release to customers for AIX 3.1

1993

New release to support AIX 3.2

New release to support UNIX System V, for MOD

Add support for customizable user menu

New stop user option

New stop screen option

New fix port option

Add performance evaluation menu

AIX only. Makes use of the AIX performance measuring functions. To evaluate how the system is running, and whether it is hitting a bottle neck on CPU, I/O, or memory.

Routine will estimate what sort of changes may be needed to give a reasonable performance boost. There is no point in the customer buying more RAM if the system is I/O bound and vice versa.

New Fix print queue option for AIX

Force system check after update

Add option to "kill" users for backup

Sends SigTERM to COBOL run times. this requests that they close files and exit. Then runs roadrunner recovery to check system is consistent before backup. We do not want to write a backup of an inconsistent system over a good backup.

Add clone menu

Copies RoadRunner to a 2nd disk area. On servers with multiple disk controllers, and volume groups this can be quicker than a copy to tape.

Include terminfo configuration on update

Update routine to read in custom terminal definitions, and compile them.

Add support for 1.2GB QIC tape

1994

Option to restore files from an IBM system backup tape

Switch to check.sh

New check script replaces previous version.

1995

Make install tape

An install tape may be made from any system. Install tape includes RoadRunner programs, Program configuration files, support applications, but excludes customer data files. Required along with software source escrow agreement by new customer.

Add system information prints for AIX

Additional Tape support

8mm 5GB, 4mm 2GB, and 4mm 4GB.

1996

Add support for Unix system V rel 3. {ICL}

Support added for MOD.

Add support for AIX 4.1

New OS from IBM to support new server models.

Multiple processors (SMP)
PCI expansion bus
Lots of command changes.
System backup tapes have a different format

Functionality

Bose operating system menu (BOS menu)

Seperate "BOS menus" for AIX 3.x, AIX 4.1, and sysV rel 3.

Copy Company routine

Function added to check menu to copy files for a company. Will copy between different company letters and or between data sets. Will not overwrite files. Will not copy program related data file where these are still linked to data directory.

Load AIX updates from CD

Add support for loading AIX operating system updates from CD.

File list from programming

Conditional names. In the table of file names below the following codes indecate that the file name is conditional on the value indecated.

<cc>	Company code. Single character from the set A-Z or 0-9
<lc>	Language code. Single character from the set A-Z or 0-9
<t>	?
<user>	3 digit user id number

This list is incomplete.



File Name What Error tag

AACOS00<cc>.DAT Per company, Cost Center data. COST-CNTR            
AANOM00<cc>.DAT Nominal Accounts NOM-ACCT       
RRABKGS<cc>.DAT ? ABKG-FILE
RRADRS0<cc>.DAT Address file. used to save collection and delivery addresses. ADRESES              
RRBKGS0<cc>.DAT Main bookings file MAIN-BKGS-FILE  
RRBULK0<cc>.DAT Bulk Job Contract file. BULK-CON-FILE        
RRCNREF<cc>.DAT ? CONS-REF-FILE        
RRCNTROL.DAT Data set control file CONTROL-FILE         
RRCOLET<cc>.DAT ? COLLETT-FILE         
RRCOMCN<cc>.DAT Per company control file COMP-CONTROL         
RRCOMP01.DAT Key to defined companies COMPANIES            
RRCONS0<cc>.DAT Main Consignment file MAIN-CONS-FILE       
RRCUS00<cc>.DAT Main customers file CUSTOMERS            
RRDESCR<cc>.DAT ? DESCRP-FILE          
RRDES00<cc>.DAT ? DESCRP2-FILE         
RRDIAK0<cc>.DAT Traffic diary file DIAK0-FILE           
RRDIAK1<cc>.DAT Traffic diary file DIAK1-FILE           
RRDIAK2<cc>.DAT Traffic diary file DIAK2-FILE           
RRDIAK3<cc>.DAT Traffic diary file DIAK3-FILE           
RRDRV00<cc>.DAT Drivers data file DRIVERS              
RRFFJOB<cc>.DAT Freight forward jobs file FF-JOB-FILE
RRFFITM<cc>.DAT Freight forward item file FF-ITEM-FILE         
RRFFLNE<cc>.DAT Freight forward item file FF-LNE-FILE          
RRFFLNK<cc>.DAT Freight forward link file FF-LNK-FIL           
RRFFPRD<cc>.DAT Freight forward product file FF-PRODUCT-FILE 
RRFILCTL.DAT ? FILE-CTRL            
RRFILDAT.DAT ? FILE-FILE            
RRGAZA0<cc>.DAT Gazateer GAZA-FILE
            
RRHELP01.DAT Main Help File, for specified language. HELP-FILE            
RRIBORD<cc>.DAT Invoice Booking Order file. Ties bookings to an invoice. IBO-FILE             
RRITEM0<cc>.DAT Main items file MAIN-ITEM-FILE       
RRJBPRD<cc>.DAT ? JOB-PRODUCT-FILE     
RRLAYOU<cc>.DAT Report layout file LAYOUT-FILE          
RRLINES<cc>.DAT Additional information lines for a booking. LINE-FILE            
RRLOG00<cc>.DAT Main event log file LOG-FILE             
RRMAN00<cc>.DAT Link jobs to form a manifest MANIFEST-FILE
RRMAT00<cc>.DAT ? MATRIX-FILE          
RRMBKG0<cc>.DAT ?>/td> MAN-BKG-FILE         
RRMENS<lc>T.DAT Main Menu configuration file, for specified language. MENU-FILE            
RRMSTRN<cc>.DAT Main sales transaction file. MAIN-SALTRN-FILE    
RRMUMSK<cc>.DAT User dependent menu mask. USER-MASK            
RRNBKG0<cc>.DAT ? NBKG-FILE            
RRPARCC<cc>.DAT ? CUS-CONTRACT-FILE    
RRPARCN<cc>.DAT ? ANC-CONT-RATES       
RRPARDT<cc>.DAT ? DEP-TWN              
RRPARDZ<cc>.DAT ? DEP-ZNE              
RRPARSU<cc>.DAT ? ANC-SURCHARGE-RATES  
RRPBKG0<cc>.DAT ? PBKG-FILE           
RRQTEIN<cc>.DAT ? QTE-INP              
RRRTECR<cc>.DAT Job Rate Card File. CRD-FILE             
RRSBKGS<cc>.DAT Sub bookings file SUB-BKG-FILE
RRTRL00<cc>.DAT Trailer data file. TRAILERS             
RRTRLDE<cc>.DAT Trailer defects record DEFECTS              
RRTSTR<t><cc>.DAT Temporary sales transactions <any>                
RRTTRN0<cc>.DAT ? MAIN-TRLTRN-FILE     
RRUSERS<cc>.DAT Users file USERS                
RRVEH00<cc>.DAT Vehicle data file. VEHICLES             
RRVEHDE<cc>.DAT Vehicle defects record. DEFECTS              
RRVTRN0<cc>.DAT Main vehicle transaction file. MAIN-VEHTRN-FILE     
RRXBKG0<cc>.DAT Extra bookings file XTRA-BKGS-FILE
SCREENS<lc>.DAT Terminal Screen Definition File, for specified language. SCREEN-FILE          
SCRNAUX<lc>.DAT Auxilary screen file, for specified language. SCRN-AUX-FILE        
TMP01<user>.DAT Temporary file <any>                
TMP02<user>.DAT Temporary file <any>                
TMP03<user>.DAT Temporary file <any>                
TMP04<user>.DAT Temporary file <any>                
TMP05<user>.DAT Temporary file <any>                
TMP06<user>.DAT Temporary file <any>

File Name	What	Error tag
AACOS00<cc>.DAT	Per company, Cost Center data.	COST-CNTR
AANOM00<cc>.DAT	Nominal Accounts	NOM-ACCT
RRABKGS<cc>.DAT	?	ABKG-FILE
RRADRS0<cc>.DAT	Address file. used to save collection and delivery addresses.	ADRESES
RRBKGS0<cc>.DAT	Main bookings file	MAIN-BKGS-FILE
RRBULK0<cc>.DAT	Bulk Job Contract file.	BULK-CON-FILE
RRCNREF<cc>.DAT	?	CONS-REF-FILE
RRCNTROL.DAT	Data set control file	CONTROL-FILE
RRCOLET<cc>.DAT	?	COLLETT-FILE
RRCOMCN<cc>.DAT	Per company control file	COMP-CONTROL
RRCOMP01.DAT	Key to defined companies	COMPANIES
RRCONS0<cc>.DAT	Main Consignment file	MAIN-CONS-FILE
RRCUS00<cc>.DAT	Main customers file	CUSTOMERS
RRDESCR<cc>.DAT	?	DESCRP-FILE
RRDES00<cc>.DAT	?	DESCRP2-FILE
RRDIAK0<cc>.DAT	Traffic diary file	DIAK0-FILE
RRDIAK1<cc>.DAT	Traffic diary file	DIAK1-FILE
RRDIAK2<cc>.DAT	Traffic diary file	DIAK2-FILE
RRDIAK3<cc>.DAT	Traffic diary file	DIAK3-FILE
RRDRV00<cc>.DAT	Drivers data file	DRIVERS
RRFFJOB<cc>.DAT	Freight forward jobs file	FF-JOB-FILE
RRFFITM<cc>.DAT	Freight forward item file	FF-ITEM-FILE
RRFFLNE<cc>.DAT	Freight forward item file	FF-LNE-FILE
RRFFLNK<cc>.DAT	Freight forward link file	FF-LNK-FIL
RRFFPRD<cc>.DAT	Freight forward product file	FF-PRODUCT-FILE
RRFILCTL.DAT	?	FILE-CTRL
RRFILDAT.DAT	?	FILE-FILE
RRGAZA0<cc>.DAT	Gazateer	GAZA-FILE
RRHELP01.DAT	Main Help File, for specified language.	HELP-FILE
RRIBORD<cc>.DAT	Invoice Booking Order file. Ties bookings to an invoice.	IBO-FILE
RRITEM0<cc>.DAT	Main items file	MAIN-ITEM-FILE
RRJBPRD<cc>.DAT	?	JOB-PRODUCT-FILE
RRLAYOU<cc>.DAT	Report layout file	LAYOUT-FILE
RRLINES<cc>.DAT	Additional information lines for a booking.	LINE-FILE
RRLOG00<cc>.DAT	Main event log file	LOG-FILE
RRMAN00<cc>.DAT	Link jobs to form a manifest	MANIFEST-FILE
RRMAT00<cc>.DAT	?	MATRIX-FILE
RRMBKG0<cc>.DAT	?>/td>	MAN-BKG-FILE
RRMENS<lc>T.DAT	Main Menu configuration file, for specified language.	MENU-FILE
RRMSTRN<cc>.DAT	Main sales transaction file.	MAIN-SALTRN-FILE
RRMUMSK<cc>.DAT	User dependent menu mask.	USER-MASK
RRNBKG0<cc>.DAT	?	NBKG-FILE
RRPARCC<cc>.DAT	?	CUS-CONTRACT-FILE
RRPARCN<cc>.DAT	?	ANC-CONT-RATES
RRPARDT<cc>.DAT	?	DEP-TWN
RRPARDZ<cc>.DAT	?	DEP-ZNE
RRPARSU<cc>.DAT	?	ANC-SURCHARGE-RATES
RRPBKG0<cc>.DAT	?	PBKG-FILE
RRQTEIN<cc>.DAT	?	QTE-INP
RRRTECR<cc>.DAT	Job Rate Card File.	CRD-FILE
RRSBKGS<cc>.DAT	Sub bookings file	SUB-BKG-FILE
RRTRL00<cc>.DAT	Trailer data file.	TRAILERS
RRTRLDE<cc>.DAT	Trailer defects record	DEFECTS
RRTSTR<t><cc>.DAT	Temporary sales transactions	<any>
RRTTRN0<cc>.DAT	?	MAIN-TRLTRN-FILE
RRUSERS<cc>.DAT	Users file	USERS
RRVEH00<cc>.DAT	Vehicle data file.	VEHICLES
RRVEHDE<cc>.DAT	Vehicle defects record.	DEFECTS
RRVTRN0<cc>.DAT	Main vehicle transaction file.	MAIN-VEHTRN-FILE
RRXBKG0<cc>.DAT	Extra bookings file	XTRA-BKGS-FILE
SCREENS<lc>.DAT	Terminal Screen Definition File, for specified language.	SCREEN-FILE
SCRNAUX<lc>.DAT	Auxilary screen file, for specified language.	SCRN-AUX-FILE
TMP01<user>.DAT	Temporary file	<any>
TMP02<user>.DAT	Temporary file	<any>
TMP03<user>.DAT	Temporary file	<any>
TMP04<user>.DAT	Temporary file	<any>
TMP05<user>.DAT	Temporary file	<any>
TMP06<user>.DAT	Temporary file	<any>

1997

Add support for AIX 4.2

New variables

Two new variables tmpdir and flagdir.

1998

Add support for AIX 4.3

Add Year 2000 Checks

INET servers

1998 saw our move to Shenley, and the start of a move to more of a client, server model. With increasing use of network connections, and servers.

Clients connect to the roadrunner server via an INET service.

1998 GOGO

First draft of a graphical client, using Visual Basic, and the RMcobol vangui connector. Client makes a TCPIP network connection using the tcp transport to port 9001.