Backups, This is important. All scripts that may change or remove files, check for the existance of a backup flag, either global or DATAPATH spcific, when invoked.
All of the standard scripts will abort gracefully if a flag is found on any of these checks. No files shall, under any circumstances, be altered within the file tree of any DATASET, unless the corresponding flags for the DATAPATH, have been checked within the preceding second.
From mid 1999 there is one set of scripts and admin programs that supports the following Operating systems.
The version you are running can be distinguished by the date code displayed on the top left of the opening screen.
Most customers should be running scripts, dated 2001 or 2002.
Backups, This is important. All scripts that may change or remove files, check for the existance of a backup flag, either global or DATAPATH spcific, when invoked.
All of the standard scripts will abort gracefully if a flag is found on any of these checks. No files shall, under any circumstances, be altered within the file tree of any DATASET, unless the corresponding flags for the DATAPATH, have been checked within the preceding second.
Scripts that use this method start with the folloing code fragment.
CallName="$0" # ----- Pickup main roadtech environment ----- Env=$(RTadmin environment 2>/dev/null) if test -z "$Env" then echo "Oops Problem locating config :-" >&2 echo "for $CallName" >&2 exit 2 else RTadmin=$(dirname "$(dirname "$Env")") . "$Env" fi # # ***************************************************************** #
The following tables document the main variables used in the scripts, and the "Exp" column notes which ones are exported for the benifit of called programms.
| Var | Exp | Description |
|---|---|---|
| adm | Y | System admin files {/usr/adm, /var/adm, ... } |
| rmlicence | Y | RMcobol licence |
| rmver | Y | RMcobol version |
| rrhome | Y | Directory containing users home directories {/u, /home, .... } |
| sysname | Y | System name got from uname {AIX, UNIX_System_V, ... } |
| sysrel | Y | uname -r |
| sysver | Y | uname -v |
| tmpdir | Y | Application temporary directory. {/tmp, /var/tmp} |
| Variable | Exp | Purpose | Default |
|---|---|---|---|
| RTadmin | N | Path to Admin scripts. rrinst must select install and copy to correct target for machine. | |
| RTadmin_def | N | Default install directory for RoadTech scripts on current platform | /usr/share/rr85/instbits, /usr/share/Roadtech?, /usr/share/RTadmin? |
| RT_Owner | N | User who owns files | rr85 |
| RT_Group | N | Group who uses files | rm85 |
| RT_Cluster | Y | HACMP Cluster | FALSE |
| RT_CSPOC | N | PATH fo CSPOC wrapper | |
| RR_ResourceGroup | N | roadrunner |
| Variable | Exp | Purpose | Default |
|---|---|---|---|
| CallName | N | Path name under which script was started. | |
| ProgName | N | Actual path name of script. | |
| RR_Dir | Y | Roadrunner install dir | /usr/rr85, /usr/share/rr85, /usr/share/roadrunner? |
| RR_DirDef | N | Default install directory for Roadrunner on current platform. | /usr/rr85, /usr/share/rr85, /usr/share/Roadrunner? |
| rrdir | N | Roadrunner install dir Obsolete | |
| flagdir | Y | Flag directory | { $tmpdir/rr_flag, ... } |
| clonedir | Y | Target directory for clone. | {/rrclone} |
| libdir | Y | Source directory for script libraries | $RTadmin/lib |
| lib | Y | Base library. | $libdir/base.lib |
| LPDEST | N | Default printer | lpdest() |
| LogDir | N | ||
| PidDir | N | ||
| WebDir | N | ||
| DATAPATH | Y | Path used to track dataset between sessions | $(<$HOME/.rrdatapath) |
| RR_Prog3 | N |
Most are initalized via a call to SetDatapathEnv this function is available to any script that has loaded setenv.lib.
Some variables may be adjusted on a set by set basis by the use of the dataset dependent config file. $RR_DataPath/dataset.var
| 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 |
| Variable | Exp | Purpose | Default |
|---|---|---|---|
| RT_Media | N | Display Media menu | TRUE |
| RT_Print | N | Display print menu | TRUE |
| RT_Mail | N | Display Mail Menu | TRUE |
| MENU | N | rr displays menu of datasets | |
| KILL | N | Kill option from backup | |
| REVEAL | N | Un-hide some options | |
| N |
18/02/2003 AIX Ver 4 rel 2
Default Print Queue := postscript
1 Media menu.
2 Print services.
3 Mail menu.
6 hostman's programme menu.
Q Quit.
[ ]
|
They are displayed by the library function menu_header
Additional header info may be displayed, that is relevant in the context of the menu. For example roadrunner menus use the function menu_header_r to display information relevant to roadrunner.
RTedi uses the function menu_header_e to display relevant information at the top of the screen.
When invoked on its own it displays a context sensative menu. the exact options, depend on the user who is running it and what optional modules are installed on the system.
It may alternativly be invoked with an optional paramiter indecating
the
DATAPATH
to use.
rr /usr/share/rr85
One other varient exists, if the variable definision
MENU=TRUE
apears in the file $rrdir/rr.var a menu of the available
datasets will be built using the information from the file
$rrdir/.datapaths.
|
|