jRCS Environment Variables

The table shows how jRCS interprets environment variables.

Variable Purpose
PATH The system path. Under Windows this variable must include the name of the jBASE bin directory for jRCS to properly function. If this not done, jRCS will not be able to load the jBASE libraries and will not start (Windows only).
LD_LIBRARY_PATH On LINUX, the system library path is extended by this variable. The path must include the name of the jbase lib directory. (LINUX only)
LIBPATH This variable is used by AIX in much the same way as LINUX uses LD_LIBRARY_PATH (AIX only)
JBCBACKGROUND If this variable is set to anything but 0, it forces jRCS into the quiet mode regardless of whether the -q flag was specified on the command line.

Needless to say, other jBASE variables can be set in the global system profile if a system-wide setting is desired. These variables will not be modified by jRCS, with exception of JBCPORTNO. On logon, jRCS sets the variable TERM to the term type of the user logging on, and REMOTEHOST to the IP address of the incoming connection.

Additional variables can be configured via the jRCS profile.

jRCS Profile

Although jRCS retains most environment variables it obtains from the system profile and loads the user's profile under Windows during authentication, it may be desirable for some users to execute a batch file setting additional environment variables on a per-user basis.

jRCS provides this functionality through the use of jRCS profiles. The profiles are stored in file jrcsrc.cmd under Windows and .jrcsrc under Unix. The profiles must be located in the user's home directory to be loaded on start-up.

The profiles follow the format of standard batch files under Windows or shell scripts under UNIX, with the following exceptions:

  • Executable programs are not executed and are ignored

  • The CALL command under Windows connects the source from another file if found in the profile

  • The . or source command under UNIX connects the source from another file if found in the UNIX profile

Limited expansion is performed on variables being set, although the full set of expansion capabilities is not provided under UNIX

In essence, jRCS profiles are similar to remote.cmd file used by jBASE telnetd under Windows. For example, if the system administrator wants to set the user's JEDI_FILEPATH variable during logon, he or she would create a jrcsrc.cmd file under Windows and place it in the user's home directory. The file would have the following content:

rem This is a sample jrcsrc.cmd demonstrating the

rem setting of JEDI_FILEPATH

set JEDI_FILEPATH=%HOME%\FILES

The example above sets JEDI_FILEPATH to subdirectory FILES of the user's home directory.

To achieve the same result under UNIX, the administrator would create the file .jrcsrc in the user's home directory, with the following content:

# This is a sample .jrcsrc demonstrating the

# setting of JEDI_FILEPATH

export JEDI_FILEPATH=$HOME/files

 

jBASE Remote Connectivity Service