Mainframe Access Environment Variables

Lists environment variables related to the Mainframe Access functionality.

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.

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.

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).

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