IBM
Contents Index Previous Next



Common Preferences


These preferences apply to tools that are available in all SDL Suite and TTCN Suite tools.

Generic Preferences

Prefix: SDT*

Generic preferences may be used by tools that have not defined any specialization for these preferences.

Preference Parameter Default Affects

AllowSpaceInFileNames

off

Whether SDL Suite or TTCN Suite allows the user to add files with names containing spaces. The default setting of not allowing file names with spaces is set to ensure maximum compatibility with other tools that may be connected to SDL Suite and TTCN Suite. Unless you are using SDL Suite and TTCN Suite stand-alone, you should carefully consider if your environment can correctly support spaces in file names before enabling this feature.

CaseSensitive

off

Whether the SDL language should be case sensitive or not. It will effect the syntax check in the SDL Editor and the work of the Analyzer. The default setting is as SDL96, i.e. the language is not case sensitive. Also used as the default value for the Analyzer option Case sensitive SDL in the Organizer.

CMIntegration

No integration

Specifies if SDL Suite and TTCN Suite are used together with an external configuration management tool. When set to ClearCase, the name of the view is shown in the Organizer window title.

Drives

""

The default contents of the The Drives Section in the system file for a newly created system.

EmacsCommand

"emacs"

The command used to start the Emacs text editor.

UNIX only, see Note:.

FileNameCompletion

on

Whether file name completion is invoked by a completion character.

FileNameCompletionChar

""

The character that invokes file name completion.

FunctionFrequencyLogFile

""

File to save tool usage statistics on; see FunctionFrequencyLogging. In addition, tool usage statistics is also saved to a file sdtfreq.log in the installation directory.

FunctionFrequencyLogging

on

Whether to collect statistics on the usage of menu commands, quick buttons and accelerators. The tools that support collecting statistics are:

  • the Organizer
  • the SDL Editor
  • the OM Editor

ISpellCommand

"type %1 | aspell -w "_" -a > %2" on Windows and "cat %1 | aspell -w "_" -a > %2" on UNIX

Template for the command used to communicate with the aspell spelling checker. If ispell is used you can use the command "type %1 | ispell -w "_" -f %2 -a". For UNIX use cat instead of type.

LicenseTimeout

0

The time interval (in hours) an interactive SDL Suite and TTCN Suite user is allowed to remain idle before licenses are automatically released.

Setting this value to 0 disables the automatic release of licenses.

PrintFontFamily

"Times"

The font face to use when printing text.

RelativeSDTREF

off

If file names in SDT references should be expressed as relative to source directory or not.

Scale

100 (%)

The scale to use when displaying on screen.

ScreenFontFamily

"Helvetica"

The font face to use when displaying text on screen.

SearchUnderscoreAware

on

Decides if the search operation should find "a_ b" when searching for "ab" in SDL diagrams and MSCs.

Sound

on

The emission of an alert sound (beep) when performing an illegal operation.

StartInformationServer

on

If an Information Server should be allowed to start or not.

TextEditor

Telelogic

The text editor to use when editing text documents.

UseLowerCaseInFileNames

off

If turned on, saved diagram names are converted to lower case to provide UNIX/DOS file name compatibility. Activating this preference can lead to problems when accessing existing files with names containing non-lowercase letters.

WordCommand

"Winword.exe"

The command used to start Microsoft Word.

Windows only, see Note:.

TextWindowFontFamily

Courier New

The font used in text windows.

Windows only, see Note:.

TextWindowFontHeigth

10

The size of the font used in text windows.

Windows only, see Note:.

UserInterfaceFontFamily

MS Sans Serif

The font used in the user interface.

Windows only, see Note:.

UserInterfaceFontHeight

9

The size of the font used in the user interface.

Windows only, see Note:.

SimulatorExplorerFontFamily

Arial

The font used in the SDL Simulator and SDL Explorer user interface.

Windows only, see Note:

SimulatorExplorerFontHeight

11

The size of the font used in the SDL Simulator and SDL Explorer user interface.

Windows only, see Note:.


TabSize

2

Number of spaces inserted when the TAB key is pressed in a text area. Windows only.

Organizer Preferences

Organizer Pack Preferences

Prefix: Organizer*Pack. For more information about the pack operation, see Pack Archive.

Preference Parameter Default Affects

TarCommand

tar

The command used by the pack archive operation to access the tar utility. See Additional required tools and utilities.

GzipCommand

gzip

The command used by the pack archive operation to access the gzip utility. See Additional required tools and utilities.

ArchiveSdt

on

Decides if a system file adapted for the archive contents should be included.

OriginalSdt

off

