kc_tacclass_str - TAC classes for the application

The data structure kc_tacclass_str is defined for the object type KC_TACCLASS. In the case of KC_GET_OBJECT, UTM returns the following information in kc_tacclass_str:

• properties of the TAC class

• statistical information on how often and for how long jobs for the TAC class had to wait for processing

• the current maximum number of processes that may simultaneously process jobs for the transaction code of the TAC class if the application was generated without priority control (i.e. without the TAC-PRIORITIES statement).

mod 1	Data structure kc_tacclass_str
-	char tacclass[2];
x(A)2	char tasks[3];
x(A)2	char tasks_free[3];
-	char pgwt;
-	char waiting_msgs[10];
x(GIR)	char avg_wait_time_msec[10];
-	char prio[3];
x(GIR)	nr_calls[10];
x(GIR)	nr_waits[10];

1	The contents of the field can be modified with KC_MODIFY_OBJECT; see "obj_type=KC_TACCLASS"
2	These properties can only by modified if the application was generated without the TAC-PROPERTIES statement. Only one of these fields may be specified in a KC_MODIFY_OBJECT call.

The fields in the data structure have the following meanings:

tacclass
	Contains the number of the TAC class. A number between 1 and 16 is output for tacclass. The TAC classes from 1 to 8 are dialog TAC classes. The TAC classes from 9 to 16 are asynchronous TAC classes.
tasks	Only relevant if priority control was not generated for the TAC class (KDCDEF generation without TAC-PRIORITIES statement). Specifies how many processes of the application may process TACs of the TAC class tacclass at the same time (absolute number). See also "obj_type=KC_TACCLASS". If the application is generated with priority control, tasks contains a blank.
tasks_free
	Only relevant if the application was generated without the TAC-PRIORITIES statement. For dialog TAC classes tasks_free contains the minimum number of processes of the application that must be kept free for processing transaction codes from other TAC classes. For asynchronous TAC classes tasks_free contains the minimum number of processes that must be kept free for processing transaction codes from other asynchronous TAC classes. UTM returns '0' to tasks_free if the value of tasks_free was defined neither during KDCDEF generation nor by means of administration functions, or if a value was defined for tasks the last time the number of processes for the TAC class was modified. See also "obj_type=KC_TACCLASS". If the application is generated with priority control, tasks_free contains blanks.
pgwt	Specifies if program units that contain blocking calls, for example the KDCS call PGWT, are allowed to run in this TAC class.
	'Y'	Blocking calls are allowed in this TAC class.
	'N'	Blocking calls are not allowed in this TAC class.
	Program units containing blocking calls are allowed in at most one dialog TAC class and one asynchronous TAC class.
waiting_msgs
	Contains the number of jobs for transaction codes of this TAC class that are currently in temporary storage in UTM and that have not yet been processed.
avg_wait_time_msec
	Contains the average wait time of jobs in the job queue assigned to the transaction code of this TAC class. If there is no process for the TAC class, UTM accepts jobs for the TAC class (using free processes that are not “allowed” to process jobs to this TAC class) and temporarily stores them in the KDCFILE. This is always the case when there are jobs for TAC classes with a higher priority level (with priority control) or (in the case of process restriction) if the maximum number of processes that the TAC class is allowed to process has already been reached (see tasks, tasks_free). The time between accepting a job and starting to process it is the wait time displayed here. The value for avg_wait_time_msec is in milliseconds. The value of avg_wait_time_msec can be reset to 0. If this value is reset then the values of nr_calls and nr_waits is also implicitly reset.
prio	Contains the type of priority control generated for this TAC class.  The following values are possible:
	'ABS'	Absolute priorities: A free process is always assigned to the TAC class with the highest priority, i.e. priority 1 to 9, if jobs are waiting.The TAC class with the next lowest priority is not served until there are no more jobs with the higher priority level waiting in the TAC class.
	'REL'	Relative priorities: Free processes are more frequently allocated to higher TAC classes than to lower TAC classes if jobs are waiting to be processed.
	'EQ'	Equal priorities: If there are any jobs waiting, all TAC classes are served at an equal rate.
	'NO'	No priority control was generated.
nr_calls
	Number of program unit runs for this TAC class. You can reset the value to 0 using KC_MODIFY_OBJECT. If this value is reset then the values avg_wait_time_msec and nr_waits are also implicitly reset.
nr_waits
	Number of wait situations taken into account to calculate the value avg_wait_time_msec. You can reset the value to 0 using KC_MODIFY_OBJECT. If this value is reset then the values avg_wait_time_msec and nr_calls are also implicitly reset.