ARTTCPL will fail to start if "-S" is not specified. If customer chooses not using TLS, environment variable TM_ALLOW_NOTLS must be set to "Y" and "-n" option must be used.

The following CLOPT run-time parameters are recognized:

-n netaddr

This address specifies where TN3270 terminal emulators connect to ARTTCPL. 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[/:-]. Mandatory option if option -S is not specified.

-S ssladdr

This address specifies where TN3270 terminal emulators connect to ARTTCPL via SSL. The address is a string in standard internet URL format. For example:

//computer:5000 designates port 5000 on machine computer.

Character, 1-256, A-Za-z0-9[/:-]. Mandatory option if option -n is not specified.

ARTTCPL shares the same SSL related configuration with Tuxedo, so the following attributes must be configured in the RESOURCES section of Tuxedo UBBCONFIG configuration file: SEC_PRINCIPAL_NAME, SEC_PRINCIPAL_LOCATION, SEC_PRINCIPAL_PASSVAR. Please refer to the corresponding Tuxedo documentation for details.

Information (including password) exchanged between TN3270 terminal emulator and

ARTTCP server is vulnerable unless SSL is enabled.

-L pnetaddr

This address is used by the system internally between ARTTCPL and ARTTCPH. 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.

[-m minh]

The minimum number of handler processes that will be started by ARTTCPL. The actual number of handler processes will always be between the minh and maxh based on system load.

Numeric, 1-4096. Default value is 1.

[-M maxh]

The maximum number of handler processes that will be started by ARTTCPL. The actual number of handler processes will always be between the minh and maxh based on system load.

Numeric, 1-4096. Default value is 4096.

[-x session-per-handler]

The number of sessions a ARTTCPH can maintain concurrently.

Numeric, 1-255. Default value is 32.

[-p profile-name]

The default security profile file name. Please refer to Security configuration for details.

String. The default value is ~/.tuxAppProfile.

[-z minencryptbits]

The minimum level of encryption required when a network link is being established between a TN3270 terminal emulator and ARTTCP.

-z must not exceed -Z. -z can only be 128, 256, the default is 128. If this minimum level of encryption cannot be met, link establishment fails.

Numeric. Default value is 128. This option is ignored if -S option is not specified.

[-Z maxencryptbits]

The maximum level of encryption required when a network link is being established between a TN3270 terminal emulator and ARTTCP.

-z must not exceed -Z. -Z can only be 128, 256, the default is 256.

Numeric. Default value is 256. This option is ignored if -S option is not specified.

[-t Application_list_transid]

This option specifies the transaction (application list TRANSID) to enable ARTTCP multiple session management function. You must also define this transaction in transactions.desc, using the same TRANSID.

For more information, see Implementing Using Multiple Session Management.

[-T minutes]

Enable timeout mechanism between ARTTCPL/ARTTCPH and TN3270 terminal emulators. Numeric (in minutes). This numeric is a threshold value, after which ARTTCPL/ARTTCPH begins to disconnect TN3270 terminal emulators if there isn't application data exchanged on the link. 0 means no timeout; a negative value is forbidden.

[-D ]

Enable Debug.

[+H trace-level]

Specify the trace level:

-1: trace off.

0: trace for all ARTTCPH.

n (n>0): trace the first n ARTTCPH.

[-K seconds]

Enable sending of keep-alive messages between ARTTCPL/ARTTCPH and TN3270 terminal emulators.

Numeric (in seconds). This numeric is a threshold value, after which ARTTCPL/ARTTCPH begins to send keep-alive messages to TN3270 terminal emulators. 0 means to use the system default value; a negative value means this keep-alive feature is disabled. This option only supports Linux and AIX platforms.