BCI Nodes - BBExec

<BBExec> - In BBj 12.00 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 higher, 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 higher, the following values may also be used:

1 32-bit level
2 64-bit level

0 = All bit levels

osname In BBj 24.10 and higher, specifies the OS for which the BCI node will be active. Multiple OS's are comma separated.
Windows
Mac
Linux
AIX
All
portid

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

As of BBj 24.10, the portid attribute has been removed. Use osname instead.

See Platform Availability for possible port IDs.

All port IDs

<Variable> - In BBj 11.00 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>