Decides if the original system file should be included.

Packages

on

Decides if SDL package diagrams should be included.

OtherSDL

on

Decides if other SDL diagrams (system, block, process...) should be included.

MSC

on

Decides if MSC diagrams (MSC, HMSC) should be included.

UML

on

Decides if UML diagrams (object model, state chart, deployment) should be included.

Chapter

on

Decides if chapters should be included.

Generic

off

Decides if files attached to the Organizer generic symbol should be included.

Tau

off

Decides if files attached to the Organizer Tau documents symbol should be included.

Rhapsody

off

Decides if files attached to the Organizer Rhapsody documents symbol should be included.

SimScript

off

Decides if simulator scripts (*.cui and *.com files attached to a plain text symbol) should be included.

OtherText

on

Decides if other text documents (not simulator scripts) should be included.

Scu

off

Decides if configuration unit files (*.scu) should be included.

Index

on

Decides if index files (*.xrf) should be included.

Header

on

Decides if header and footer files should be included.

Extensions

lst

Files in source or target directory with the extensions specified here (space separated) are included.

Other Organizer Preferences

Prefix: Organizer*

Preference Parameter Default Affects

AbsolutePath

off

If file names should be specified with an absolute directory path or not. See Set Directories.

AllowImplicitTypeConv

off

The default value for the Analyzer option Allow implicit type conversion.

AllPreferences

off

If all preferences or if only the "diff" between current Organizer options and Organizer start-up options should be written as options in the system file. See Options in the System File.

Areas

"Analysis Model,Used Files,SDL System Structure,TTCN Test Specification,Other Documents"

The names of the chapters in the Organizer's drawing area, separated by commas. The default is known as the basic Organizer view.

ASN1KeywordFileName

""

The default value for the Analyzer option ASN.1 keyword substitution file.

ASN1Suffix

".asn"

File name extension used to recognize ASN.1 files.

AutoCMUpdate

off

If this preference is on, then a configuration update operation will be done each time a system file is loaded in the Organizer. The system file will be updated with *.scu file information.

AutoSaveBefore

off

If modified diagrams should be saved on file without user confirmation when selecting any of the commands Analyze, Make, SDL Overview and Convert to PR/MP.

BuildScript

".bld"

File name extension used for build script files.

Capitalisation

AsDefined

The default value for the code generation option Capitalization.

ChangeBars

off

If change bars should be created when SDL diagrams are edited.

ClearLog

on

Clear text in Organizer Log before running the Analyzer.

CoderBufferInSDL

"None"

The default value for the encoding used for ASN.1 Buffer in SDL (see ASN.1 encode/decode parameter).

CompileAndLink

on

The default value for the code generation option Compile & link.

DefaultCompiler

On UNIX:

gcc

On Windows:

Microsoft

The default compiler to be used.

DefaultSimulator

"SCTADEBCOM"

The default value for the compile and link option Standard kernel when generating a simulator.

DefaultExplorer

"SCTAVALIDATOR"

The default value for the link option Standard kernel when generating an SDL Explorer.

EchoAnalyzerCommands

off

The default value for the Analyzer option Echo Analyzer commands.

ErrorLimit

30

The default value of the Analyze parameter Error limit.

ExpandPR

off

The value of the Convert to PR option Expand included PR files.

ExpressionLimit

0

The value of the Analyze parameter Log expressions deeper than.

FileNamePrefix

""

The default value for the code generation option File name prefix.

FilterCommand

""

Filter command to invoke before Analyzer stages.

GenerateASN1Coder

off

The default value for the code generation option Generate ASN.1 coder.

GenerateCode

on

The default value for the code generation option Analyze & generate code.

GenerateEnvFunctions

off

The default value for the code generation option Generate environment functions.

GenerateEnvHeader

off

The default value for the code generation option Generate environment header file.

GeneratePrefixedNames

off

The default value for the code generator option Generate prefixed names in ifc file.

Note: This preference is not recognized by Targeting Expert.

GenerateSDLCoder

off

The default value for the code generation option Generate SDL coder.

GenerateSignalNumbers

off

The default value for the code generation option Generate signal number file.

GenericCommand

On UNIX:

".txt "ls %f""

In Windows:

".txt "notepad %f""

A list of file extensions and the corresponding command to be performed when editing a generic document. See Generic Document.

If used on Windows with full path some extra escape characters must be inserted. As an example to use Microsoft Word as an application for documents with the .doc extension the preference must be set to
" .doc "\"C:\\Program Files\\
Microsoft Office\\Office10\\WinWord.exe\" %f" "


