IBM
Contents Index Previous Next



Batch Mode


Using the Targeting Expert in the batch mode means starting taexbatch instead of sdttaex.

The commands have to be given one after another by hand or in a command file. (Please see an Example of a Batch File.) In this case the Targeting Expert has to be started with taexbatch < commandfile

Note:

If the commands are given in a command file the Targeting Expert should be started with one of the options -yes or -no to answer all upcoming questions automatically. Otherwise the application will probably hang up.

Syntax of Batch Mode Commands

Command Names

You may abbreviate a command name by giving sufficient characters to distinguish it from other command names. A hyphen ('-') is used to separate command names into distinct parts.

Abbreviation of Commands

You may abbreviate any part as long as the command does not become ambiguous.

Hint:

Commands used in command files should not be abbreviated because future implementations may conflict with those abbreviations.

Parameters in Commands

Parameters are separated by one or several spaces. Parameters containing spaces have to be given in quotation marks.

Case Insensitivity in Commands

In command names there is no distinction made between upper and lower case letters.

Some more Detailed Description of Parameter Types

allowed entries function to set contents

AsCpp

Set-Setting-String

CodInclude

Set-Setting-String

FilesToCompile

Add-Setting-String

Include

Set-Setting-String

LibFlag

Set-Setting-String

Options

Set-Setting-String

Options2

Set-Setting-String

Options3

Set-Setting-String

TesterFilesToCompile

Set-Setting-String

Tool

Set-Setting-String

Tool2

Set-Setting-String

Tool3

Set-Setting-String

allowed entries function to set contents

LibrariesToLink

Add-Setting-String

ObjectsToLink

Add-Setting-String

Options

Set-Setting-String

Tool

Set-Setting-String

allowed entries function to set contents

AddFilesToCompile

Add-Setting-String

Depend

Set-Setting-String

Include

Set-Setting-String

Options

Set-Setting-String

Tool

Set-Setting-String

allowed entries function to set contents

Tool

Set-Setting-String

allowed entries function to set contents

AddObjectExtension

Set-Setting-String

CodeGenerator

Set-Setting-String

ExecutableExtension

Set-Setting-String

FileNamePrefix

Set-Setting-String

FullSeparation

Set-Setting-Bool

GenerateASNCoder

Set-Setting-Bool

GenerateEnvFunctions

Set-Setting-Bool

GenerateEnvHeader

Set-Setting-Bool

GenerateIfcChannels

Set-Setting-Bool

GenerateIfcLiterals

Set-Setting-Bool

GenerateIfcOperators

Set-Setting-Bool

GenerateIfcSignals

Set-Setting-Bool

GenerateIfcSynonyms

Set-Setting-Bool

GenerateIfcTypedefs

Set-Setting-Bool

GenerateInstanceInfo

Set-Setting-Bool

GenerateLowerCase

Set-Setting-Bool

GenerateMakefile

Set-Setting-Bool

GenerateSDLCoder

Set-Setting-Bool

GenerateSignalNumber

Set-Setting-Bool

IfcPrefixChannels

Set-Setting-String

IfcPrefixLiterals

Set-Setting-String

IfcPrefixSignals

Set-Setting-String

IfcPrefixSynonyms

Set-Setting-String

IfcPrefixTypes

Set-Setting-String

LibraryDirectory

Set-Setting-String

MakefileGenerator

Set-Setting-String

MakefileName

Set-Setting-String

PreCompile

Set-Setting-String

PreMake

Set-Setting-String

PostLink

Set-Setting-String

ObjectDirectory

Set-Setting-String

ObjectExtension

Set-Setting-String

TestTool

Set-Setting-String

Description of Batch Mode Commands

In this section, the batch mode commands are listed in alphabetical order, along with their parameters and a description.

Add-PR

Parameters:

<pr-filename>

Further PR files can be specified here which should be considered by the SDL to C compiler.

The first PR file has to be given by using Open-PR command.

Add-Setting-String

Parameters:

<class> <entry> <stringvalue>

The list <entry> will be extended for the item <stringvalue>.

Add-UserSection-String

Parameters:

<stringvalue>

The <stringvalue> will be added in the user section of ml_mcf.h (Cmicro), sct_mcf.h (Cadvanced) or extreme_user_cfg.h (Cextreme).

Analyze

Parameters:

<none>

The SDL system will be analyzed.

Append-Setting-String

Parameters:

<class> <entry> <stringvalue>

<stringvalue> will be appended to the current value of <class> <entry>.

Clear-UserSection

Parameters:

<none>

The complete user section of ml_mcf.h (Cmicro), sct_mcf.h (Cadvanced) or extreme_user_cfg.h (Cextreme) will be removed.

Default-Setting

Parameters:

<class> <entry>

The default value of the given <entry> will be restored.

Exit

Parameters:

