image\bbj40.gif Running BBj from the Command Line


When invoking BBj, command line options may be used.

 

bbj {-c<configuration file>} {-d} {-t<terminal alias>} {-u<user id>}
{-FC} {-LF<look and feel>} {-LO} {-LP<local port number>}
{-RH<host name>} {-RP<port number>} {-SC} {-TC}
{-WD<working directory>} program

-c

Name of the configuration file on the remote machine to use.

-d

Invokes BBj in debug mode. In this mode, when BBj drops to console, debugging takes place in the BBj WinConsole.

-t

The alias of a terminal specified in the configuration file. FID(0) will return this alias in the Thin Client program.

-u

Specifies the user account to be used for Data Server and AppServer access.

FC

Runs in Fat Client mode (non-Thin Client)

LF

In BBj 5.0 and higher, this specifies the look and feel the BBj session uses. Valid options are:

default = uses the look and feel of the native operating system; Windows look and feel when running Windows; Mac look and feel running on a Mac, "cross" for cross-platform, etc. For example, bbj –Lfdefault.

cross = uses the default Java look and feel; "ocean" in JVMs 1.5 and higher, and "metal" in JVMs prior to 1.5.

none = do not attempt to set or change the look and feel in any way. This is intended for use with a launcher program such as skinit, which sets the look and feel before BBj is started.

skinlf:theme = use the skinlf.jar look and feel.
You may use a filename or a URL to specify the specific theme. For example, to

  • use a file

  • use a URL

bbj -LFskinlf:themepack.zip

bbj -LFskinlf:http://mydomain.com/themepack.zip

 

vpro5 = emulates the Visual PRO/5 look and feel on all platforms, regardless of operating system.

LO

Loads but does not run the specified program

LP

Specifies the Port Request Server's (PRS) port. The executable connects to the PRS to get the appropriate port to use to connect to the ThinClientProxyServer. By default, the PRS uses port 2008. The PRS's port may be changed using the Enterprise Manager.

RH

Specifies the machine name or IP address of the server on which the ThinClientServer (TCS) or SecureThinClientServer (STCS) if using the -SC argument) resides. The executable connects to the ThinClientProxyServer (TCPS) on the local machine (refer to -LP<local port number>). The TCPS connects to the TCS (or STCS) on the machine specified by this argument using either the default port or the port specified with the option -RP<remote port number>.

RP

Specifies the ThinClientServer's (TCS) port on the remote machine. The executable connects to the ThinClientProxyServer (TCPS) on the local machine (see -LP<local port number>). The TCPS makes the connection to the remote machine (specified with the -RH<host name> argument) using the remote port number. If no remote port number is specified, the default port, 2003, is used. When using the -SC flag, the TCPS connects to the SecureThinClientServer (STCS). The STCS default port is 2103. The ports used by TCS and STCS can be changed using Enterprise Manager.

SC

Specifies a secure connection between the Thin Client and the Thin Client Server

TC

Runs the interpreter in Thin Client mode

WD

Specifies the server directory in which BBj will start

program

Name of the program on the remote machine to run.

Exiting BBj

To exit BBj console mode, enter "RELEASE" or "BYE" to return to the host operating system.

NOTE: Never exit BBj or any BBj application by turning off or rebooting your computer. Any files that are still open may be corrupted by this improper procedure.

Examples

bbj -TC -RHfudd -cAcctConfig.bbx accounting.bbj

bbj -TC –SC -RHfudd -cAcctConfig.bbx -tT23 accounting.bbj

bbj -TC -RHfudd -cAcctConfig.bbx -tT23 accounting.bbj

bbj -TC -RH3045 -cAcctConfig.bbx accounting.bbj

bbj -TC accounting.bbj


In the final example below, the bbj executable connects to the PortRequestServer (PRS) on the local machine using port 3010. The executable gets the appropriate ThinClientProxyServer's (TCPS) port from the PRS. Once connected to the TCPS on the local machine, the TCPS connects to the ThinClientServer using port 4003 on the remote host johnny. This example also shows how to pass arguments in BBj, just as in PRO/5.

 

bbj -LP3010 -RHjohnny -RP4003 -args

 

See Also

BBj Services Overview