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.
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 all be it with some functional differences on the following platforms.
|
| 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 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 | |
|---|---|
| RRCNTROL.DAT | Control file for data set. |
| RRCOMP01.DAT | Main Company Control file. |
| CHKLOG.DAT | Program validation check, output log. |
| 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. |
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.
| <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 |
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>
Separating the Company data from the utility installation also helps with replication between servers.
| Administrative user to own the programs and data files | rr85 |
| Group for programs and files | rm85 |
| Directory for Roadrunner Base Data set | /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 |
| Directory for additional Roadrunner Data set | /usr/share/*/" |
| Directory for temporary applications data files | /usr/share/*/tmp |
| Directory for COBOL applications programs | /usr/share/*/cobs |
| Directory for Program data | /usr/share/*/instbits |
Note setup allows for an unlimited number of data sets, on a server. This would simplify a hosted solution. Each data set can share the same copy of the COBOL programs and program data, or it can have its own copy.
Update routines modified to cater for both cases.
In both cases the customer wants to chose the installation directory structure for RoadRunner. This means replacing all absolute path reference with variables, in the short term that means two versions until changes are complete.
| PATH | Use | Variable |
|---|---|---|
| /usr/share/rr85/instbits | Roadrunner Administration scripts | RRadmin |
| /usr/share/rr85/instbits | COBOL Program configuration Data | RR_ProgDat |
| /usr/share/rr85 | Roadrunner base data set | RR_Dir |
| /usr/share/rr85/cobs | Roadrunner COBOL programs | RR_Prog1 |
| /usr/share/rr85/newcobs | Roadrunner COBOL program updates | RR_Prog2 |
| $HOME/newcobs | Experimental COBOL programs | RR_Prog3 |
| /var/tmp | Temporary files | tmpdir |
| /var/tmp/rr_flag | Data set flags | flagdir |
In addition references to the user "rr85" to be replaced with "${RT_Owner}", and "rm85" replaced with "${RT_Group}"
| Administrative user to own the programs and data files | ${RT_Owner} |
| Group for programs and files | ${RT_Group} |
| Directory for Roadrunner Base Data set | ${RR_Dir} |
| Directory for COBOL applications programs | ${RR_Prog1} |
| Directory for temporary applications data files | ${RR_dir}/tmp |
| Directory for installation programs and configuration | ${RTadmin} |
| Directory for Program data | ${RR_ProgDat} |
| Directory for Customer data templates | ${RTadmin}/base |
| Directory for temporary administration files | ${tmpdir} |
| Directory for additional Roadrunner Data set | /usr/share/*/" |
| Directory for Data set flags | ${flagdir} |
Lots of preliminary changes to hardware detection, and the provision of a BOS menu for Linux. This will not become a standard option until it has been well tested.
To test invoke RTadmin like this.
|
ImageLibrary support integrated.
Add EDI variables
| FTP_Import_FTP_List_Cmd | Command to use to list files on server. |
| EDI_Import_Local_Dir | Path to local directory. |
| FTP_Export_FTP_List_Cmd | Command to use to list files on server. |
| EDI_Export_Local_Dir | Path to local directory. |
Support added from 06/09/2011
Support added from 26/10/2011
AIX 5.3 install was shrinking files systems fixed 02/11/2011
new method "daemon"
This runs a COBOL program much like the method "program" The program is expected to handle the data transfer its self.
For the method "daemon" the COBOL program runs detached and monitors the system, roadrunner, and EDI flags its self. Only current programs that do this are the IBM WebSphere MQ routines. See Vinh, Maggey, or Issi.
lots of changes to display additional information in ShowImageLibrary ShowRoadtech