BCI Nodes - BBExec

Description

<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" />

Version History

BBj 20.21: added waittime attribute.

BCI Nodes Listing