BCI Nodes - BBExec


<BBExec> - In BBj 12.0 and higher, executes a BBj application.


Attribute

Description

Possible Values

Default Value

name

Specifies the name of the BBj application to execute.

BBj program name

none

allowcancel

Specifies if the progress window should allow for user canceling.

true. false

false

appname

Application name for SysWindow settings.

any string

none

appusername

Application user name for SysWindow settings.

any string

none

args

Specifies arguments to the BBj application.

any string

none

classpathname

Classpath name of the CLASSPATH to use when running the BBj application.

valid classpath name

none

configfile

BBx config file.

valid BBx config file

none

failuretext

Specifies the text of the window that is shown if the BBj application could not be run.

any string

"Could not launch BBj application."

failuretitle

Specifies the title of the window that is shown if the BBj application could not be run.

any string

“BBj Application Error"

localport

Specifies the local port.

valid port

none

numretries

Number of execution retries that will be attempted. There is a 30 second wait time before each retry.

valid number

-1 (retry forever)

occurs

Specifies when the BB exec will occur.

installfinish

installfinish

quiet

Runs the BBj interpreter quietly.

true, false

false

remoteport

Specified the remote port.

valid port

none

progresstitle

Specifies the title of the progress window.

any string

"Please wait..."

progresstext

Specifies the text of the progress window.

any string

“Launching BBj Application”

secure

Run the BBj intrerpreter in secure (uses SSL) mode.

true, false

false

showprogress

Specifies if a progress window should be shown when waiting for the BBj application to be executed.

true, false

false

sync

Specifies if BBj application should be run synchronous.

true, false

false

terminal

The terminal specification.

valid terminal string

none

user

OS level user to run the BBj application.

valid OS level user

none

workingdir

Working directory.

valid directory path

none

waittime

Specifies the number of seconds to wait before trying to invoke the BBj interpreter.

valid number

2

Common Attribute

Description

Possible Values

Default Value

bit

Specifies the Java bit level for which the BCI node will be active.

0 = All bit levels
32 = 32-bit level
64 = 64-bit level

In BBj 19.21 and later, the following values may also be used:
1 = 32-bit level
2 = 64-bit level

0 = All bit levels

osbit

Specifies the OS bit level for which the BCI node will be active.

0 = All bit levels
32 = 32-bit level
64 = 64-bit level

In BBj 19.21 and later, the following values may also be used:
1 = 32-bit level
2 = 64-bit level

0 = All bit levels

portid

Specifies the port ID for which the BCI node will be active. Multiple port IDs are comma separated.

See www.basis.cloud/availability for possible port IDs.

All port IDs

<Variable> - In BBj 11.0 and higher, this node creates a variable that can be used instead of string value in the custominstall.xml. The following variables are provided by default:

Variable Name

Variable Value

$BASISInstallDir

BASIS installation directory.

$BASISInstallDrive

BASIS installation drive on Windows resolves to the drive letter and colon (i.e. d:).

$DesktopDir

Desktop directory on Windows.

$InstallDir

Installation directory.

$InstallDrive

Installation drive on Windows resolves to the drive letter and colon (i.e. d:).

$ProgramsDir

Programs directory on Windows.

$UserHome

User's home directory.

$Version

BBj version.

Example

<BBExec name="configur.bbj" configfile="$InstallDir/cfg/config.min" workingdir="$InstallDir/bin" user="bhipple" terminal="T2" args="$InstallDir/cfg/config.bbx" sync="false" showprogress="true" allowcancel="true" progresstitle="Please Wait" progresstext="Running BBj Application" failuretitle="BBj Application Error" failuretext="Please run configuration program manually." numretries="3" occurs="installfinish"/ >

ClosedVersion History

BBj 20.21: added waittime attribute.

BCI Nodes Listing

<BBExec>

<CustomAction>

<Directory>

<Exec>

<Feature>

<File>

<Jar>

<Keep>

<Kill>

<RegEntry>

<Replace>

<Shortcut>

<Suite>

<Suites>

<Variable>