Note that when specifying paths the path delimiter must be entered twice, also if the path contains spaces the path must be enclosed by the \" characters. You can use a list of different file extensions and applications. An example is
" .txt "notepad %f"
.fm "c:\\frame\\frame.exe %f" .doc "\"c:\\path with space\\
ww.exe\" %f" ".

HeaderFileSuffix

".h"

File name extension used to recognize C/C++ header files.

IncludeSdtRef

on

Include SDT References when generating code from SDL.

IDLSuffix

UNIX only:

.idl

File suffix used for IDL files.

IgnoreHidden

on

Ignore hidden symbols during analyze.

IncludeOptionalFields

off

The default value for the Analyze option Include optional fields in make operator.

Kernel

"SCTADEBCOM"

The default value for the compile and link option Standard kernel.

LicenseInfo

on

If this preference is on, when failing to get a license during start-up, then information about license holders and number of available licenses is presented in the command line window.

LogFilter


What Analyzer messages are shown in the log window.

LogNavigationLevel

Error

The navigation between messages in the log window.

MacroExpansion

off

The default value for the Analyze option Macro expansion.

MakefileMode

Generate

The default value for which option to select from the compile and link options

MissingAnswerValuesControl

on

The default value for the Analyze option Check missing answer values

MissingElseControl

on

The default value for the Analyze option Check missing else answers

ParameterMismatchControl

on

The default value for the Analyze option Check parameter mismatch

ExternalTypeFreeControl

on

The default value for the Analyze option External types should call GenericFree

MoveWindow

off

The size and position of the Organizer window when a system file is opened. That is, if the size and position will be the same as when that system file was last saved.

OptionalParamControl

on

The default value for the Analyze option Check optional parameters.

OutputControl

on

The default value for the Analyze option Check output semantics.

PathLineLength

0

How many characters that a file or directory may be, before being split into several lines in the Organizer window. 0 = no limit.

PrefixType

Full

The default value for the code generation option Prefix.

QBAddExisting

Hide

The presence of the Add Existing quick button.

QBAddNew

Space & Show

The presence of the Add New quick button.

QBAnalyze

Space & Show

The presence of the Analyze quick button.

QBGenerateSim

Space & Show

The presence of the Simulate quick button.

QBGenerateVal

Show

The presence of the Explore quick button.

QBGenerateView

Show

The presence of the Generate SDL Overview quick button.

QBHelp

Space & Show

The presence of the Help quick button.

QBLog

Space & Show

The presence of the Organizer Log quick button.

QBLogAnalyze

Space & Show

The presence of the Organizer Log Analyze quick button.

QBLogClear

Show

The presence of the Organizer Log Clear Log quick button.

QBLogClose

Space & Show

The presence of the Organizer Log Close quick button.

QBLogErrorHelp

Show

The presence of the Organizer Log Help on Error quick button.

QBLogHelp

Space & Show

The presence of the Organizer Log Help quick button.

QBLogMoveDown

Space & Show

The presence of the Organizer Move Down quick button.

QBLogMoveUp

Show

The presence of the Organizer Move Up quick button.

QBLogSave

Show

The presence of the Organizer Log Save quick button.

QBLogShowError

Space & Show

The presence of the Organizer Log Show Error quick button.

QBLogShowOrganizer

Space & Show

The presence of the Organizer Log Show Organizer quick button.

QBMake

Show

The presence of the Make quick button.

QBMoveDown

Show

The presence of the Move Down quick button.

QBMoveUp

Show

The presence of the Move Up quick button.

QBNew

Hide

The presence of the New quick button.

QBOpen

Show

The presence of the Open quick button.

QBPrint

Space & Show

The presence of the Print quick button.

QBSave

Show

The presence of the Save quick button.

QBSearch

Space & Show

The presence of the Search quick button.

QBTogglePages

Show

The presence of the Show Pages quick button.

QBXref

Show

The presence of the Generate Cross References quick button.

QBZoomIn

Show

The presence of the Increase Scale quick button.

QBZoomOut

Space & Show

The presence of the Decrease Scale quick button.

ReferenceControl

on

The default value for Analyze option Check references.

SDLPRFileSuffix

.pr

File suffix used for SDL PR files.

SemanticControl

on

The default value for Analyze option Semantic analysis.

Separation

No

The default value for the code generation option Separation.

ShowAddExisting

on

If an existing document should be opened in an editor when added.

ShowDashed

on

The default value for the view option Dashed diagrams.

ShowDependencies

on

The default value for the view option Dependency symbols.

ShowDirectories

off

The default value for the view option File directories.

ShowFileName

on

The default value for the view option File names.

ShowFooter

off

The default value for the view option Footer file.