<none>

The Targeting Expert exits (same as Quit).

Generate-Code

Parameters:

<none>

A code generation for the selected component is done using the SDL to C compiler selected in the associated settings.

Generate-Code-Full

Parameters:

<none>

A full code generation for the selected component is done using the SDL to C compiler selected in the associated settings.

Generate-Makefile

Parameters:

<none>

A makefile will be generated for the selected component. The makefile's name is taken from the associated settings.

Get-Setting

Parameters:

<class> <entry>

The current contents of <entry> will be printed on the screen.

Include

Parameters:

<batch-filename>

All the commands listed in <batch-filename> will be processed.

Help

Parameters:

<none>

A list of all commands with their needed parameters is printed.

Make-All

<none>

For the application or all the nodes and components that are configured (combined or separate configuration) the steps of analysis, code generation, makefile generation and compilation/linkage will be performed.

Make-Clean

Parameters:

<none>

All the object files will be removed.

Make-Selected

Parameters:

<none>

The make tool will be executed using the associated make tool and the associated makefile of the selected component.

Open-PDM

Parameters:

<filename>

The partitioning diagram file <filename> will be loaded.

Open-PR

Parameters:

<filename>

The PR file <filename> will be loaded and internally converted into a partitioning diagram model.

Open-SDT

Parameters:

<filename>

The system file <filename> will be loaded and internally converted into a partitioning diagram model.

Prepend-Setting-String

Parameters:

<class> <entry> <stringvalue>

<stringvalue> will be prepended to the current value of <class> <entry>.

Qualifier

Parameters:

<SDL-qualifier>

The given <SDL-qualifier> will be used for building a part of the SDL system.

Quit

Parameters:

<none>

The Targeting Expert exits (same as Exit).

Replace-Setting-String

Parameters:

<class> <entry> <old-stringvalue> <new-stringvalue>

The string <old-stringvalue> of <entry> will be replaced with <new-stringvalue>.

Save-Settings

Parameters:

<none>

The modified settings of all the available applications, nodes and components will be saved.

Select

Parameters:

[<application-node-component>]

The entry specified by <application-node-component> in the partitioning diagram will be selected. This step has to be executed before you can generate.

One of the commands Open-PDM, Open-PR or Open-SDT has to be executed before.

Set-Compiler

Parameters:

<compilername>

The given <compilername> will be set as the used compiler. The <compilername> must be available in the default settings of the Set-Integration.

The command Set-Integration has to be executed before.

Set-Flag-Bool

Parameters:

<flagname> <boolvalue>

The SDL to C compiler's library flag <flagname> will be set/reset due to the <boolvalue>.

Caution!

There is no check for interdependencies to other flags.

Set-Flag-String

Parameters:

<flagname> <stringvalue>

The SDL to C compiler's library flag <flagname> will be set to the <value>.

Caution!

There is no check for upper and lower limits. You must be aware to set a value that is in the allowed range!

Set-Integration

Parameters:

<integration>

The pre-defined integration settings <integration> will be set.

Note:

To set a Realtime Simulation for example, the <integration> has to be given in quotation marks, i.e.

Set-Integration "Realtime Simulation"

Caution!

In batch mode there is no check if the selected integration fits to the component settings!

Please have a look to Distributed Pre-defined Integration Settings for more information.

The command Select has to be executed before.

Set-Setting-Bool

Parameters:

<class> <entry> <boolvalue>

The boolean <entry> will be set to its new value.

Set-Setting-String

Parameters:

<class> <entry> <stringvalue>

The non-boolean <entry> will get the new content <stringvalue>.

Start-Download

Parameters:

<none>

The download application selected in Download Application will be invoked.

Start-Testtool

Parameters:

<none>

The test application specified in Test Application will be invoked.

system

Parameters:

<systemcommand>

Executes the <systemcommand> on the underlying OS. The following placeholders can be used in <systemcommand> and will be replaced before execution:

placeholder ... will be replaced by...
%s

system directory

%b

target directory (the one given in the Organizer)

%t

sub target directory (the one calculated depending on the selected component and integration)

%e

executable name (inclusive extension)

%i

intermediate directory

Target

Parameters:

<target>

The <target> becomes the SDL system's part to build. The generated files will be placed in a subfolder with <target> as part of the folder name.

Write-Log

Parameters:

<filename>

All the output to stdout and stderr will also be written into the file <filename>.

Example of a Batch File

The following batch file can be used to build a Simulator using the Targeting Expert batch mode.

Example 489 : Simple batch file

Open-SDT access.sdt
select access-node-component
set-integration Simulation
set-Compiler Microsoft
Generate-Code
Generate-Makefile
Make-selected
Exit

Note:

The items application, node and component depend on the partitioning diagram model used.


http://www.ibm.com/rational
Contents Index Previous Next