Modifying Environment Settings

The syntax of Configure Runtime command-line utility for modifying the AB Suite runtime settings is:

ConfigureRuntime.exe /ENV /C <UseFileToStorePassword|UseAlternateEncryption|UseHubSocket|HubToBusinessIntegratorHost|
HubToOS2200Host|TextOutputForDirectReports|AllowConsolePopups|UseTagSort|IspecMapCullMemoryLimit|
IspecMapCullTxnCnt|RecycleVirtualMemSizeLimit> [/V <Value>] [/?]

If you pass valid parameters to modify the AB Suite runtime settings, the message "Successfully updated the configuration" appears.

Parameters

Argument

Description

/ENV

Specifies configuring the AB Suite runtime settings to modify the behavior of AB Suite Windows Runtime.

/C <UseFileToStorePassword| UseAlternateEncryption|UseHubSocket| HubToBusinessIntegratorHost| HubToOS2200Host| TextOutputForDirectReports| AllowConsolePopups| UseTagSort|IspecMapCullMemoryLimit| IspecMapCullTxnCnt|RecycleVirtual MemSizeLimit>

Specifies modifying the AB Suite runtime settings for the following runtime options.

  • UseFileToStorePassword: Specify the AB Suite runtime setting to provide an alternate method of storing database passwords in the database server instead of the registry. By setting the AB Suite runtime setting, you can store the passwords in a dedicated file instead of the registry. By default, you can store the password in a file at:

    \Data\Private\Software\Unisys
    \SM Runtime\ Security\Schemas\
    <Alias_Name>\<DB_Name>\
    <Schema_Name>\

    Note: To start storing the passwords in the database server, you must remove the existing version of the runtime systems, specify the "UseFileToStorePassword" AB Suite runtime setting, and then redeploy the runtime versions.

  • UseAlternateEncryption: Specify the AB Suite runtime setting to provide an alternate mechanism of encrypting and decrypting passwords by storing the password in a file instead of the operating system API to encrypt or decrypt passwords. By default, you can store the passwords in a file located at:

    \Data\Private\Software\Unisys
    \SM Runtime\ Security\Schemas\
    <Alias_Name>\<DB_Name>\
    <Schema_Name>\

    Note: To start storing the passwords, you must remove existing version of the runtime systems, specify the "UseAlternateEncryption" AB Suite runtime setting, and then redeploy the runtime versions.

  • UseHubSocket: Specify the AB Suite runtime setting to allow hubbing of external automatic entries from EAE Windows to AB Suite Windows.

  • HubToBusinessIntegratorHost: Specify the AB Suite runtime setting to enable the AB Suite applications to communicate with the Business Integrator host.

Continued...

/C <UseFileToStorePassword| UseAlternateEncryption|UseHubSocket| HubToBusinessIntegratorHost| HubToOS2200Host| TextOutputForDirectReports| AllowConsolePopups| UseTagSort|IspecMapCullMemoryLimit| IspecMapCullTxnCnt|RecycleVirtual MemSizeLimit>

Note: The name of the Business Integrator host must be in uppercase.

  • HubToOS2200Host: Specify the AB Suite runtime setting to enable the AB Suite applications to communicate with the OS2200 host.

    Note: The name of the OS2200 host must be in uppercase.

  • TextOutputForDirectReports: Specify the AB Suite runtime setting to store the output of the direct report in a file. Refer to Direct Reports for more information on direct reports.

  • AllowConsolePopups: Specify the AB Suite runtime setting to display pop-up messages on the console session. On a Windows server, the first user session to sign on is identified by session number 0 and is referred as the console session. By specifying the AB Suite runtime setting, any external program that is run through the Start command displays the pop-up messages on the console, regardless of the user who actually started the program. All the programs that are run through the Start command are run under the console user session.

  • UseTagSort: Specify the tag sort threshold AB Suite runtime setting to enable sorting of large extract files using tag sort technique. Refer to Extract Files in the Agile Business Suite Developer User Guide for more information. Sorting the extract files can use a lot of memory. By default, the entire extract files is loaded into the memory and sorted before rewriting it to the disk. To reduce the amount of memory used and prevent out-of-memory errors, you can use the tag sort technique for sorting large extract files, such as greater than 400 MB.

    Note: Ensure to specify the tag sort threshold value in MBs to specify the size of an extract file.