ShowGroups

on

The default value for the view option CM Groups.

ShowHeader

off

The default value for the view option Header file.

ShowInstances

on

The default value for the view option Instance diagrams.

ShowLinkFile

off

The default value for the view option Link file.

ShowLinks

on

The default value for the view option Association symbols.

ShowLogLevel

Warning

Under which circumstances the Organizer Log Window should be raised automatically. This preference is also used by Targeting Expert to avoid the popup message when an Analyzer warning or error is found, see Configure how to Make the Component.

ShowLongMenus

on

The default value for the view options Long / Short.

ShowPages

off

The default value for the view option Page symbols.

ShowPermissions

on

The default value for the view option File access permissions.

ShowSeparators

on

The default value for the view option Separator symbols.

ShowSource

on

The default value for the view option Source directory.

ShowSystemFile

on

The default value for the view option System file.

ShowTarget

off

The default value for the view option Target directory.

ShowTypeName

off

The default value for the view option Type names.

ShowVirtuality

on

The default value for the view option Virtuality.

SourceDirectory

""

The default Source directory when creating a new system.

StandardKernel

on

The default value for the compile and link option Standard kernel.

Statusbar

on

The default value for the view option Status bar.

SuppressLevel

5

The number of issued identical Organizer messages before they are suppressed in the Organizer Log window.

SyntaxControl

on

The default value for Analyze option Syntactic analysis.

TargetDirectory

""

The default Target directory when creating a new system.

TargetLanguage

Cbasic

The default value for the code generation option Code generator.

TerminateAnalyzer

off

The default value for the analysis option Terminate Analyzer when done.

Toolbar

on

The default value for the view option Tool bar.

TrailingParamControl

on

The default value for the Analyze option Check trailing parameters.

TreeRepresentation

List

The default value for the view options Indented list / Vertical tree.

UpperCase

off

The default value of the Convert to PR option Write reserved words in (off means lower case).

UsageControl

on

The default value for Analyze option Check unused definitions.

UserKernel

""

The default value for the compile and link option Use kernel in directory.

UserMakefile

""

The default value for the compile and link option Use makefile.

UserTemplate

""

The default value for the compile and link option Generate makefile and use template.

WelcomeWindow

on

If a Welcome window should be displayed at start-up of the Organizer.

WordSuffix

".doc"

File name extension used to recognize Microsoft Word files.

Windows only, see Note:.

XCodeGenerator

"X"

The name of the code generator that appears last in the option menu Code generator in the Analyze and generate code options.

UNIX only, see Note:.

XRef

on

The default value for Analyze option Generate a cross reference file.

Help Viewer Preferences

Prefix: Help*

Preference Parameter Default Affects

HelpDirectory

""

What help root directory to use for on-line help files. Useful if the on-line help files is available on a network server.

See Configuring the Help Environment for more information.

HelpViewer

Firefox

The choice of help viewer. "Default Web Browser" (Firefox, Netscape or Internet Explorer) is the default choice on Windows.

FirefoxCommand

"firefox"

What command the tools use when starting the help viewer when the preference parameter HelpViewer is specified as Firefox.

NetscapeCommand

"netscape"

What command the tools use when starting the help viewer when the preference parameter HelpViewer is specified as Netscape.

InternetExplorerCommand

"iexplorer"

What command the tools use when starting the help viewer when the preference parameter HelpViewer is specified as Internet Explorer. This is useful on the UNIX platform when the Internet Explorer is not available via your PATH variable.

Preference Manager Preferences

Prefix: Preference*

Preference Parameter Default Affects

Statusbar

on

The presence of a status bar in the window.

Toolbar

on

The presence of a tool bar in the window.

Print Preferences

Prefix: Print*

Preference Parameter Default Affects

BackwardReferences

on

Print backward paper page references in diagrams.

BlackAndWhite

off

The color used when printing symbols and lines.

DateType

ISO

The date format in printouts.

DestinationFormat

PSFile

The default Format option in the Print dialog.

FooterFile

off

The default value for the option Footer file in the Print dialog.

ForwardReferences

on

Print forward paper page references in diagrams.

Frame*PaperFormat

USLetter

The default value for the paper format used when printing to FrameMaker, Interleaf or EPS.

Frame*UserDefinedWidth

210

The default value for the paper width when the Frame*PaperFormat preference is set to UserDefined.

Frame*UserDefinedHeight

297

The default value for the paper height when the Frame*PaperFormat preference is set to UserDefined.

Frame*MarginUpper

25

The default value for the upper margin when printing to FrameMaker, Interleaf or EPS.

Frame*MarginLower

35

