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.

JBCDEV_BIN

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)
NOTE: It is good practice to set JBCDEV_BIN explicitly rather than relying on the default setting. This is because the value of the HOME environment variable may change (for example after a LOGTO

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
export JBCDEV_BIN

SET JBCDEV_BIN=C:\dev\TESTJBASE\bin

JBCDEV_LIB

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)
NOTE: It is good practice to set JBCDEV_LIB explicitly rather than relying on the default setting. This is because the value of the HOME environment variable may change (for example after a LOGTO).

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
export JBCDEV_LIB

SET JBCDEV_LIB=C:\dev\TESTJBASE\lib

JBCTTYNAME

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
JBCERRFILE

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
export JBCERRFILE

SET JBCERRFILE=C:\jstuff\jbcmessages

 

NOTE: Setting this environment variable allows you to have more than one version of the messages displayed by jBASE. This could be desirable if you want different messages or different behavior when an error is encountered, depending on the user. For example, to prevent a program entering the debugger when an uninitialised variable is encountered, remove the ^WARNING^ string from the ZERO_USED message.
JBCSPOOLERDIR

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

JBC_DESPOOLSLEEP

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
JBC_CRREQ

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

NOTE: When printing to a Printronix printer on UNIX (which converts ‘linefeeds’ to ‘linefeed + carriage return’ but does not append ‘carriage return’ to ‘form feeds’) you should set JBC_CRREQ=two.

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
export JBC_CRREQ

 

SET JBC_CRREQ=3

 

JBCLISTFILE

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
export JBCLISTFILE

SET JBCLISTFILE=C:\globals\SAVEDLISTS

 

JBCSCREEN_WIDTH

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
export JBCSCREEN_WIDTH

 

SET JBCSCREEN_WIDTH=132

JBCPRINTER_DEPTH

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
export JBCPRINTER_DEPTH

SET JBCPRINTER_DEPTH=112

Set before any jBASE program is invoked.

JBCPRINTER_WIDTH

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
export JBCPRINTER_WIDTH

 

set before any jBASE program is invoked.

SET JBCPRINTER_WIDTH=125

 

Copyright © 2020- Temenos Headquarters SA

Published on :
Wednesday, October 12, 2022 6:56:57 PM IST

Feedback
x