Continued...

/C <UseFileToStorePassword| UseAlternateEncryption|UseHubSocket| HubToBusinessIntegratorHost| HubToOS2200Host| TextOutputForDirectReports| AllowConsolePopups| UseTagSort|IspecMapCullMemoryLimit| IspecMapCullTxnCnt|RecycleVirtual MemSizeLimit>

  • IspecMapCullMemoryLimit: Specify the AB Suite runtime setting to set the memory limit value that initiates the execution of the ispec cull algorithm when the memory usage of the Dllhost process goes above the specified value. The runtime internally maps each of the ispec objects by creating an instance of the ispec and adding the ispec to the ispec map. The ispec instance is reused for subsequent transactions of that ispec. This increases the size of the ispec map that can consume a lot of memory. To limit the memory usage, the ispec cull algorithm is executed to periodically cull the ispec map.

    Note: The default value of the memory usage of DllHost process is 800 MB after which the executions of the ispec cull algorithm starts. You can specify a different memory limit value for the AB Suite runtime setting.

  • IspecMapCullTxnCnt: Specify the AB Suite runtime setting to set the number of transactions between running the ispec map cull algorithm.

    Note: By default, the ispec map cull algorithm runs after every 500 transactions. You can specify a different number to set the frequency of the execution of the algorithm.

  • RecycleVirtualMemSizeLimit: Specify the AB Suite runtime setting to enable the DllHost process to recycle when the Virtual Memory Size exceeds the specified value. If a system is running for a long duration, the Virtual Memory Size internal resource limit exceeds a defined value. By default, the defined value of Virtual Memory Size is 1700 MB (1.7 GB).

    Note: If Virtual Memory Size exceeds the specified value, out-of-memory exceptions can occur.

Notes:

  • This argument is mandatory.

  • If an invalid AB Suite runtime option is passed, an error message specifying that the argument is invalid appears.

/V <value>

Specify the values for each of the AB Suite runtime settings as appropriate.

Note: This argument is not mandatory and should be specified depending on the type of the AB Suite runtime setting options.

For example: To configure each of the AB Suite runtime settings, type

ConfigureRuntime.exe /ENV /C UseFileToStorePassword /V "C:\ABSUIT~7.0
\Data\<file name>
ConfigureRuntime.exe /ENV /C UseAlternateEncryption /V "C:\ABSUIT~7.0
\Data\<file name>"
ConfigureRuntime.exe /ENV /C UseHubSocket 
ConfigureRuntime.exe /ENV /C HubToBusinessIntegratorHost /V "<HOSTNAME>"
ConfigureRuntime.exe /ENV /C HubToOS2200Host /V "<OS2200 HOST NAME>"
ConfigureRuntime.exe /ENV /C TextOutputForDirectReports /V "C:\<AB Suite Data folder>\
<file name>"
ConfigureRuntime.exe /ENV /C AllowConsolePopups
ConfigureRuntime.exe /ENV /C UseTagSort /V "200"
ConfigureRuntime.exe /ENV /C IspecMapCullMemoryLimit /V "750"
ConfigureRuntime.exe /ENV /C IspecMapCullTxnCnt /V "500"
ConfigureRuntime.exe /ENV /C RecycleVirtualMemSizeLimit /V "1500"

/ENV /?

Displays the command line syntax for configuring the AB Suite runtime settings, parameters, and options of the utility. If specified, a usage message appears and the utility exits without starting the configuring process.