Common Communications Interface Environment Variables

Lists environment variables related to CCI.
Parent topic: Environment Variables by Groups

CCIERRLOG

Specifies the location of and filename for CCI error log output.
Syntax 
Windows:
CCIERRLOG=path-name\file-name
UNIX:
CCIERRLOG=path-name/file-name}
Parameters
path-name
The full path to the output location.
file-name
The name of the output file.
Default
Not set. The default path is the working directory of the application calling CCI, and the default filename is ccierr.log.
Comments
The CCI error log tracks first-instance errors reported from the operating systems. CCIERRLOG overrides any entries found in CCI.INI, where the syntax and content is explained in detail. See CCI.INI - The CCI Configuration File for more information.

CCITCP2

Sets the TCP address of the machine running the MFDS (formerly CCITCP2) registration daemon.
Syntax 
CCITCP2=host-name
Parameter
host-name
The TCP host name, IPv4 address, or IPv6 address of the machine running the MFDS daemon you want to contact from the session.
Default
Not set. The local system is used.
Comments
Use this environment variable to set the TCP address of the machine running the MFDS registration daemon, which holds the registration of the service you are contacting, or will hold the registration of the service you are starting.

CCITCP2_PORT

Sets the port used for the MFDS registration process.
Syntax 
CCITCP2_PORT=port-number
Parameter
port-number
The number of the port on which the MFDS service is listening.
Default
Not set. Uses the port specified by the mfcobol service name in %WINDIR%\system32\drivers\etc\services (Windows) or /etc/services (UNIX). If not found there, uses the official Micro Focus directory port, which is 86.

CCITCPS_service-name

Associates the name of a service being registered with a different service name, one or more ports, and/or one or more network interfaces.
Syntax 
CCITCPS_old-service-name=[new-service-name],
   {MFNODE:node-name | MFPORT:port-number | 
    MFNODE:node-name, MFPORT:port-number}
Parameters
old-service-name
The name of the CCI server. On UNIX platforms, this must be in upper case.
new-service-name
The new name to use for the CCI server. If omitted, the old-service-name is used.
node-name
The host name or IP address on which to listen for connections.
port-number
The TCP port on which to listen for connections.
Default
Not set. A port is assigned by the operating system, and the server listens on all available network interfaces.
Comments
CCITCPS is set in the environment of a CCI server process, and changes how it listens for connections and how its service name is registered.
Example 
CCITCPS_MYSERVICE=,MFPORT:3000

CCITCPT_service-name

Specifies the host, and/or port for a client to use when connecting to a service.
Syntax 
CCITCPT_serice-name=[unused], MFNODE:node-name, MFPORT:port-number
Parameters
service-name
The name of the CCI service to which the client is to connect. On UNIX platforms, this must be in upper case.
unused
The parameter before the comma is not used with CCITCPT, but supported for consistency with CCITCPS.
node-name
The host name or IP address to connect.
port-number
The TCP port to connect.
Default
Not set. The client attempts to look the service up in the MFDS directory.
Comments
Use this environment variable to instruct a CCI client to connect directly to the specified host and port rather than querying MFDS for the location of the named service.
Example 
CCITCPT_MYSERVICE=,MFNODE:localhst.MFPORT:3000

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

CCITRACE

Specifies the type of information to record using CCI tracing.
Syntax 
CCITRACE={/|-}{F|P|D}[...]
Parameters
/
Turns on the specified option.
-
Turns off the specified option.
F
Logs the details of CCI API calls to CTF. This option is implied when either P or D is specified. You can override this using -F.
P
When turned on, logs the details of protocol-level calls to CTF, which could greatly increase function tracing. When not set, only the details of the CCI user-level API are traced.
D
Logs the contents of all buffers passed to and from the CCI functions.
Warning: Setting this option might not produce the desired results if the application has been coded to prohibit data tracing.
Default
Not set. CCI tracing is controlled via the ctf.cfg and CCI.INI trace options.
Comments
The ctf.cfg and the CCI.INI file ([ccitrace_base] section) can also be used to control trace options, but any values specified by the CCITRACE environment variable take precedence. For details, see Tracing Options for CTF.CFG and CCI.INI - The CCI Configuration File.
Example 
CCITRACE=/F/D