Environment variables and resources overview

This table shows the environment variables you can use in the LN environment and, if available, the corresponding resources.

Variable Resource Description
AUDITLOG n/a Used to enable printing of various types of audit information. The variable must have an octal value, such as 0001, 002, 0004, and 0010.
  • Used by: Audit server
  • Configuration: Command field in Infor BW configuration, or environment of server
ATTACHMENTS_IMPL n/a Through the Object Data Management (ODM) and Enterprise Content Management (ECM) applications, attachments can be linked to records.

If both applications are present, this variable is used to indicate which application should be used to handle attachments.

Possible values: "ECM" or "ODM".

BAANLOGIN_PORT n/a The port number for remote login. Only use this variable if the port number differs from the default. This variable is usually specified in remote user files.
  • Used by: fs binary for contacting the LN server
  • Configuration: Enterprise Server Service Manager or environment
BAANLOGIN_PROTOCOL n/a The login protocol for remote login. This variable is usually specified in remote user files.
  • Used by: fs binary for contacting the LN server
  • Configuration: Enterprise Server Service Manager or environment
BAAN_WIN_TITLE n/a Creates a string that contains the title for the window, depending on the formatting string set by environment variable BAAN_WIN_TITLE. These formatting variables are available with BAAN_WIN_TITLE:
  • %h: Hostname
  • %c: Company number
  • %C: Company description
  • %f: Name of current filter
  • %s: Session code
  • %S: Session description
  • %I: Name of current index
  • %u: Name of the user
  • %p: Package combination
  • %o: Window type
  • %d: No debug

Command line example:

-set BAAN_WIN_TITLE="%h: %s : %S< [%c]><(filter: %f)>"

If you run the ttadv2500m000 session in company 000 on host Saturn with filter Tools, this results in this window title:

Saturn: ttadv2500m000: Sessions [000] (filter: Tools)

You can also remove the format variable and surrounding string if the value is considered empty. To suppress showing empty variables and the surrounding substring place the text between '<' and '>'. For example:

<filter: %f>

If no filter is active for a session, the title does not contain any filter information. If a filter is active for a session, the title contains the string: filter: "name of the filter".

  • Used by: LN UI, Web UI and Infor BW
  • Configuration: LN UI, Web UI user profile or Command field in Infor BW configuration
BAAN_SCM_GRP n/a The scm group, which is used in an .fd file on development systems.
  • Used by: Bshell
  • Configuration: Command field in Infor BW configuration

For details on SCM, see Infor Enterprise Server Administration Guide.

BAANHOME n/a Location of the shared binaries for different LN environments.

For example, ASM and older versions of SLM are installed in this directory.

  • Used by: Bshell
  • Configuration: bse_vars or Enterprise Server Service Manager (Windows)
BDBRECONFIG_PARALLEL db_resource Determines the number of parallel processes started by bdbreconfig to reconfigure tables.
  • Used by: bdbreconfig
  • Configuration: bse_vars or Enterprise Server Service Manager (Windows)
BDBVALIDATE_PARALLEL db_resource Determines the number of parallel processes started by bdbvalidate to validate the contents of database tables.
  • Used by: bdbvalidate
  • Configuration: bse_vars or Enterprise Server Service Manager (Windows)
BIRT_HOME n/a Location of BIRT runtime binaries used to convert 4GL reports to Report Viewer enabled reports.
  • Used by: BIRT reporting
  • Configuration: bse_vars or Enterprise Server Service
  • Default value: ${BSE}/birt-runtime

For details on Report Viewer enabled reporting, see Infor LN Development Tools Development Guide.

BIRT_TEMP n/a Directory to store temporary files for the first version of the LN homepages, delivered with Enterprise Server 8.4.
  • Used by: LN homepages
  • Configuration: bse_vars or Enterprise Server Service Manager (Windows)

For details on LN homepages, see Infor LN Development Tools Development Guide.

BSE n/a The directory where the LN software environment is stored.
  • Used by: All porting set binaries
  • Configuration: Command field in Infor BW configuration
BSE_BIN n/a The directory to overwrite the porting set binaries location.
  • Used by: All porting set binaries
  • Configuration: ${BSE}/lib/bse_vars
  • Default value: ${BSE}/bin
BSE_CLASSPATH n/a The search path that is used by the bshell (jvmi) to search for java classes.
  • Used by: Bshell
  • Configuration: Command field in Infor BW configuration, bse_vars or Enterprise Server Service Manager (Windows)
BSE_COMPNR n/a The company number. When you sign in, the LN sessions operate on the tables of the specified company number.

This variable overrules the company number that you specified in the LN user data.

  • Used by: Bshell
  • Configuration: Command field in Infor BW configuration
  • Possible values: Any company number in your LN environment. To view the companies, use the Companies (ttaad1100m000) session.
Note: Only select a company number linked to the user’s package combination.
BSE_DATA_LANG datalang The data language, such as nl (Dutch/Flemish), en (English), de (German), or fr (French).

