Development Environment Variables
This section explains the configuration of development environment variables that are used for customization, compilation and execution of programs and subroutines in the client environment.
Description
It defines the directory where user executables will be built when programs are CATALOGed.
Values
Valid file path
Default
%HOME%\bin (Windows)
$HOME/bin (UNIX)
The value of JBCDEV_BIN can be overridden with the CATALOG -o option.
Refer also: JBCDEV_LIB, PATH.
Setting
As per normal environment variable, the following settings should be done.
|
UNIX |
Windows |
|---|---|
|
JBCDEV_BIN=/home/TESTJBASE/bin |
SET JBCDEV_BIN=C:\dev\TESTJBASE\bin |
Description
Defines the directory where user shared object libraries will be built when subroutines are CATALOGed.
Values
Valid file path
Default
%HOME%\lib (Windows)
$HOME/lib (UNIX)
The value of JBCDEV_LIB can be overridden with the CATALOG -L option.
Refer also: JBCDEV_BIN, JBCOBJECTLIST.
Setting
As per normal environment variable, the following settings should be done.
|
UNIX |
Windows |
|---|---|
|
JBCDEV_LIB=/home/TESTJBASE/lib |
SET JBCDEV_LIB=C:\dev\TESTJBASE\lib |
Description
This variable defines your UNIX tty name. If this variable is not defined then jBASE must use the UNIX system call ttyname () to locate it. On some systems, this function call is very slow but the use of this variable will greatly improve execution start-up times.
Values
Any character string
Default
None
Setting
As per normal UNIX environment, variable should be setup in the .profile before executing the initial jBASE program.
JBCTTYNAME=Jterm
export JBCTTYNAME
Description
It sets the location of the jBASE error message file
Values
Valid path to a hashed file
Default
$JBCRELEASEDIR/jbcmessages (UNIX)”
%JBCRELEASEDIR%\jbcmessages (Windows)
Setting
The following setting should be done before jBASE is invoked.
|
UNIX |
Windows |
|---|---|
|
JBCERRFILE=/usr/global/jBASEerrors |
SET JBCERRFILE=C:\jstuff\jbcmessages
|
Description
This environment variable defines the directory where the jBASE spooler entries are located.
Values
Valid file path
Default
/usr/jspooler (UNIX)
C:\JJBASE30\jspooler
Setting
As per normal environment variable, the following settings should be done.
|
UNIX |
Windows |
|---|---|
|
setup in the .profile before executing the initial jBASE program JBCSPOOLERDIR=/home/alternative/jspooler |
set before the jSHELL is invoked. If using telnet it should be set before the first executable in REMOTE.cmd. SET JBCSPOOLERDIR=C:\home\alternative\jspooler |
Description
By default, the jBASE despooler processes on Windows check for queued jobs every 30 seconds. This environment variable can be used to decrease or increase that interval. The environment variable is not required on UNIX because the despooler processes are sent a signal when a new job has been generated.
Values
Number of seconds
Default
30
Setting
Windows only: As per normal environment variable it should be set before form queues are started.
SET JBC_DESPOOLSLEEP=12
Description
Controls whether line feeds and form feeds are followed by a carriage return when printing to the spooler.
Values
|
S.No |
Task |
|---|---|
|
0 |
No translation is performed |
|
linefeed -> linefeed (unchanged) formfeed -> formfeed (unchanged) |
|
|
1 |
Specifies that a carriage return is required after each and every line feed when printing to the spooler |
|
linefeed -> linefeed + carriage return formfeed -> formfeed (unchanged) |
|
|
2 |
Specifies that a carriage return is required after each form feed when printing to the spooler. |
|
linefeed -> linefeed (unchanged) formfeed -> formfeed + carriage return |
|
|
3 |
specifies that a carriage return is required after each line feed and form feed when printing to the spooler. |
|
linefeed -> linefeed + carriage return formfeed -> formfeed + carriage return |
Default
zero
When printing binary data to a laser (or similar printer) on Windows you should set JBC_CRREQ=3
In addition, the device definition for the appropriate form queue should specify the -l and -n options to ‘jlp’ e.g. fqfred PROG jlp -d \\printername -l -n
Alternatively, use the default Windows printer e.g. STANDARD NT
Setting
As per normal environment variable, it must be setup before connecting to jBASE.
|
UNIX |
Windows |
|---|---|
|
JBC_CRREQ=2
|
SET JBC_CRREQ=3
|
Description
This environment variable specifies the file where stored lists are kept.
Values
Any valid path to a directory or hashed file
Default
If not set, jBASE attempts to store lists in POINTER-FILE. If it can’t be opened, then it stores lists in jBASEWORK.
Setting
As per normal environment variable, the following settings should be done. See List Storage.
|
UNIX |
Windows |
|---|---|
|
JBCLISTFILE=/home/jim/mylists |
SET JBCLISTFILE=C:\globals\SAVEDLISTS
|
Description
Specifies the page width for paged terminal output, and overrides the value specified by the TERM type.
Values
Decimal number
Default
None
Setting
As per normal environment variable, it should be setup before the jSHELL is invoked.
|
UNIX |
Windows |
|---|---|
|
JBCSCREEN_WIDTH=132
|
SET JBCSCREEN_WIDTH=132 |
Description
This environment variable specifies the page depth for paged spooler output, and overrides the value specified by the TERM type.
Values
Decimal number
Default
None
Setting
As per normal environment variable, the following settings should be done.
|
UNIX |
Windows |
|---|---|
|
Setup in the .profile before executing the initial jBASE program JBCPRINTER_DEPTH=112 |
SET JBCPRINTER_DEPTH=112 Set before any jBASE program is invoked. |
Description
Specifies the page width for paged spooler output, and overrides the value specified by the TERM type.
Values
Decimal number
Default
None
Setting
As per normal environment variable, the following settings should be done.
|
UNIX |
Windows |
|---|---|
|
setup in the. profile before the jbcconnect command. JBCPRINTER_WIDTH=125
|
set before any jBASE program is invoked. SET JBCPRINTER_WIDTH=125
|
In this topic