One name is created for each of the following control statements:
ACCESS-POINT
BCAMAPPL
CON
EDIT
KSET
LOAD-MODULE (BS2000 systems)
LPAP
LSES
LTAC
LTERM
MASTER-OSI_LPAP
MASTER-LU61-LPAP
MUX (BS2000 systems)
OSI-CON
OSI-LPAP
PROGRAM
PTERM
SHARED-OBJECT (Unix, Linux and Windows systems)
TAC
TLS
TPOOL
USER
ULS
Additional names are generated for the LTERM, MUX and TPOOL statements:
- If an application is generated without USER, two names are created for each LTERM statement.
Two names are created for an LTERM statement belonging to a PTERM statement with PTYPE=APPLI, SOCKET, UPIC-R or UPIC-L if the implicit (connection) user belonging to this LTERM is not generated with an explicit USER statement.
For each TPOOL statement, the number of names created is double that specified in the NUMBER= operand of the TPOOL statement. In the case of a TPOOL statement with PTYPE=APPLI, SOCKET, UPIC-R and UPIC-L the number of names created is threefold that specified in NUMBER=.
Two names are created for each MUX statement.
Unix, Linux and Windows systems:
Additional names are generated for the CLUSTER and CLUSTER-NODE statements:
One BCAMAPPL is also generated for the CLUSTER statement.
One PTERM, one LTERM and one USER are also generated for each CLUSTER-NODE statement.
Furthermore, up to six additional names are created during generation, which are required by openUTM for event services (KDCSGNTC, KDCBADTC, KDCMSGTC, KDCMSGUS, KDCMSGLT, KDCAPLKS). The first three names can also be specified in a TAC statement. The last three names may not be specified.
If XATMI program units are generated for a UTM application, i.e. if API=(XOPEN,XATMI) is set in at least one TAC statement, then a TAC entry named KDCTXCOM and a PROGRAM entry named KDCTXRLB are created by openUTM.
The name KDCDLETQ is created for the dead letter queue during generation. The properties of this TAC queue can also be defined in a separate TAC statement.
Maximum values for names
The table below shows the maximum number of names that can be created using KDCDEF control statements. If this number is exceeded, then the generation is terminated.
Group of KDCDEF control statements | Maximum number of generated names |
BS2000 systems | |
#PTERM + #CON + TPOOLNR + #OSI-ASSOCIATIONS + #MUX1 | <= 500 000 |
#LTERM + #LPAP + TPOOLNR + #OSI-LPAP + #TASKS + #MUX1 + 1 | <= 500 000 |
Unix, Linux and Windows systems | |
#PTERM + #CON + TPOOLNR + #OSI-ASSOCIATIONS | <= 500 000 |
#LTERM + #LPAP + TPOOLNR + #OSI-LPAP + #TASKS + 1 | <= 500 000 |
BS2000, Unix, Linux and Windows systems | |
#USER + #APPLI + #LSES + #OSI-ACTIVE-ASSOCIATIONS + (2 * #TASKS) + 1 | <= 500 000 |
#PROGRAM | <= 32 000 |
#TAC + 4 | <= 32 000 |
#LSES | <= 65 000 |
#CON | <= 65 000 |
#KSET + 1 | <= 32 000 |
#LTAC | <= 32 000 |
#MUX1 | <= 9 999 |
Total of all other names + 2 | <= 32 767 |
1Only on BS2000 systems
Description of placeholders:
#statement | Number of names generated using this KDCDEF statement |
#APPLI | Number of PTERM statements plus the TPOOLNR values of the TPOOL statements with PTYPE=APPLI/SOCKET/UPIC-R and UPIC-L (UPIC-L only on Unix, Linux and Windows systems) In the case of UTM cluster applications, the values of #PTRM, #LTRM and #APPLI are each increased by the number of specified CLUSTER-NODE statements. |
#MUX | Total number of generated MUX statements (only on BS2000 systems) |
#OSI-ACTIVE-ASSOCIATIONS | |
Number of active parallel OSI connections of the generated operand values (OSI-CON ...,ACTIVE=YES and associated OSI-LPAP...,ASSOCIATIONS=number). This is the sum of all ASSOCIATIONS values in all OSI-LPAP statements. | |
#OSI-ASSOCIATIONS | |
#OSI-ACTIVE-ASSOCIATIONS plus the number of inactive parallel OSI-connections. (OSI-CON ...,ACTIVE=YES/NO and associated OSI-LPAP...,ASSOCIATIONS=number). This is the sum of all ASSOCIATIONS values in all OSI-LPAP statements, including the values of OSI-LPAP statements for which backup connections are generated. | |
TPOOLNR | Sum of all NUMBER= operands (number of LTERM partners in each LTERM pool) in all generated TPOOL statements |
The following must also be noted:
The number of names for #PROGRAM, #TAC, #LTERM, #PTERM, #USER, #KSET and #LTAC includes names generated statically and reserved names for objects that can be entered dynamically.
The names of MASTER-LU61-LPAP statements must also be counted with #LPAP.
The names of MASTER OSI-LPAP statements must also be counted for #OSI-LPAP.
If the application was generated without USER statements, #USER must be replaced by #LTERM + TPOOLNR in the first condition.
You can generate up to 100 ULS blocks and 100 TLS blocks.
The number of generated user IDs (#USER) plus the number of entries intended for service stacking (defined in MAX NRCONV=) is restricted to a maximum of 500000.
The number of generated user IDs (#USER) plus the number of entries intended for service stacking (MAX NRCONV) plus the maximum number of possible parallel asynchronous services (defined in MAX ASYNTASKS = (...,service_number)) plus the number of entries reserved for sign on services (SIGNON CONCURRENT-TERMINAL-SIGNON) is restricted to a maximum of 665000.