When you sign in, the LN application data is displayed in the specified language. This variable overrules the Data Language setting in the LN user data.

  • Used by: Bshell
  • Configuration: Environment or as resource in $BSE/lib/all
  • Possible values: Any data language code used in your LN environment. To view data language codes, use the Data Languages (ttaad1111m000) session.
  • Default value: undefined
Note: You can only use this variable if Multilanguage Fields Support is enabled on your LN server. For details, see Infor Enterprise Server Administration Guide.
BSE_FIN_COMPNR n/a The financial company. This variable overrules the company number that you specified in the LN user data.
  • Used by: Bshell
  • Configuration: Command field in Infor BW configuration
BSE_LANG language The software language, such as 1 (Nederlands), 2 (English), 3 (Deutsch), or 4 (French).

When you sign in, the LN software is displayed in the specified software language. This variable overrules the Language setting in the LN user data.

  • Used by: Bshell
  • Configuration: Command field in Infor BW configuration
  • Possible values: Any language code installed on your LN server. To view the language codes, use the Software Languages (ttaad1510m000) session.
  • Default value: 2
BSE_LOG_COMPNR n/a The logistic company. This variable overrules the company number that you specified in the LN user data.
  • Used by: Bshell
  • Configuration: Command field in Infor BW configuration
BSE_REM n/a Identifies the MAS host and BSE path in environments with distributed application servers (AS/MAS concept). This variable is set during the installation of LN.
  • Used by: Bshell
  • Configuration: Command field in Infor BW configuration, bse_vars or Enterprise Server Service Manager (Windows)
BSE_SHLIB n/a The directory to override the porting set shared libraries location. BSE_SHLIB is the platform independent counterpart of the OS dependent PATH/LD_LIBRARY_PATH/LIBPATH environment variables.
  • Used by: All porting set binaries
  • Configuration: ${BSE}/lib/bse_vars
  • Default value: ${BSE_BIN}/../shlib
BSE_SORT n/a Path where temporary files are stored during the sort process. It is used by the sort binary, for example, when reports are printed.
  • Used by: Bshell
  • Configuration: bse_vars or Enterprise Server Service Manager (Windows)
  • Default value: ${BSE}/tmp
BSE_STD_PROGRAM std_program A program name that overrides the standard program (4GL engine), which Tools developers and support personnel use.
  • Used by: Bshell
  • Configuration: Command field in Infor BW configuration, or LN user data
BSE_TMP n/a The directory where LN stores its temporary files.
  • Used by: Bshell
  • Configuration: Environment or Command field in Infor BW configuration
  • Default value: ${BSE}/tmp
BSE_USER n/a Variable to operate using different LN user names.

Used by: Porting set binaries

See the online help of the User Data (ttaad2500m000) details session.

CUSTOMIZE n/a This variable indicates whether end user customizations on forms are displayed.

Possible values: yes/no.

Value "NO" hides the end user customizations on forms at runtime.

Note: This is not a porting set variable.
DISPLAY n/a UNIX and Linux variable that must be set to perform operations on images uploaded in the UI.
FGL_STUDIO_ENABLED n/a Indicates whether the LN environment is enabled for software development through Infor LN Studio.

Possible values: 1 (enabled) / 0 (disabled).

See the LN Studio documentation.

JAVA_HOME n/a Indicates the installation Java directory.
  • Used by: Bshell Java integration
  • Configuration: Environment or bse_vars or Enterprise Server Service Manager (Windows)
JRE_HOME n/a Installation directory of the Java runtime engine.
  • Used by: Bshell Java integration
  • Configuration: Environment or bse_vars or Enterprise Server Service Manager (Windows)
LD_LIBRARY_PATH n/a HP-UX, Oracle Solaris, and Linux operating system variable that indicates the Library path.
  • Used by: Bshell and database drivers on HP-UX, Oracle Solaris, and Linux
  • Configuration: Environment

LIBPATH

n/a AIX operating system variable that indicates the search path for shared (dynamic) libraries.

For example:

LIBPATH=${BSE}/shlib:/opt/db2/lib

  • Used by: Bshell and database drivers on AIX
  • Configuration: Environment
LTS_LANGUAGE n/a Sets the Language Translation Support (LTS) language. Overrides the language specified in the user data.
Note: This is not a porting set variable.

See the Infor Web Help and the Infor LN Development Tools Development Guide.

LTS_RESOLVE_MODE n/a The mode to retrieve labels during the LTS process.

Possible values/modes: "dump", "database", and "fallback".

Note: This is not a porting set variable.
MAX_RETRY n/a This variable is used to test programming structures for transaction management.

It indicates the number of times the system may return to a retry point as a result of an abort in an update action.

The default value is 10.

For details, see the Infor ES Programmers Guide (Infor Customer Portal KB2924522).

PACKAGE_COMB pacc Sets the package combination and overrides the user data.
  • Used by: Bshell
  • Configuration: Environment or Command field in Infor BW configuration
