HOME Generic Build Support (GBS) - User Manual
The sys.gbs file

Contents

Description

Purpose

The sys.gbs file is located in the GBS_SYS_PATH directory is used to define general settings for generation and auditing.
Before GBS 3.00 this file was named sysbuild.gbs.

General

Additional for this file:

• Lines with no leading white-space (called header-lines) define an item.
• Following lines with leading white-space (called sub-lines) define the parameters for that item.
• Reserved words (keywords) are case sensitive
• The .include directive is not allowed

Definitions

VARIABLE-definition

Purpose:

Allows environment-variables to be set while calling a GBS command on the command-line.
These environment-variables can then be used by the generation/audit scripts.
For each variable a selection of value_names and optionally a value_string can be set
They will be made available with GBS_APP_value_name and optionally GBS_APP_value_name_VALUE

Syntax:

VARIABLE variable_name

DEFAULT = value_name

VALUE = value_name => value_string

Semantics:

variable_name

Preferably in uppercase

DEFAULT

Single Occurrence. Single value, Optional

Specifies the default value_name

If omitted, the first value_name if the following list will be taken as default

VALUE

Multiple occurrence, at least one (or VALUES) must be specified

EXCLUDE-definition

Purpose:

Syntax:

EXCLUDE regular-expression-list

Semantics:

EXCLUDE

May be specified more than once

regular_expression-list

Perl regular-expressions specifying files to be skipped

e.g.

  \.tst$ == all filenames ending with '.tst'

  ^MEM == all filenames starting with 'MEM'

Notes:

Example of a sys.gbs:

#
#   SYS.GBS
#

#
#   ENVIRONMENT VARIABLES
#
VARIABLE PROFILING
    VALUE       = NO  => NO
    VALUE       = YES => YES

VARIABLE COMPILER
    DEFAULT     = GHS
    VALUE       = GHS  => -ghs
    VALUE       = DIAB => -dia

#
#   SRC EXCLUDES
#
EXCLUDE \.mcp$ \.cvs$

##EOF##

Generic Build Support (GBS) - User Manual - The sys.gbs file