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 In BBj 19.21 and later, the following values may also be used: |
0 = All bit levels |
osbit |
Specifies the OS bit level for which the BCI node will be active. |
0 = All bit levels In BBj 19.21 and later, the following values may also be used: |
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"/ >