1.6.10.4 Parameters

-n netaddr

This address specifies where IMS Connect clients connect to ARTIMS subsystem. The address is a string in standard internet URL format. For example: //computer:4000 designates port 4000 on machine computer.

Character, 1-256, A-Za-z0-9[/:-].

-L pnetaddr

This address is used by the IMSCONN subsystem internally between IMSCONN and IMSCONNH. The address is a string in standard internet URL format. For example: //computer1:4001 designates port 4000 on machine computer.

Character, 1-256, A-Za-z0-9[/:-]. Mandatory option.

[-K seconds]

Specifies the keepalive message interval time, in seconds, between IMSCONN and IMS Connect client. It should be an integer smaller than the idle time that connection's max allows. If -K option is not set, no keepalive message will be sent.

[-m minh]

The minimum number of handler processes that will be started by IMSCONN. minh is a number from 1 to 255; its default value is 1. The actual number of handler processes will always be between minh and maxh based on system load.

Note:

Although minh is a number from 1 to 255, it should be equal to or smaller than (FD_SETSIZE - 24) according to system resources limits. FD_SETSIZE means the maximum number of files that a process can have open at any time. The value can be acquired through system command ulimit -n.

[-M maxh]

The maximum number of handler processes started by IMSCONN. maxh is a number from 1 to the 1000; the default value is 1000. The actual number of handler processes is always between minh and maxh based on system load.

Note:

Although maxh is a number from 1 to 1000, it should be equal to or smaller than (FD_SETSIZE - 24) according to the system resources limits. FD_SETSIZE means the maximum number of files that a process can have open at any time. The value can be acquired through system command ulimit -n.

[-x session-per-handler]

The number of sessions an IMSCONNH can maintain concurrently in IMSCONN subsystem.

Numeric, 1-255. Default value is 32.

[-S ssladdr]

Specifies where IMS Connect clients connect to IMSCONN through SSL. The address is a string in standard internet URL format. For example: //computer:5000 designates port 5000 on machine called "computer".

Character, 1-256, A-Za-z0-9[/:-]. [-S ssladdr] is mandatory. IMSCONN fails to start if the "-S" option is unspecified. The TM_ALLOW_NOTLS environment variable must be set to "Y" if the customer does not wish to enable TLS. The -n option must be used if the customer does not wish to use TLS.

-z minencryptbits

This option specifies the minimum level of encryption required when a network link is being established between an IMS Connect client and the IMSCONN handler. If this minimum level of encryption cannot be met, link establishment fails. When using CLOPT -z or -Z, only 128 or 256 is allowed, and -z must not exceed -Z. By default, -z is set to 128, and -Z is set to 256. This option is ignored if -S option is not specified.

- Z maxencryptbits

This option specifies the maximum level of encryption allowed when a network link is being established between an IMS Connect client and the IMSCONN handler. When using CLOPT -z or -Z, only 128 or 256 is allowed, and -z must not exceed -Z. By default, -z is set to 128, and -Z is set to 256. This option is ignored if -S option is not specified.

[-d trace-level]

The -d option is used to set server's trace level. If not set, the trace level is -1 by default, meaning, only error information will be put to trace log file. Available trace-level value is 0, 1, or 2:

• 0: Function stack information is logged.
• 1: Debugging trace information is logged.
• 2: More detailed data information is logged.