The default value for the lower margin when printing to FrameMaker, Interleaf or EPS

Frame*MarginLeft

25

The default value for the left margin when printing to FrameMaker, Interleaf or EPS

Frame*MarginRight

27

The default value for the right margin when printing to FrameMaker, Interleaf or EPS

FrameMakerCommand

"maker"

The default Execute command in the Print dialog when Format is specified as Import into FrameMaker.

UNIX only, see Note:.

HeaderFile

""

The default value for the option Header file in the Print dialog.

HeaderTextHeight

12 (pt)

The size of the font face used in headers and footers.

Landscape

off

The default value for the option Orientation in the Print dialog (off means landscape).

MarginLeft

10 (mm)

The default value for the parameter Left margin in the Print Margins dialog.

MarginLower

25 (mm)

The default value for the parameter Lower margin in the Print Margins dialog.

MaxPageReferences

20

Max number of page references at one place.

MarginRight

10 (mm)

The default value for the parameter Right margin in the Print Margins dialog.

MarginUpper

42 (mm)

The default value for the parameter Upper margin in the Print Margins dialog.

MaxTextLineLength

80

How long a line in a text file can be before it is divided/wrapped, resulting in several lines in the printout. A value of zero means no wrapping. Lines are usually divided at word boundaries.

MinimumLineWidth

3 (1/10 pt)

The minimum thickness applied on lines in the printout.

OnlyChaptersInTOC

off

If only chapter symbols, or chapter symbols and diagrams and documents will be visible in the table of contents.

OrganizerView

on

The default value for the option Organizer View in the Organizer Print dialog.

PageMarkers

off

The default value for the option Page markers in the Print dialog.

PaperFormat

A4

The default value for the option Paper format in the Print dialog.

The preference variable Print*PaperFormat will be set to USLetter by default during installation if the current local time is within GMT - 05:00 and GMT - 09:00. (English version only)

This is done by setting the preference variable Print*PaperFormat within the file sdt.ini (Windows) or .sdtpref (UNIX) located in .../locale/english/sdt. To change this to default value A4, remove the file or use the Preference manager.

Poster

off

Print header (footer) for each logical page instead of for each physical page.

PrintChapter

on

Print text associated with chapter symbols.

PrintCollapsed

on

If collapsed texts from text, comment and text extension symbols are printed in full on a separate page or not.

PrinterCommand

"lpr -h -r"

(In Windows, the lpr command is available in the distribution.)

The default Execute command in the Print dialog when Format is specified as One PostScript File.

RemoveTempFiles

on

If temporary files should be removed after printing is done.

Scale

100 (%)

The default value for the parameter Scale in the Print dialog.

TableOfContents

off

The default value for the option Table of Contents in the Organizer Print dialog.

TextHeight

10 (mm)

The font size used when printing expanded text symbols.

ToCShowPages

off

The presence of page numbers in generated table of contents.

UserDefinedHeight

297 (mm)

The default value for the parameter User paper height in the Print Margins dialog.

UserDefinedWidth

210 (mm)

The default value for the parameter User paper width in the Print Margins dialog.

Word*ImageFormat

Normal.dot

The value for the Image format (Windows Only) used when printing to Word. When using Normal.dot, the image size will be calculated from the available print area in a new created Word document.

Word*UserDefinedHeight

247 (mm)

The default value for the image height parameter in the Size dialog using the User Defined size option.

Word*UserDefinedWidth

160 (mm)

The default value for the image height parameter in the Size dialog using the User Defined size option.

Text Editor Preferences

Prefix: TE*

Preference Parameter Default Affects

AlwaysNewWindow

off

If a new window should be opened or not when opening a text document.

PrintFontFamily

"Courier"

The font face used when printing text.

ShowLinks

on

If endpoints and links should be shown.

StateMatrixShowSelected

on

Decides if processes specified with StateMatrixFilter should be hidden or shown.

StateMatrixSortSignals

on

If signals in state matrices should be sorted.

StateMatrixSortStates

on

If states in state matrices should be sorted.

StateMatrixCalls

off

If a state matrix with procedure call transition information should be shown or not.

StateMatrixFilter

""

Which processes that state matrices will be generated for.

StateMatrixNextstates

on

If a state matrix with nextstate transition information should be shown or not.

StateMatrixOutputs

off

If a state matrix with output transition information should be shown or not.

StateMatrixPageNumbers

on

If a state matrix with page numbers as transition information should be shown or not.

Statusbar

on

The presence of a status bar in the window.

Toolbar

on

The presence of a tool bar in the window.

TextTemplateDirectory

""

Directory for common text file templates.


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