Mainframe Access Environment Variables

Lists environment variables related to the Mainframe Access functionality.
Parent topic: Environment Variables by Groups

CCITIMEOUT

Sets a maximum time-out period used with non-data connect applications.
Syntax 
CCITIMEOUT=wait-time
Parameter
wait-time
The number of seconds to wait before timing out times 10, up to a maximum value of 2,147,483,647.
Default 
CCITIMEOUT=1200

(2 minutes)

Comments
Use this variable with non-data connect applications such as Drag and Drop, SourceConnect, and the Monitor.
Example
This example sets the wait time to 4 minutes: 
CCITIMEOUT=2400

MAINFRAME_FLOATING_POINT

Specifies the format to use for floating point data items. Possible formats are IBM hexadecimal and IEEE.
Syntax 
MAINFRAME_FLOATING_POINT={true|false}
Parameters
true
Use IBM hexadecimal-format floating-point data items.
false
Use IEEE-format floating-point data items.
Default 
MAINFRAME_FLOATING_POINT=false
Comments
The setting of this environment variable can be overridden by the NATIVE-FLOATING-POINT directive.

MFACLIENTINI

The complete path to the mfaclient.ini file, which contains mainframe logon credentials.
Restriction: This environment variable applies to Windows environments only.
Syntax 
MFACLIENTINI=path-name
Parameter
path-name
The complete path to the mfaclient.ini file.
Default
Not set. Uses the default location of the mfaclient.ini file, which is %APPDATA%\micro focus.
Comments
Used by mfdasmx.

MFAIMBEDDEDHEX

Determines whether the COBOL run-time system properly handles hex values embedded in source code.
Syntax 
MFAIMBEDDEDHEX=COBOL
Parameter
COBOL
Enables the COBOL run-time system to properly handle hex values embedded in source code, meaning that all translated hex values less than x'1f' have a null character inserted before the hex value.
Default
Not set. The COBOL run-time system does not handle embedded hex values.
Comments
When set, hex values are handled in the same manner as when using the MDECONV application. See Handling Embedded HEX Values for more information.

MFALLOC_DEF_VB_PCFILE

Determines whether a new PS VB file is defined in the catalog.
Syntax 
MFALLOC_DEF_VB_PCFILE={Y|N}
Parameters
Y
A new PS VB file is defined in the catalog as a VB file with default settings of minimum length = 0, and maximum length = 32760.
N
Do not create a new PS VB file.
Default 
MFALLOC_DEF_VB_PCFILE=Y
Comments
Valid only when the LRECL mfims imsdbu directive is not set or is set to 0 (zero). See LRECL for details.

MFALLOC_LOC

The default allocated dataset location.
Syntax 
MFALLOC_LOC={path-name|SQL-URL}
Parameters
path-name
The full path to the dataset location.
SQL-URL
For a database-hosted dataset, the SQL URL to that location.
Default
Not set.
Example
Set the default allocated dataset to the sql://localhost/JCLTEST?folder=/JCLDEMO/data location: 
MFALLOC_LOC=sql://localhost/JCLTEST?folder=/JCLDEMO/data

MFALLOC_PCFILE

Determines whether a catalogued file is created when DSORG=PS is provided in the DCB parameters.
Syntax 
MFALLOC_PCFILE={Y|N}
Parameters
Y
A catalogued file is created when DSORG=PS is provided in the DCB parameters.
N
A catalogued file is not created.
Default 
MFALLOC_PCFILE=Y
Comments
Valid only when DSORG=PS is provided in the DCB parameters.

MFAMAXHOTLINKS

MFAMAXHOTLINKS
Used only by the hot-link software from Micro Focus, routes all non-data connect application communication requests through this hot-link.
Syntax 
MFAMAXHOTLINKS=number-of-simultaneous-links
Parameter
number-of-simultaneous-links
The maximum number of simultaneous links allowed, up to 10.
Default 
MFAMAXHOTLINKS=4
Comments
The hot-link remains active to the mainframe until you shut down your workstation, or you enter the MFDAELSC CLOSE command.

The hot-link is able to allocate and load balance more than multiple simultaneous links and will start up an additional link if any request has to wait for more than 15 seconds for a time slice.

MFAMAXSENDLENGTH

Sets the maximum length of data that can be transmitted in a single communication packet to or from the mainframe.
Syntax 
MFAMAXSENDLENGTH=max-data-length
Parameter
max-data-length
The number of bytes that represents the maximum length of data.
Default
Not set.
Comments
This is useful when there is a router that limits the transfer length of data to or from the mainframe, or when the allowable length of transferred data is restricted.

This setting does not affect the size of the file that can be transmitted, but only the size of each of the numerous data chunks that are transmitted to make up the entire file.

Example 
MFAMAXSENDLENGTH=4000