The Road Tech Administrative Tollkit makes extensive use of environment variables.

• Environment 18/07/2009

System details

These variables hold details relating to the local system. Set when setenv.lib scans the host system to identify the platform.

User

Set by the system for a user. Valid for AIX and Linux.

Roadtech administrative scripts

There are a number of variables that affect the behaviour of the administrative scripts. These are initialized by setenv.lib when it scans the system.

RTadmin is set to the PATH of the base directory containing the administrative programs. Most paths used to locate other items are found relative to this.

Most of the current values are displayed as part of the "Show configuration" option on the System Menu.

If it does not exist as you are upgrading from a pre 2003 version, and the option file does not exist. A sample opton file ${RTadmin}/rt.var will be created, when the check configuration option is run from the new scripts.

# Roadtech variable initialization
# RT_Owner=${RT_Owner}
# RT_Group=${RT_Group}
# RT_EdiGroup=${RT_EdiGroup}

Additional options may be needed if subsystems have been installed at unusual locations.

Roadrunner General

If it does not exist as you are upgrading from a pre 2003 version, and the option file does not exist a sample opton file ${RR_Dir}/rr.var will be created. When the check configuration option is run from the new scripts.

# Roadrunner variable initialization 

There is provision for an additional per user option file $HOME/bin/rr.var, as far as I am aware this has only been used on development servers.

Thre is no template for this file.

Roadrunner Dataset

Most are initalized via a call to SetDatapathEnv this function is available to any script, that has loaded setenv.lib.

Variable	Exp	Purpose	Default
RR_DataPath	N	Path of current dataset	$(<$HOME/.rrdatapath)
RR_DataSet	N	Name of curent dataset	read from $rrdir/.datapaths
RR_Prog1	N	Main program directory	$RR_DataPath/cobs
RR_Prog2	N	Update program directory	$RR_DataPath/newcobs
RR_ProgDat	N	Program related Data SCREENS, MENUS, etc	$RR_DataPath/instbits
dsflag	Y	Flag name for current dataset	$flagdir/$(echo ${RR_DataPath}|tr -A '/' '_')
RUNPATH	Y	Search path to programs and program data.	${RR_ProgDat}:${RR_Prog3}:${RR_Prog2}:${RR_Prog1}:/usr/rmcobol
RM_Config	N	RM_Cobol configuration file	-c $RR_DataPath/terminfo.cfg
RM_Report	N	RM_Cobol printer configuration	-x $RR_DataPath/report.cfg
	N
	N

Some variables may be adjusted on a set by set basis, by the use of the dataset dependent config file. $RR_DataPath/dataset.var

This file is created during the initial install, or when the menus are used to initalize a new dataset.

Only applicable to EDI routines using edi.lib.

When called the functions edi_runcobol_import and edi_runcobol_export provided in edi.lib, invoke the configured COBOL progragram, passing it a number of arguments. Thease become part of the Linkage Section, and mimmic the environment set when a user logs in to roadrunner.

runcobol ${EDI_Import_Program} "${RM_Config}" ${RM_Report} -a "$rrcompany ${EDI_User} ${EDI_Uid} ${EDI_ErrorLevel} ${EDI_DisplayFlag} ${EDI_ParamiterMode} ${EDI_Platform} ${EDI_Import_Pmap} ${EDI_Import_SubProgram}" 

runcobol ${EDI_Export_Program} "${RM_Config}" ${RM_Report} -a "$rrcompany ${EDI_User} ${EDI_Uid} ${EDI_ErrorLevel} ${EDI_DisplayFlag} ${EDI_ParamiterMode} ${EDI_Platform} ${EDI_Export_Pmap} ${EDI_Export_SubProgram}"

Other EDI variables exist that are used in processing before invoking runcobol. Some of the EDI variables are exported, and made availble in the UNIX environment for the COBOL runtime, or any sub programs it calls.

General EDI variables

EDI Import variables

Relate to calls and routines that Import data to the local COBOL database.

EDI Export variables

Relate to calls and routines that Export data to the local COBOL database.