These are the most common environment variables that can be used with the Micro Focus products.
The following environment variables are set in the system registry. You can change the values using the SET command, but values you set are only added to the values already set in the registry.
|CCITCP2||Specifies the machine that the CCITCP2 daemon is running on.|
|COBCPY||The location of COBOL copybooks.|
Specifies one or more locations, separated by ; (Windows) or : (UNIX), in which to search for data files at run time. As long as the file assignment does not contain a sub-path (that is, a string containing \ or /) then the file assignment is appended to each location specified by COBDATA in order to locate the file.
Note: Users modernizing RM/COBOL or ACUCOBOL-GT legacy code can use a sub-path in the file assignment, but only by compiling with the relevant DIALECT or IDXFORMAT values for the respective File Handling systems; setting these values in the File Handling configuration file is not sufficient to achieve this.
|COBDIR||The location of the COBOL system directory.|
|COBHNF||The location of .hnf files.|
|COBPATH||Specifies the locations in which to search for
To specify more than one location, use the ; (semicolon) separator .
|LIB||Tells the Linker where to find .lib files.|
|INCLUDE||Specifies which directories should be searched for such things as resource include files.|
|PATH||Indicates which directories Windows should search for executable files.|
The following environment variables can be set from within your environment using the SET command:
|COBCCSIDDIR||For deployed application that use CCSID translation tables, this variable specifies the base directory in which all required translation tables are located.|
|COBCONFIG||The location of COBOL configuration files.|
|COBCONFIG.BLOCK||The location of the application configuration file.|
|COBFSTATCONV||Specifies name of a user-supplied module that the Callable File Handler should use to convert the file status codes if an I/O error is encountered on a file.|
|COBIDY||The location of debugger .idy files.|
|COBLANG||Tells the COBOL system in which language environment you want to run your COBOL program. COBLANG can be used in conjunction with third party products using values of the LANG environment variable which are in a different format than that used by the COBOL system.|
|COBPRFDIR||Specifies a directory to be used for storing .ipf files created by programs compiled with the PROFILE compiler directive.|
|COBSW||Used to pass COBOL run-time system and user switch settings to user application programs.|
|DB2DBDFT||Identifies the DB2 database to be accessed by the application.|
|DD_||Used to identify environment variables that define file-name mappings.|
|ENTRYNAMEMAP||Specifies entry name map files and folders containing them.|
|EXTFH||Specifies the File Handler configuration file to use.|
|FHREDIR||Specifies a configuration file to be used by the Fileshare Client.|
|FSIDXINTEGRITY||When this is set to OFF, this writing to disk any changed nodes held in the index cache, until space in the cache is needed for other nodes.|
|HCOBND||Sets a directory for storing BIND files.|
|HELPFILES||The list of files to be loaded at initialization by HyHelp.|
|LANG||Tells the system in which language environment you want to run your program.|
|MAINFRAME_FLOATING_POINT||Specifies the floating point format used.|
|MFCODESET||Specifies which translation tables to use; see Codeset Translation for more details.|
|MFCODESET_DBCSDIR||Specifies the location of the codeset mapping files required for certain DBCS conversions, where deployed applications do not have a full deployment product available; see Codeset Translation for more details.|
|MFCSCFG||Specifies a configuration file to be used by the Client/Server Binding client program. It is also used by the Client/Server Binding server program when the srvtier facility is used.|
|MFJSERET||Determines the response to an unsuccessful sort, copy or merge operation. Set to ABEND for an unsuccessful operation to abend and its program to continue instead of terminating with an unrecoverable error (return code 16).|
|MFJSTATS||When this is set to ON, creates a report containing statistics for the SORT that is displayed to SYSOUT. If a report file already exists for a previous SORT, the new statistics are appended to the end of the previous one.|
|MFEXTMAP||Used by the External File Mapper to locate the file mfextmap.dat.|
|MFLOGDIR||Specifies a directory to be used by the Client/Server Binding for log files.|
|MFRU_NOINHERIT||Determines if processes are registered in shared memory during initialisation of the run-time system. COBRT105 errors can occur during initialisation if a very large number of COBOL processes are running and there are no available slots in the shared memory segment - setting this variable to Y or TRUE skips the registration process. However, when set to Y, various run-time settings (switches, shared memory, console window settings, etc...) are no longer inherited by any child processes. The default is that the variable is not set, which means that registration is not skipped.|
|OOSW||Used to set run-time switches that effect OO programs.|
|SORTCOMPRESS||Tells the system whether or not to execute a compression routine on each record to be sorted. Set SORTCOMPRESS to a positive integer to allow for run-length encoding of sort records, resulting in much better performance when records contain multiple repeated characters.|
|SORTSCHEME||Use in conjunction with SORTSPACE for improved performance. This is activated by setting SORTSCHEME=1. This is the only valid value for the environment variable. See SORTSPACE below for more information.|
|SORTSPACE||The amount of memory to be allocated to internal workspace for SORT operations. This can be specified in different formats:
for example, you could specify 64M, 2G, and 1000000 to give sort memory areas of 64 Megabytes, 2 Gigabytes and 1000000 bytes
Typically, increasing SORTSPACE will improve the overall performance of your SORT. This can be further improved by the use of SORTSCHEME when the files to be sorted are over 1GB. Consider:
|SORTTEMPSPACE||The amount of temporary memory to be allocated to internal workspace for SORT operations. This can be specified in different
formats much like the SORTSPACE environment variable. By using SORTTEMPSPACE, you can maximize available memory.
To maximize the use of available memory to improve performance, particularly in systems suffering from memory fragmentation, the memory allocation strategy used by SORT can be adjusted through use of the SORTTEMPSPACE environment variable. Increasing the amount of SORTTEMPSPACE can help prevent "SORT020U SORT(EXTSM) failed - sort engine status = 9/105" error messages.
|SORTTYPE||Setting SORTTYPE=2 forces SORT to use the file handler, so that format modifications are picked up from the extfh.cfg file. Not setting this means SORT will try to use CBL_ routines to read and write files to improve performance. Note that 2 is the only valid value for this environment variable.|
|SQLPASS.TXT||Supplies the user ID and password for automated compiles done on a remote DB2 server.|
|STRICTVSAM||When set to ON and under a mainframe emulation, a file status of 37 is returned when you open an existing VSAM file for OUTPUT and the file has or previously had some data written to it, or if the file format is different from the file on disk. The default for this variable is OFF.|
|TESTCOVER||Enables you to use the test coverage tool, which creates a statistical execution profile of a program. This should be set to the path of the test coverage configuration file.|
|TMP||Tells the run-time system where to put paging files Normally it puts these files in the current directory. By using TMP you can specify a different drive or path for them.|