Parameter(s)

1.6.1.4 Parameter(s)

-n netaddr

This address specifies where TN3270 terminal emulators connect to ARTICTL 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 ARTICTL subsystem internally between TCPL and CTLH. 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 ARTICTL, 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, but it still must 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.

[-M maxh]

The maximum number of handler processes started by ARTICTL, 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 must 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 a CTLH can maintain concurrently in ARTICTL subsystem.

Numeric, 1-255. Default value is 32.

[-K seconds]

Specifies the keepalive message interval time, in seconds, between ARTICTL and 3270 terminal. It must be an integer smaller than the idle time that connection's max allows. If -K option is not set, no keepalive message will be send.

[-S ssladdr]

Specifies where 3270 terminal emulators connect to ARTICTL 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. ARTICTL 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.

[-p profile-name]

The name of the default security profile. This parameter is needed when Oracle Tuxedo security is enabled. Two types of security profile are supported: Oracle Wallet and profile created by genimsprofile.

For Oracle Wallet profile:

you need to create an Oracle Wallet using Oracle utility "orapki" or "mkstore" in advance. See Authentication Configuration in the Oracle Tuxedo Application Runtime for IMS User Guide for more details.
Oracle wallet profile name is prefixed with "file:" string and followed by a directory name pointing to the location of an Oracle Wallet. For example: file:/path/to/wallet

If no profile-name is provided, the default value is ~/.tuxAppProfile.

Note:

To join Tuxedo domain, ARTICTL only uses APP_PW stored in the security profile, the username/user password the ARTICTL uses comes from 3270 terminal.

-z minencryptbits

This option specifies the minimum level of encryption required when a network link is being established between a terminal and the ARTICTL handler. If this minimum level of encryption cannot be met, link establishment fails. This option is ignored if -S option is not specified.

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.

–Z maxencryptbits

This option specifies the maximum level of encryption allowed when a network link is being established between a terminal and the ARTICTL handler.

This option is ignored if -S option is not specified.

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.

[-d trace-level]

The -d option is used to set server's trace level. If not set, the default trace level is -1, 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.

Parent topic: ARTICTL