1. Application Runtime for CICS Reference Guide
  2. ServerConfiguration
  3. Configuration Reference of CICS Runtime Servers
  4. ARTCNX Configuration
  5. Parameters

10.3.14.4 Parameters

CONV
The generic parameter CONV is mandatory for this server type, and must be defined as CONV=Y, because ARTSTRN is conversational.
minn and maxn
Must be set to 1. This will still be true in the next release, where each server will be allocated a range of terminal identifiers (see CLOPT for more details)
CLOPT
-t
A string of command-line options that is unique in global scope for ARTCNX and is passed to the ARTCNX when it is booted. The following run-time parameter is recognized:

[-t] (x is included in these ranges, "0 to 9", "A to Z" or "a to z").

Optional parameter used for determine the terminals number (TRMID).

If the parameter is not set you can start only one ARTCNX server (this restriction is checked at start), in this case the terminals number is between 0 to 25,411,680 (0000 to zzzz in base 71).

If you use this parameter, you can start up to 62 ARTCNX servers, each server has up to 357,911 terminals numbers, between 0 to 357,910 (000 to zzz in base 71), in this case the TRMID is composed as follow: x000 to xzzz (x is the character in -t parameter).

Note:

  • ARTCNX will check whether -t is unique in global scope when booting; if it is not, ARTCNX fails to boot.
  • You can use -t to change the auto-assigned TERMID prefix, but make sure the auto-assigned TERMID is not same as the one defined in terminals.desc.
-s
Specifies the SYSID of a CICS region (the region which ARTCNX belongs to). The SYSID is limited to 4 characters and must be unique in each CICS region.
-a
Specifies the APPLID of a CICS region (the region which ARTCNX belongs to). The APPLID is limited to 8 characters.

Note:

Users must set either -s or -a to configure at least one ARTCNX for each CICS region to associate the initialization parameters which are defined in system.desc; otherwise, if users set -s together with -a, warning messages will occur in ULOG, only -s will take effect, and -a will be ignored.
-l:
Specifies the resource group where ARTCNX must install. The resource is always terminals.
-L:
Specifies the list of resource groups where ARTCNX must install.

Note:

For both -l and -L options, if there are multiple ARTCNX in one ART CICS region and -s is configured in such region, please set the same value for all -l specified in this region, and set the same value for all -L specified in this region. For more information about -L configurations, please refer to List of Groups Configuration File.

Parent topic: ARTCNX Configuration