Environment

A Virtual Machine can only have one Environment section so you will not be able to give the Environment section an identifier or create another environment section.

Item	Description
PROIV_HOME	Enter the root folder of the PROIV installation.
PROIV_PORT	Enter the port that PROIV server listens on. Default is 8023. Microsoft Windows only.
PROIV_SSL_PORT	Enter the SSL port that PROIV server listens on.
KERNELSERVER_PORT	Enter the port that Windows Kernel Server listens on.
HOSTNAME	Enter the hostname or other operating system specific name.
PRORUNTYPE	Determines whether PROIV should execute as a development (DEV) or run- time (RUN) system.
COMSPEC	Enter the command program that is to be used (COMMAND.COM or CMD.EXE). If undefined, PROIV attempts to auto detect the correct command program.
CAPTION	Enter the caption that appears at the top of the main PROIV Screen. This setting is ignored if the DisplayFunctionTitles option is enabled.
TERMID	Enter the terminal identifier. If not defined, then a default identifier is assigned.
PROTERM	Enter the terminal type.
TEMP	Enter the folder to be used for the creation of temporary files, such as Sort files. If undefined then the PRODATA folder (see below) is used.
FSIDEFAULT	Enter the file type of the bootstrap, temporary and data files that do not specify a type.
PROPATH	Enter the full path name of the folder containing the bootstrap files.
PRODATA	Enter the full path name of the folder containing the application files.
USERNAME_VALIDATE	Set to Y to require validation of the user name and password against the Windows user database.
USER_DOMAIN	Enter the logged in user domain. This is used to override the default parameters used for user login.
LOGONTYPE	Enter the logged in user type. This is used to override the default parameters used for user login.
USERNAME_PROMPT	Set to Y to make the Virtual Machine server ask for a user name.
USERNAME_TIMEOUT	Enter the number of seconds that the Virtual Machine will wait for a response before aborting a connection attempt. The default is 30.
MANDATORY_PROFILE	Set to Y to make profiles mandatory.
TP_ROLLBACK	Set to Y to generate a transaction rollback if an error occurs.
Profiler
APPLICATION_PROFILER	Set to Y to enable Application Profiler.
APPLICATION_PROFILER_FILE_PREFIX	Enter the prefix string for the generated profiler file.
APPLICATION_PROFILER_PATH	Enter the path where the Profiler file gets generated. By default, it is set PROIV_HOME, the root directory of PROIV installation.
Runtime Caching
RUNTIME_CACHE	Determines the cache model in effect.
GENFILE_RUNTIME_CACHE	Determines runtime cache model for genfile records.
FUNCTION_RUNTIME_CACHE	Determines runtime cache model for functdef records.
MSGF_RUNTIME_CACHE	Determines runtime cache model for msgf records.
VARDEF_RUNTIME_CACHE	Determines runtime cache model for vardef records.
SECURITY_RUNTIME_CACHE	Determines runtime cache model for security records.
GENFILE_RUNTIME_CACHE_SIZE	The default cache size of genfile records is 500, you can modify if required.
FUNCTION_RUNTIME_CACHE_SIZE	The default cache size of functdef records 500, you can modify if required.
MSGF_RUNTIME_CACHE_SIZE	The default cache size of msgf records is 1000, you can modify if required.
VARDEF_RUNTIME_CACHE_SIZE	The default cache size of vardef records is 200, you can modify if required.
SECURITY_RUNTIME_CACHE_SIZE	The default cache size of security records is 200, you can modify if required.
Licensing
LICENCE_SERVER_HOST	Enter the address of the machine serving the licence requests.
LICENCE_SERVER_PORT	Enter the port number the licence server is listening on.
LICENCE_SERVER_SERIAL	Enter the Licence Server serial number.
SQL
SQL_CURSORS	Enter the number of SQLDAs to be used. If undefined then 128 is used.
SQL_DBNAME	Enter the SQL database name.
SQL_USERNAME	Enter the RDBMS username to be used to connect to the RDBMS.
SQL_PASSWORD	Enter the RDBMS password to be used to connect to the RDBMS.
SQL_DBTYPE	Select the SQL database type from either Oracle, Postgres, SQLServer and P2000.
SQL_NOSIG	Set to Y to hide record lock checking from database connection to prevent loss of connection (Windows platform only).
SQL_ROWS_RETURN	Limits the number of rows returned by a SQL statement.
SQL_TRANSACTION_ERROR	Set to Y in a production environment. When set, a PROIV error message will be output if a COMMIT is executed at an invalid point in the transaction instead of a fatal database error.
DB2_SELECT_FOR_UPDATE	Set True or False; Controls the addition of "For Update" clause into the SQL generated in PROIV for modifiying the existing DB2 row.
SQLSERVE_SELECT_FOR_UPDATE	PROIV recommends to set to True always; Controls the addition of "For Update" clause into the SQL generated in PROIV for modifying the existing SQL server row.
POSTGRES_SELECT_FOR_UPDATE	PROIV recommends to set to True always; Controls the addition of "For Update" clause into the SQL generated in PROIV for modifying the existing PostgreSQL row.
OCI8_CACHE_OPT	Set Y or R; The default value is N where caching does not takes place. Y indicates the caching is enabled and R indicates caching is enabled where select statement uses ROWNUM. For more information, refer to Oracle Call Interface
ORACLE_DLLNAME	If using Oracle, this should be set to the fully qualified name of the PROIV Oracle DLL (Windows platform only).
Java and Lexicon
JVM_OUT	Enter a path and file to write the Java stdout stream out to, the default is c:\PROIVjvm.out or /tmp/PROIVjvm.out.
JVM_ERR	Enter a path and file to write the Java stderr stream out to, the default is c:\PROIVjvm.err or /tmp/PROIVjvm.err.
ADDITIONAL_CLASSPATH	Enter a semi-colon (Windows) or colon (Unix) separated string of fully qualified classpath entries to be used by the JVM. Note that you must include the full path to the JDBC JAR file which is used with the Lexicon, including the file name.
SSO_JARPATH	Enter a semi-colon (Windows) or colon (Unix) separated string of fully qualified JAR files, or folders containing the SSO JAR files.
JAVA_STRING_CHARSET	Specify the character set to be used when converting strings from the Java layer into the PROIV Virtual Machine. The default is UTF-8.
JNI_START_MEM	Select the initial heap size of the JVM in MB from the drop-down list.
JNI_MAX_MEM	Enter the maximum heap size of the JVM in MB.
JNI_INC_GC	Enables or disables incremental garbage collection, which is the automatic detection and freeing of memory that is no longer in use.
Restful Web Services
SDO_MaxSizeInBytes	Signifies the maximum size in bytes that a SDO object can hold. The default value is 65535; however you can set to a minimum of 255 to maximum of 4294967295.
PROIV Performance Monitor
PPM_URL	The default URL path to connect to Performance Monitor is displayed. However, you can modify, as required.
PPM_CONTROLLER_CONNECT_TIMEOUT	Specify the maximum time duration during which the PPM connection is retried. The default value is 15 seconds; however, you can modify to a minimum value of 5 seconds and maximum 60 seconds.
PPM_CONTROLLER_CONNECT_SLEEP	Specify the time in milliseconds to introduce a brief sleep after an unsuccessful connection and is applicable during the initial connection timeout specified by PPM_CONTROLLER_CONNECT_TIMEOUT. The default value is 100 milliseconds; however, you can modify this parameter to a minimum value of 10 milliseconds and maximum of 500 milliseconds.
PPM_CONTROLLER_CONNECT_RETRY	The statecheck interval is the time in seconds that is specified to periodically check the event collection state from the PPM Controller. The default value is 30 seconds. However, you can modify this to a minimum value of 10 seconds and maximum of 60 seconds.
PPM_CONTROLLER_STATECHECK_INTERVAL	Specify the time which after completion, a connection is retried when the initial connection attempts during the time frame specified by PPM_CONTROLLER_CONNECT_TIMEOUT has failed and another attempt to connect with the PPM controller is tried. This basically introduces a delay before a next connection attempt. The default value is 60 seconds; however, you can modify to a minimum value of 15 seconds and maximum 300 seconds.
Diagnostics
TR_PATH	Enter the folder into which the trace files are written. A trailing slash is required.
TR_MAX_FILE_SIZE	Specify the maximum allowed trace file size per session in mega bytes. The initial value for this parameter is read from the .ini file. If not set, then the default value is set to 0. The maximum allowed value is 50 and minimum size is 0 (denotes unlimited file size).
TR_MAX_FILES_PER_VM	Specify the maximum number of trace files that can be created for the current session. You can create a minimum of 1 file to a maximum of 20 files per session. The tracing starts with the first trace file and when it reaches its maximum size specified by TR_MAX_FILE_SIZE then it will rollover to the second trace file. This process will continue until the number of trace files generated reaches the max set files per session specified by TR_MAX_FILES_PER_VM. In such a case where the last trace file reaches its maximum size, then the oldest trace file is reused to enable tracing to continue and the rollover process is repeated. If TR_MAX_FILES_PER_VM is not within the predefined range of minimum or maximum values, then these parameters will default to either the min (1) or max (20) values depending on whether the set value is less than the minimum value or greater than the maximum value. The trace file size is limited using the configuration parameter, TR_MAX_FILE_SIZE. If only TR_MAX_FILE_SIZE is specified and no mention about TR_MAX_FILES_PER_VM, then TR_MAX_FILES_PER_VM will take the default value "1". The tracing starts and a new trace file is created and the logs are written until its size reaches set max file size. When it exceeds the max file size set in TR_MAX_FILE_SIZE, then the tracing log is written from the beginning of the trace file. In this case, the timestamping will implicitly be turned on.
TIMESTAMP	Controls whether to prepend a timestamp onto the start of each log line.
TRACEALL	If this is defined it overrides all other trace categories and sets them to this level.
TRACEBLK	Enter the trace level for the file record data field block, deblock. Suggested level is 8.
TRACECRT	Enter the trace level for high-level screen interface. Suggested level is 3.
TRACEDAEMON	Enter the trace level for the Pro4 Kernel Manager. Suggested level is 9.
TRACEENV	Enter the trace level for the environment settings processing . Suggested level is 4.
TRACEFILE	Enter the trace level for the file system access. Suggested level is 8.
TRACEGEN	Enter the trace level for the function gen information. Suggested level is 8.
TRACEGUI	Enter the trace level for the GUI client hints . Suggested level is 8.
TRACEIO	Enter the trace level for the screen client IO. Suggested level is 9.
TRACELGC	Enter the trace level for logic execution. Suggested level is 5.
TRACEMEM	Enter the trace level for memory allocation. Suggested level is 4.
TRACEMFIN	Enter the trace level for the screen input field set structures. Suggested level is 4.
TRACEMFOUT	Enter the trace level for the screen output field set structures. Suggested level is 4.
TRACEMISC	Enter the trace level for miscellaneous items. Suggested level is 9.
TRACEREC	Enter the trace level for file recovery (file commit, rollback processing). Suggested level is 3.
TRACEREP	Enter the trace level for report output. Suggested level is 4.
TRACESER	Enter the trace level for product licensing. Suggested level is 6.
TRACESQL	Enter the trace level for the SQL file interface. Suggested level is 3.
TRACETASK	Enter the trace level for the P4API bus and tasks interface. Suggested level is 9.
TRACEUSER	Enter the trace level for the user (developer) application information. Suggested level is 3.
TRACEUSRTB	Enter the trace level for the PROIV Service Manager interface. Suggested level is 5.