GBS Logo HOME Generic Build Support (GBS) - User Manual
Customisations (User) Bottom Doc. Button

Contents Bottom Doc. Button Top Document Button Down Section Button Blank

Description
Perl Directory (GBS_PERL_PATH)| gbssetup command| GBS Command Prompt Window (gbscmd.bat / .sh)| Set Window Title (GBS_XTITLE)

Description Bottom Doc. Button Top Document Button Down Section Button Up Section Button

GBS has a few user customisation possibilities.
Most are set by the gbssetup command
Index

Perl Directory (GBS_PERL_PATH) Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Blank

Name:

GBS_PERL_PATH

Purpose:

Define an specific directory to find the Perl executable
To be used when (the wanted) perl is not in the PATH
Specifies the top-directory of the Perl installation (the directory containing 'bin')

Default:

Empty (Find Perl via PATH)

Where:

In Registry (Windows) My Computer → Properties → Advanced → Environment Variables
or ~/.profile (Unix/Linux-ksh) or ~/.bash_profile (Unix/Linux-bash)

Define:

Unix
export GBS_PERL_PATH=your_perl_path
Windows
SET GBS_PERL_PATH=your_perl_path

gbssetup command Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Up Chapter Button

With the gbssetup command you can set/change:

Site-ID

Basic

Purpose:

To identify the location where the user works
It is used in the switch.gbs to cater for different IT infrastructures (e.g. different locations of compilers, network drives, etc)
You will only really need it if people work from different site-locations on the same code.
A good name is an abbreviation of the town or site. Just make sure it is unique for the future.
Keep the name short and in uppercase. Consider using the 3-letter IATA Airport Code of a nearby airport.

Default:

HOME

LogDir

Basic

Purpose:

To define the location of the log files

Defaults:

User's Home directory
Unix
~/GBSLogs
Windows
%MY_DOCUMENTS%\..\GBSLogs

Beeps

General

Purpose:

To switch the 'beep' on the command-line on or off

Default:

ON

Editor

General

Purpose:

Define a text-editor (for gbsedit and gbsmaint 9 ('Owners-file' Maintenance)

Defaults:

Unix
$EDITOR, nedit, (gedit)
Windows
Notepad

Browser

General

Purpose:

Define a HTML Browser (for gbshelp and gbsaudit)

Defaults:

Unix
Mozilla/Netscape
Windows
Default HTML Browser (Internet Explorer)

Viewer

General

Purpose:

Define a text-viewer (for viewing batch log-files)

Defaults:

Unix
nedit -read
Windows
Notepad

Administrator

Special

Purpose:

Define/Remove the current user as Administrator for this System
Administrator privilege is required for all changes to the infrastructure. E.g.: create a new component.
It is just a token privilege. You will be warned every time you try to do a privileged action. You can always override.
This is a safety issue, warning you that you are changing something special for which you probably need permission of the System / Code Architect.

Default:

None

Integrator

Special

Purpose:

Define/Remove the current user as Integrator for this System
Integrator privilege is required for the execution of some special functions ad defined in gbsmaint 6: It is just a token privilege. You will be warned every time you try to do a privileged action. You can always override.
This is a safety issue, warning you that you are doing something irreversible.

Default:

None

GBS Version

Purpose:

Make an other (installed) version of GBS the current GBS version.
GBS will be restarted.

Defaults:

Current

GBS Command Prompt Window (gbscmd.bat / .sh) Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Up Chapter Button

You can customize your GBS Command Prompt DOS-box/xterm by placing shell commands in a private startup file: 'gbscmd.bat / .sh' in your GBS_BASE_PATH directory:
Please note the following:
  1. It is only executed in Interactive sessions.
  2. Do not place any GBS-related items in this file.
  3. Placing any GBS-related items in this file may cause GBS to malfunction.
    If not today: probably in the future.

Set Window Title (GBS_XTITLE) Bottom Doc. Button Top Document Button Down Section Button Up Section Button Down Chapter Button Up Chapter Button

Name:

GBS_XTITLE

Purpose:

Allow GBS to set currency information in the window-title

Default:

Unix
xtitle $1
Windows
TITLE %1%

Where:

Your own scripts

Define:

Unix
export GBS_XTITLE='command to display text in window-title with $1'
e.g.:
export GBS_XTITLE="xlabel \"\$1\""
The $1 will be replaced by the title
Windows
SET GBS_XTITLE='command to display text in window-title with %1%'
The %1% will be replaced by the title