PATH n/a The search path for Windows/UNIX operating system executables.
Note: The ${BSE}/bin directory must be included in the PATH.
  • Used by: All porting set binaries
  • Configuration: Environment
SH_TABLE n/a The name of the file that contains your own shift table.

This variable is used in Native Language Support (NLS).

SLMHOME n/a Installation directory for newer SLM versions. Replaces the BAANHOME variable.
SORT_TABLE n/a The name of the file that contains your own sort table.

This variable is used in Native Language Support (NLS).

  • Used by: Bshell
  • Configuration: Environment or Command field in Infor BW configuration
SSI_MAX_ROWS n/a The number of records that can be exported simultaneously from an LN session to MS Excel.

If a session contains much data, a full export from that session can slow down or block the entire database. To prevent this, you can limit the number of records that can be exported by setting this parameter.

To limit the number of records that can be exported, set SSI_MAX_ROWS to a value greater than zero. For example, if SSI_MAX_ROWS = 500, 500 records can be exported at most.

SSI_MAX_ROWS may have a value that is less than or equal to zero. In that case there is no limit, except the MS Excel limit, for the number of records that can be exported.

SUPPRESS_INHELP n/a Variable to suppress windows help (Infor Baan IVc/ Infor Baan 5.0).

To use ASCII Help instead of Windows Help, set the variable to 1.

Note: This is not a porting set variable.
TC_STARTUP_TIME n/a This variable is used when you access LN through LN UI or Web UI. The variable indicates the number of seconds the server waits, after a new session is started, before a response is sent to the UI. If you do not set the variable, the server waits a maximum of 15 seconds.
  • Used by: LN UI and Web UI
  • Configuration: LN UI/Web UI user profile
Note: This variable is only relevant for application developers who debug LN applications.

Within the specified time duration, a newly started session must notify the tcserver whether it requires a UI. The tcserver is a server component that handles communication with the UI. If the tcserver is not notified timely, the UI and tcserver ignore all UI actions of the session, the session runs without a UI.

When you debug the server, you can increase TC_STARTUP_TIME. For example, because a session stops in a breakpoint before it can notify tcserver.

TEST_RETRY n/a This variable is used to test programming structures for transaction management.

It indicates the number of times the system must return to a retry point at the moment of committing. The variable cannot be used when testing different sessions with retry points parallel.

See the Infor ES Programmers Guide (Infor Customer Portal KB2924522).

For details on resources not listed in the previous table, see these documents:

  • The technical reference manual of your database driver.
  • The Infor LN Performance, Tracing and Tuning Guide.

Resources for the bootstrap file

There is a special ${BSE}lib/defaults/bootstrap file. This file is optional. It can contain resources that must be set early in the initialization phase of the bshell.

This table shows these resources:

Resource Description
fips_140_mode This resource turns FIPS-140 mode on. Its value must be "1" (on) or "0" (off).

If this setting is on, the bshell runs in FIPS-140 mode. This implies that certain versions of, older, cryptographic algorithms are not allowed to be used. Attempts to do so result in a log message and a failure code of the bshell function.

Officially, FIPS also requires that the implementation of the cryptographic libraries must be certified. Currently, that is only true for WolfSSL-based porting sets, see bshell -v output, not for OpenSSL-based versions. Regardless of the implementation, the bshell restricts access to non-FIPS crypto if this setting is on.

If the CLOUD_TYPE is set to "gov", this implies automatic setting of the fips_140_mode to "1" and the ssl resource to "tlsv1.2".

To query the current setting of the resource, you can use the in.fips.mode() 3GL function.

ssl

This setting has these possible values:

  • off. This is the default.
  • on. Turns default security level on.
  • tlsv1.1: Minimum acceptable security level.
  • tlsv1.2: Minimum acceptable level, default for GovCloud.
  • tlsv.1.3: Minimum acceptable level.

If you set this resource to another value than "off", secure communication is enforced between several components:

  • Between the LN UI and the bshell
  • Between bshells that invoke each other through sock.start.process() functions

This protects all such network communication from eavesdropping and tampering. It is available on all platforms.

The setting must be in the bootstrap file because the security is turned on between LN UI and bshell in an early stage. So, even error messages about the startup of the bshell are sent to the user in encrypted form.

When set to "on", the actual resulting protocol is left to the negotiating parties: Any SSL protocol is acceptable.

V1.1 can be enabled to talk to older installations.

V1.2 is the default.

V1.3 is the up-and-coming, mid 2020, protocol implementation. This is more secure than the older versions.

SSL uses certificates for the security. The certificate that is used is the same as installed with Infor LN and used by the Logic Service (blogind). Therefore, the blogind_bse resource must also be set so that all BSEs on the machine can find the certificate.

blogind_bse The ssl resource requires a certificate to function.

One installation can have multiple BSEs, but there is only one certificate installed by default which is primarily used by the Logic Service (blogind). This service has its own BSE, so this blogind_bse resource must be set to enable other BSEs to find the certificate.

This is a string with the full path name of the BSE in question.

To query the current setting of the resource, you can use the ssl.mode() 3GL function.