Output is listed by type. The display shows all properties (LIST!=
KDCNAMES).
When you enter KDCINF ALL,LIST=KDCALL, with the exception of information about load modules and shared objects, all the items listed in the following section are output in succession.
type=CON
The output depends on whether a short or a long host name is assigned to a CON object. In the case of a long host name, the information on a CON object is output in two screen lines.
CON PRONAM LPAP BCAMAPPL STA CONNECT CTIME LETTERS CONB con proname lpap applname ON|OFF Y|N|W A minutes number number CON PRONAM LPAP BCAMAPPL STA CONNECT CTIME LETTERS CONB con long.processor.name lpap applname ON|OFF Y|N|W A minutes number number
Explanation of the output
CON | The name for the logical connections to the partner application lpap created with KC_CREATE_OBJECT for the object type KC_CON or generated with the KDCDEF control statement CON. |
PRONAM | Name of the computer on which the partner application runs. |
LPAP | Logical name of the partner application for which the logical connection was generated. |
BCAMAPPL | Name of the local UTM application (BCAMAPPL name) via which the connection to the partner application is established. |
STA | Status of the partner application: ON: |
CONNECT | Several items of information are supplied here. 1st column: 2nd column: |
CTIME | Duration of connection time in minutes. |
LETTERS | Number of messages that have been exchanged via the connection since the application started, i.e. the number sent or received by the local application. |
CONB | Indicates how often the connection has failed since the application started. The CONB counter is reset to 0 every time the application starts. |
type=KSET
The output illustrated below is only produced if a value <= 255 is specified in the MAX statement for the KEYVALUE operand during KDCDEF generation, i.e. if the application does not permit key codes with a number > 255.
KSET:kset
|
|
|
|
|
|
|
|
|
|
|
| |
|
|
| ||||||||||
|
|
|
| |||||||||
|
|
| ||||||||||
| ||||||||||||
|
| |||||||||||
| ||||||||||||
| ||||||||||||
|
Explanation of the output
KSET | Name of the key set |
In the first line of the output, all key codes between 1 and 19 in the key set are displayed. Line two contains all key codes with numbers between 20 and 39 etc.
The last line displays key codes with numbers between 240 and 259.
The output illustrated here signifies that key set kset contains key codes 1, 4, 23, 25, 26, 42, 58 and 80.
type=LOAD-MODULE (BS2000 systems)
LOAD-MODULE lmodname VERSION (GENERATED) generated element version VERSION (PREVIOUS) previous element version VERSION (CURRENT) current element version LIBRARY name of program library LOAD MODE STATIC| STARTUP| ONCALL| POOL| POOL/STARTUP| POOL/ONCALL CHANGEABLE YES| NO AUTOLINK YES| NO PROGRAM LIST program1 program2 program3 program4
Explanation of the output
LOAD-MODULE | ||
Name of the load module up to 32 characters in length. | ||
VERSION (GENERATED) | ||
Generated version of the load module | ||
VERSION (PREVIOUS) | ||
Preceding version of the load module | ||
VERSION (CURRENT) | ||
Currently loaded version of the load module | ||
LIBRARY | Name for the program library of up to 54 characters loaded from the load module | |
LOAD MODE | Load mode for the load module; the following modes are possible: | |
STATIC | Load mode for the load module; the following modes are possible: | |
STARTUP | The load module is loaded dynamically as an independent unit whenever the application starts. | |
ONCALL | The load module is loaded dynamically as an independent unit when a program unit or VORGANG exit assigned to the load module(s) is called for the first time. | |
POOL | The load module is loaded into the common memory pool whenever the application starts. The load module does not contain a private slice. | |
POOL/STARTUP | ||
The public slice of the load module is loaded into the common memory pool when the application starts. The private slice belonging to the load module is then loaded into the local process memory. | ||
POOL/ONCALL | ||
The public slice of the load module is loaded into the common memory pool when the application starts. The private slice belonging to the load module is loaded into the local process memory when the first program unit assigned to this load module is called. | ||
CHANGEABLE | ||
Display showing whether or not the load module can be replaced during live operation. | ||
AUTOLINK | Indicates whether the load module was loaded with the BLS autolink function. | |
PROGRAM LIST | ||
List of names of all program units and data areas (AREAs) assigned to the load module. The list also contains the names of all deleted objects. |
type=LPAP
LPAP KSET STATUS OUT-Q IDLETIME MASTER BUNDLE lpap kset ON|OFF Q number seconds master M|Y|N
Explanation of the output
LPAP | Logical name of the partner application in the local application (name of the LPAP partner) |
KSET | Key set assigned to the partner application. The key set defines access rights to the partner application for the local application. |
STA | Status of the partner application: 1st column: 2nd column: |
OUT-Q | Number of messages in the message queue that still have to be sent to the partner application. |
IDLETIME | Time until the disconnection of an unused connection (session) between the partner application and the local application. |
MASTER | If the LPAP partner forms part of an LU6.1-LPAP bundle then the name of the master LU6.1-LPAP of the bundle is displayed |
BUNDLE | Specifies whether the LPAP partner belongs to an LU6.1-LPAP bundle. M Y N |
type=LSES
The output depends on whether a short or a long host name is assigned to a LSES object. In the case of a long host name, the information on a LSES object is output in two screen lines.
LSES RSES LPAP CON PRONAM BCAMAPPL AG/USER lses rses lpap con proname applname user LSES PRONAM CON BCAMAPPL RSES LPAP AG/USER lses long.processor.name con applname rses lpap user
Explanation of the output
LSES | Name of the LU6.1 session in the local application |
RSES | Name of the session in the partner application |
LPAP | Logical name of the partner application for which the session is generated. |
CON, PRONAM, BCAMAPPL | |
Uniquely identifies the logical connection which was established for the session. con is the name created with KC_CREATE_OBJECT for the object type KC_CON or generated with the KDCDEF control statement CON for the logical connections to partner application lpap. proname is the name of the computer on which the partner application lpap is running. applname is the name of the local UTM application (BCAMAPPL name), via which the connection to the partner application was established. | |
AG/USER | |
Name of the job submitter for whom the session is reserved. user indicates who started the job-submitting service. If the job-submitting service is running in the local application then the user ID or LTERM partner which started the service is entered against user. If the job-submitting service is running in the partner application (the local application is processing the job) or if asynchronous messages are transferred to the session, the local session name (LSES name) is issued for user, i.e. the outputs for LSES and AG/USER are identical. |
type=LTAC
LTAC LOCK STATUS RTAC CODE LPAP ACCESSWAIT REPLYWAIT USED D ltac number ON|OFF rtac I|P|T lpap seconds seconds number D
Explanation of the output
LTAC | Local TAC name for the service program in the partner application | |
LOCK | Lock code assigned to the remote service in the local application (access protection); a number between 1 and 4000. | |
STATUS | The transaction code LTAC is disabled (OFF) or not disabled (ON). | |
RTAC | Name of the transaction code/service program in the partner application | |
CODE | Indicates which code type is used internally by UTM for the RTAC name. | |
I | Integer code type | |
P | PRINTABLE-STRING code type | |
T | T61 string code type | |
LPAP | Logical name of the partner application in the local application (name of the LPAP partner). | |
ACCESSWAIT | ||
Length of time openUTM waits for a session to be occupied (can include the time to establish a connection) when the remote service program starts; | ||
REPLYWAIT | Maximum length of time which UTM waits for a response from the remote service. The time is defined for KDCDEF generation and can be adjusted by administration (e.g. KDCAPPL TAC). | |
USED | Number of jobs issued to this LTAC since the application started. | |
D | Specifies whether the LTAC has been deletetd via dynamic administration or not (no entry). |
type=LTERM
LTERM PTERM USER KSET LOCK USAGE STATUS OUT-Q INCNT SECCNT D lterm pterm user kset lock D|O ON|OFF number number number D B|M|S| P|G|A
Explanation of the output
LTERM | Name of the LTERM partner; logical name of the assigned client/printer. |
PTERM | Name of the client or printer (PTERM name) to which this LTERM partner is assigned. |
USER | User ID of the user currently connected to the application through this LTERM partner. If there is currently no connection, then user_curr contains blanks.
|
KSET | Key set assigned to the LTERM partner (access rights). |
LOCK | Lock code assigned to the LTERM partner (access protection). |
USAGE | Type of LTERM partner 1st value: 2nd value: 3rd value: |
STATUS | The LTERM partner is disabled (OFF) or not disabled (ON). |
OUT-Q | Number of messages that still have to be output for the LTERM partner. |
STATUS | Number of messages entered via this LTERM partner; if a printer is connected to the LTERM partner, the number of print job confirmations is entered here. The INCNT counter is reset to 0 every time the application starts. |
SECCNT | Number of security violations on this LTERM partner since the start of the application (e.g. unauthorized codes entered). |
D | Indicates whether the LTERM partner was deleted by dynamic administration (D) or not (no entry). |
type=MUX (BS2000 systems)
MUX PRONAM BCAMAPPL STATUS CONNECT MAXSES ACTCON MAXCON mux1 proname applname ON Y A number number number OFF N W
Explanation of the output
MUX | Name of the multiplex connection |
PRONAM | Name of the processor on which the message router runs. |
BCAMAPPL | Name of the local application (BCAMAPPL name) through which the multiplex connection is established. |
STATUS | The multiplex connection is disabled (OFF) or not disabled (ON). |
CONNECT | Here, several items of information are provided. 1st value: 2nd value: |
MAXSES | Number of terminals that can be connected to the application at the same time using this multiplex connection. |
ACTCON | Number of terminals that are at present connected to the application using this multiplex connection. |
MAXCON | Maximum number of terminals that were connected to the application at the same time using this MUX connection. |
MUX,OPTION=MONITORING (BS2000 systems)
MUX PRONAM BCAMAPPL LETTERS INCNT WAIT SHORT RTRYO RTRYI mux1 proname applname number number number number number number
Explanation of the output
MUX | Name of the multiplex connection. |
PRONAM | Name of the processor on which the message router is running. |
BCAMAPPL | Name of the local application (BCAMAPPL name) via which connection to the multiplex connection is established. |
LETTERS | Number of the input and output messages for this multiplex connection since the application started. |
INCNT | Number of input messages received through this multiplex connection. |
WAIT | Number of requests since the application started that were passed from BCAM to the multiplex connection requiring the resending of a message which it was previously not possible to accept because of a BCAM shortage (WAIT FOR GO) from BCAM. |
SHORT | Number of BCAM shortages for this multiplex connection since the start of the application. |
RTRYO | Number of tries to send an output message again since the start of the application (retry out). |
RTRYI | Number of tries to read an input message again since the start of the application (retry in). |
type=OSI-ASSOCIATIONS
ASSOC-ID OSI-LPAP OSI-CON CONTWIN CON-STATE CONTIME REQ-CALLS IND-CALLS assoc-id osi-lpap osi-con Y|N CONNECTED| minutes number number WAIT-GO| STOP
Explanation of the output
ASSOC-ID | ID assigned to the association when it was established. This is only unique while the association remains established. If the association is terminated, the ID is released and can be assigned to another established association. | |
OSI-LPAP | Logical name of the partner application (name of the OSI-LPAP partner) for which the association was generated. | |
OSI-CON | The OSI-CON name generated with the KDCDEF control statement for the logical connection to the partner application osi-lpap. If no connection is established, blanks are output at this point. | |
CONTWIN | Indicates whether the local application for this association is the contention winner or the contention loser. | |
CON-STATE | Indicates the status of the association. | |
CONNECTED | The association is established. | |
WAIT-GO | The association is being established. It is waiting for a “GO” from OSS. | |
STOP | The association is being established. The OSS call a_assrs has run up to “STOP”. | |
CONTIME | Indicates the length of time in minutes for which the connection has existed. | |
REQ-CALLS | Number of request/response presentation calls to OSS since the association was established. | |
IND-CALLS | Number of indication/confirmation presentation calls to OSS since the association was established. |
type=OSI-CON
The output depends on whether a short or a long host name is assigned to an OSI-CON object. In the case of a long host name, the information on an OSI-CON object is output in two screen lines.
OSI-CON N-SEL T-SEL ACC-PNT OSI-LPAP ACTIVE osi-con proname applname access-point osi-lpap Y|N OSI-CON N-SEL T-SEL ACC-PNT OSI-LPAP ACTIVE osi-con long.processor.name applname access-point osi-lpap Y|N
Explanation of the output
OSI-CON | Name of the logical connection to the partner application osi-lpap . |
OSI-LPAP | Logical name of the partner application in the local application (name of the OSI-LPAP partner) for which the connection was generated. |
T-SEL | Application name of the partner application in the local system (transport selector). |
N-SEL | Logical name of the computer on which the partner application is running (network selector). |
ACC-PNT | Name of the local access point via which the connection osi-con is established. |
ACTIVE | Y N |
type=OSI-LPAP
OSI-LPAP KSET STA Q OUT-Q IDLET OSI-CON ASSOC CONN AUTOC BU osi-lpap kset ON|OFF Q number seconds osi-con number number number M|S
Explanation of the output
OSI-LPAP | Logical name of the partner application in the local application (name of the OSI-LPAP partner). |
KSET | Key set assigned to the OSI-PAP partner. The key set defines access rights to the partner application for the local application. |
STATUS | Status of the partner application: ON |
Q (Quiet): | No more dialog jobs will be accepted for the OSI-LPAP partner. |
OUT-Q | Number of messages in the message queue which still have to be sent to the partner application. |
IDLETIME | Time to monitor the idle state of sessions between the partner application and the local application. |
OSI-CON | The OSI-CsON name generated with the KDCDEF control statement for the logical connection to the partner application. |
ASSOC | Maximum number of parallel connections (associations) to the OSI-LPAP partner that can exist at the same time. The number is defined during KDCDEF generation in the OSI-LPAP statement. |
CONNECT | Number of connections to the OSI-LPAP partner existing at the present time or currently being set up. |
AUTOCON | Number of connections to the OSI-LPAP partner which UTM should establish automatically when the application starts. |
BU (bundle) | Specifies whether the OSI-LPAP partner belongs to an OSI-LPAP bundle. M S |
type=PAGEPOOL
PAGEPOOL INFORMATION percent % PAGES FOR GSSB percent % PAGES FOR LSSB percent % PAGES FOR TLS percent % PAGES FOR ULS percent % PAGES FOR DIALOG SERVICES percent % PAGES FOR TAC-CLASSES percent % PAGES FOR FPUT-MANAGEMENT percent % PAGES FOR ASYN MESSAGES percent % PAGES FOR MSGTAC MESSAGES percent % PAGES FOR LPUT percent % PAGES FOR PHYS. MESSAGES percent % PAGES FOR RESET MESSAGES percent % PAGES FOR OSI TP LOG RECORDS percent % OTHER PAGES percent % FREE PAGES
Explanation of the output
PAGES FOR GSSB
Number of pages, in percent, which are utilized for GSSBs.
PAGES FOR LSSB
Number of pages, in percent, which are utilized for LSSBs.
PAGES FOR TLS
Number of pages, in percent, which are utilized for TLS areas.
PAGES FOR ULS
Number of pages, in percent, which are utilized for ULS areas.
PAGES FOR DIALOG SERVICES
Number of pages, in percent, which are utilized for service contexts by users.
PAGES FOR TAC-CLASSES
Number of pages, in percent, which are utilized for dialog input messages, and which are temporarily stored in TAC Class Queues.
PAGES FOR FPUT-MANAGEMENT
Number of pages, in percent, which are utilized for managing asynchronous messages.
PAGES FOR ASYN MESSAGES
Number of pages, in percent, which are utilized for asynchronous messages.
PAGES FOR MSGTAC MESSAGES
Number of pages, in percent, which are utilized for MSGTAC messages.
PAGES FOR LPUT
Number of pages, in percent, which are utilized for temporarily stored LPUT records.
PAGES FOR PHYS. MESSAGES
Number of pages, in percent, which are utilized for output messages and which need to be temporarily stored because they can only be transferred to the transport system in sections owing to their length.
PAGES FOR RESET MESSAGES
Number of pages, in percent, which are utilized for reset messages.
PAGES FOR OSI TP LOG RECORDS
Number of pages, in percent, which are utilized for OSI TP log records.
OTHER PAGES
Number of other utilized pages, in percent.
FREE PAGES
Number of free pages, in percent.
In the case of UTM cluster applications, GSSB and ULS areas are stored in the global page pool of the UTM cluster application. As KDCINF PAGEPOOL only displays the utilization of the local page pool, the values for GSSB and ULS are always zero in UTM cluster applications.
type=POOL
The output depends on whether a short or a long host name is assigned to a LTERM pool object. In the case of a long host name, the information on a LTERM pool object is output in two screen lines.
POOL PRONAM BCAMAPPL PTYPE STATIONS STA=ON ACTCON MAXCON KSET LOCK ltprefix proname applname ptype number number number number kset lock POOL PRONAM BCAMAPPL PTYPE STATIONS STA=ON ACTCON MAXCON KSET LOCK ltprefix long.processor.name applname ptype number number number number kset lock
Explanation of the output
POOL | LTERM prefix of the LTERM pool. The names of the LTERM partners assigned to the pool comprise ltprefix and a serial number between 1 and the maximum number of clients allowed to connect to the LTERM pool at the same time. |
PRONAM | Only clients located on computer proname can establish connections to the application using the LTERM pool. In the case of applications on Unix, Linux or Windows systems, blanks are entered for proname if the LTERM pool is defined for locally connected clients. |
BCAMAPPL | Name of the local application (BCAMAPPL name) through which the connections to this LTERM pool were established (see KDCDEF statement TPOOL operand BCAMAPPL). |
PTYPE | Physical type of client allowed to connect to the application through this LTERM pool. |
STATIONS | Maximum number of clients allowed to connect to the application at the same time using this LTERM pool. |
STA=ON | Number of clients currently allowed in the LTERM pool. |
ACTCON | Number of clients connected to the application at the present time through this pool. |
MAXCON | Maximum number of clients connected to the application during the current application run using this LTERM pool. |
KSET | Key set assigned to the LTERM pool, and therefore to all clients connected to the application by this LTERM pool (access rights). |
LOCK | Lock code assigned to the LTERM pool (access protection). |
type=PROG
For KDCINF PROG,L=KDCALL,CONT=programname
Output for UTM applications on BS2000 systems
PROGRAM | LOAD-MODULE | L-MODE | CHN | D |
program1 | load module1 | load mode | YES | NO | D |
Output for UTM applications on Unix, Linux and Windows systems
PROGRAM | SHARED-OBJECT | L-MODE | CHN | D |
program1 | shared object1 | load mode | YES | NO | D |
Explanation of the output
PROGRAM
Name of the program unit as specified during generation in the PROGRAM statement; up to 32 characters in length.
LOAD-MODULE
Name of the load module on BS2000 systems to which this program unit is assigned; up to 32 characters in length.
SHARED-OBJECT
Name of the shared object/DLL on Unix, Linux and Windows systems to which this program unit is assigned; up to 32 characters in length.
L-MODE
Load mode of the load module/shared object/DLL to which this program unit is assigned. Key to terms:
STATIC
The load module/shared object/DLL is incorporated as a static element in the application program.
STARTUP
The load module/shared object/DLL is loaded dynamically as an independent unit whenever the application is started.
ONCALL
The load module/shared object/DLL is loaded as an independent unit whenever a program unit or VORGANG exit assigned to the load module/shared/DLL is called for the first time.
Only on BS2000 systems:
POOL
The load module is loaded into the common memory pool whenever the application starts. The load module does not contain a private slice.
POOL/STARTUP
The public slice of the load module is loaded into the common memory pool whenever the application starts. The private slice belonging to the load module is then loaded into the local process memory.
POOL/ONCALL
The public slice of the load module is loaded into the common memory pool whenever the application starts. The private slice belonging to the load module is loaded into the local process memory when the first program unit assigned to this load module is called.
CHANGEABLE
Displays whether or not the load module/shared object/DLL to which this program unit is assigned can be exchanged.
D
Indicates whether the program was deleted from the configuration by means of system administration functions (D) or not (no entry).
type=PTERM
The output depends on whether a short or a long host name is assigned to a PTERM object. In the case of a long host name, the information on a PTERM object is output in two screen lines.
PTERM PRONAM LTERM BCAMAPPL PTYP STA CONNECT CTIME LETTERS CONB D pterm proname lterm applname ptype ON|OFF Y|N|W A|P M minutes number number D T|E pterm long.processor.name lterm applname ptype ON|OFF Y|N|W A|P M minutes number number D T|E
Explanation of the output
PTERM | Name of the client or printer (PTERM name). |
PRONAM | Name of the computer on which the client/printer is located. In UTM applications on Unix, Linux or Windows systems blanks are output for local clients/printers. |
LTERM | Name of the LTERM partner (logical name) to which this client/printer is assigned. |
BCAMAPPL | Name of the local UTM application (BCAMAPPL name) via which the connection to the client/printer is established. |
PTYP | Type of client/printer (for the meaning of the output, see chapter "kc_pterm_str - Clients and printers" (BS2000 systems or Unix, Linux and Windows systems) |
STA | The client/printer is disabled (OFF) or not disabled (ON). |
CONNECT | Several items of information are provided here.
|
CTIME | Duration of the existing connection in minutes. |
LETTERS | Number of input and output messages for the client or output messages to the printer since the application started. |
CONB | Number of connection failures between client/printer and application since the application started. The CONB counter is reset to 0 every time the application starts. In UTM applications on BS2000 systems, the CONB counter also counts incrementally if a UPIC client first shuts down its connection to the UTM application and then establishes a new connection using the same PTERM name. |
D | Indicates whether the client/printer was deleted (D) or not (no entry) from the configuration by means of system administration functions. |
type=SHARED-OBJECT (Unix, Linux and Windows systems)
For KDCINF SHARED-OBJECT, L=shared-object-name, CONT=programname
SHARED-OBJECT shared object name VERSION (PREVIOUS) old version VERSION (CURRENT) new version LIBRARY name of program directory LOAD MODE STATIC|STARTUP|ONCALL CHANGEABLE YES|NO PROGRAM LIST program1 program2 program3 program4
Explanation of the output
SHARED-OBJECT | ||
Name of the shared object/DLL; up to 32 characters in length | ||
VERSION (PREVIOUS) | ||
Previous version of the shared object/DLL. | ||
VERSION (CURRENT) | ||
Currently loaded version of the shared object/DLL. | ||
LIBRARY | Name for the program library of up to 54 characters loaded from the shared object/DLL. | |
LOAD MODE | Load mode for the shared object/DLL. Key to the terms used: | |
STATIC | The shared object/DLL is incorporated as a static element in the application program. | |
STARTUP | The shared object/DLL is loaded dynamically as an independent unit whenever the application starts. | |
ONCALL | The shared object/DLL is loaded as an independent unit whenever a program unit or VORGANG exit assigned to the same shared object/DLL(s) is called for the first time. | |
CHANGEABLE | ||
Displays whether or not the shared object/DLL can be replaced during run time. | ||
PROGRAM LIST | ||
List of the names of all program units and data areas (AREAs) assigned to the shared object/DLL. |
type=STATISTICS
name APPLINAME version VERSION OF UTM yy-mm-dd GEN APPLICATION DATE hh:mm:ss GEN APPLICATION TIME yy-mm-dd START APPLICATION DATE hh:mm:ss START APPLICATION TIME yy-mm-dd CURRENT DATE hh:mm:ss CURRENT TIME number TERMINAL INPUT MESSAGES number TERMINAL OUTPUT MESSAGES number CURRENT TASKS number CONNECTED USERS number OPEN DIALOG SERVICES number OPEN ASYN SERVICES percent % CURRENT LOAD percent % MAXIMUM LOAD number DIALOG TAS PER SECOND number ASYN TAS PER SECOND number DIALOG STEPS PER SECOND percent % MAXIMUM POOL SIZE percent % ACTUAL POOL SIZE percent % AVERAGE POOL SIZE percent % CACHE HIT RATE number NR CACHE SEARCHES percent % CACHE WAITS FOR BUFFER number NR CACHE REQUESTS number UNPROCESSED ATACS number UNPROCESSED PRINTS number WAITING DPUTS number ABNORMAL TERMINATED SERVS number LOGFILE WRITES number UTM-DEADLOCKS number PERIODIC WRITES number PAGES PER PERIODIC WRITE percent % WAITS FOR RESOURCES number NR RESOURCE REQUESTS percent % MAX WAITS FOR RESOURCES number NR RES REQUESTS FOR MAX percent % WAITS FOR SYSTEM RES number NR SYSTEM RES REQUESTS percent % MAX WAITS FOR SYSTEM RES number NR SYSTEM RES REQ FOR MAX percent % ACTUAL JR percent % MAXIMUM JR number AVG COMPRESS PAGES SAVED
Explanation of the output
APPLINAME
Name of the application that was defined during KDCDEF generation for MAX APPLINAME.
VERSION OF UTM
openUTM version used with correction status
GEN APPLICATION DATE
Date of the generation run of the application
GEN APPLICATION TIME
Time of the generation run of the application
START APPLICATION DATE
Day of the last cold start of the application (UTM-S application);
day of the last start of the application (UTM-F application)
START APPLICATION TIME
Time of the last cold start of the application (UTM-S application);
Time of the last start of the application (UTM-F application)
CURRENT DATE
Current date
CURRENTN TIME
Current time
TERMINAL INPUT MESSAGES
Total number of messages received by the application from clients or partner applications during the last full hour.
TERMINAL OUTPUT MESSAGES
Total number of messages sent by the application to clients, printers or partners during the last full hour.
CURRENT TASKS
Current number of processes in the application.
CONNECTED USERS
Number of users connected to the application at the present time.
OPEN DIALOG SERVICES
Number of dialog services open at the present time.
OPEN ASYN SERVICES
Number of asynchronous services open at the present time.
CURRENT LOAD
Current load of the application during the last completed period of 100 seconds as a percentage.
The value in this field indicates the current load of the processes of the application in processing jobs. If the value is very high, additional processes should be started for the application.
MAXIMUM LOAD
Maximum load of the UTM application since startup or since the last time the value was reset as a percentage.
DIALOG TAS PER SECOND
Number of dialog transactions per second being executed at the present time.
ASYN TAS PER SECOND
Number of asynchronous transactions per second being executed at the present time.
DIALOG STEPS PER SECOND
Number of dialog steps per second being executed at the present time.
MAXIMUM POOL SIZE
Maximum allocation of page pool space in percent. In UTM-S applications, the value is set to 0 when the application is generated for the first time with KDCDEF or updated with KDCDEF/KDCUPD. With UTM-F applications, the value is set to 0 each time the application is started.
ACTUAL POOL SIZE
Allocation of page pool space in percent at the present time.
AVERAGE POOL SIZE
Average allocation of page pool space in percent. In UTM-S applications, the value is set to 0 when the application is generated for the first time with KDCDEF or updated with KDCDEF/KDCUPD. With UTM-F applications, the value is set to 0 each time the application is started.
For this value to be meaningful, many dialog steps must already have been processed.
CACHE HIT RATE
Hit rate for a page search in cache memory. Figure quoted in percent. CACHE HIT RATE is reset to 0 before every application start.
NR CACHE SEARCHES
Number of search operations for UTM pages in the cache taken into account to calculate the value of CACHE HIT RATE.
CACHE WAITS FOR BUFFER
Buffer calls in cache that have resulted in a wait time. Figure quoted in percent.
CACHE WAITS FOR BUFFER is reset to 0 after every full hour.
NR CACHE REQUESTS
Number of buffer requests taken into account to calculate the value of CACHE WAITS FOR BUFFER.
UNPROCESSED ATACS
Number of messages for asynchronous services currently stored in openUTM that have not been completely processed.
UNPROCESSED PRINTS
Number of messages currently queued for the printers.
WAITING DPUTS
Number of time-driven jobs currently waiting (DPUTs)
ABNORMAL TERMINATED SERVS
Number of abnormally terminated services. In UTM-S applications, the value is set to 0 when the application is generated for the first time with KDCDEF or updated with KDCDEF/KDCUPD. With UTM-F applications, the value is set to 0 each time the application is started.
LOGFILE WRITES
Number of calls written to the user log file (USLOG). The LOGFILE WRITES counter is reset to 0 after every full hour.
UTM-DEADLOCKS
Number of recognized and resolved deadlocks affecting UTM resources. In UTM-S applications, the value is set to 0 when the application is generated for the first time with KDCDEF or updated with KDCDEF/KDCUPD. With UTM-F applications, the value is set to 0 each time the application is started.
PERIODIC WRITES
Number of periodic writes since the last application start.
(Periodic write = backup of all log-related administration data on the UTM application).
PAGES PER PERIODIC WRITE
Average number of UTM pages backed up during a periodic write.
The counter is reset to 0 every time the application starts.
WAITS FOR RESOURCES
This value indicates the average lock conflict rate for the GSSB, ULS and TLS memory areas during the last 100 second interval as an amount per thousand, i.e. the total number of wait situations on lock requests as a ratio of GSSB, ULS and TLS lock requests in the last 100 second interval multiplied by 1000.
A high value for WAITS FOR RESOURCES can have the following causes:
- Processes with excessively long run times or wait times,
Resource disabled for too long, e.g. frequent PEND KP or PGWT calls to KDCS program units.
If a lock holder enters the status PEND KP then all "Waiters" are informed and all further locks are rejected immediately. I.e. the value of WAITS FOR RESOURCES does not increase as a result.
NR RESOURCE REQUESTS
Number of requests for transaction resources during the last 100 second interval taken into account to calculate the value of WAITS FOR RESOURCES.
MAX WAITS FOR RESOURCES
Maximum conflict rate for user data locks across the application run. The value is specified as a percentage
NR RES REQUESTS FOR MAX
Number of requests for transaction resources in the 100 second interval in which the maximum conflict rate MAX WAITS FOR RESOURCES was reached.
WAITS FOR SYSTEM RES
Average conflict rate in the last 100 second interval for the most heavily loaded system resource. The output in different intervals can refer to different system resources. The value is specified as a percentage.
NR SYSTEM RES REQUESTS
Number of requests for system resources during the last 100 second interval taken into account to calculate the value of WAITS FOR SYSTEM RES.
MAX WAITS FOR SYSTEM RES
Maximum conflict rate for requests for system resources (system locks) across the application run. The value is specified as a percentage.
NR SYSTEM RES REQ FOR MAX
Number of requests for system resources in the 100 second interval in which the maximum conflict rate MAX WAITS FOR SYSTEM RES was reached.
ACTUAR JR
Only for distributed processing:
Current number of simultaneously addressed job-receiving services relative to generation value MAXJR, figure quoted in percent.
(MAXJR = maximum number of job-receiving services that can be addressed simultaneously in the local application; this corresponds to the number of simultaneously active APRO calls.)
MAXIMUM JR
Only for distributed processing:
Maximum number of simultaneously addressed remote job-receiving services relative to generation value MAXJR (KDCDEF control statement UTMD). In UTM-S applications, the value is set to 0 when the application is generated for the first time with KDCDEF or updated with KDCDEF/KDCUPD. With UTM-F applications, the value is set to 0 each time the application is started.
The figure is quoted in percent.
AVG COMPRESS PAGES SAVED
Average value for the UTM pages saved per data compression. The writing of data areas in which UTM performs no compression because, for example, the data length is less than one UTM page is not included in this statistics value.
If no statistics value for data compression is available, the string "- - -" is output instead of a numeric value. This is possible in the following situations.
Data compression is disabled.
The value was reset, e.g. with KC_MODIFY_OBJECT or by means of WinAdmin or WebAdmin.
No data compression was performed because the application uses "small" data areas in which it does not make sense to use compression.
If the value output for AVG COMPRESS PAGES SAVED is less than 0.5, for performance reasons data compression should be disabled for this application.
Lifetime of statistical data output for STATISTICS
The following statistical data is updated when the application is started or on each full hour (applies to UTM-F applications as well if MAX STATISTIC-MSG=FULL-HOUR was generated). The following table shows when UTM resets the counter to 0 for a UTM-S application. In UTM-F applications, all counters are reset to 0 at every application start.
You can reset some of the statistical values to 0 through the program interface to administration (see chapter "obj_type=KC_CURR_PAR").
Reset time | Counter(s) reset |
At every application start | CACHE HIT RATE |
For regeneration with KDCDEF and change generation with KDCDEF/KDCUPD | AVERAGE POOL SIZE |
When the application starts and after every full hour (also in UTM-F applications if MAX STATISTIC-MSG= FULL-HOUR was generated) | CACHE WAITS FOR BUFFER |
The following statistical values are written to the system log file SYSLOG at hourly intervals and at every normal termination of the application (message K081) provided that the application has been generated with MAX STATISTICS-MSG=FULL-HOUR:
CACHE HIT RATE
CACHE WAITS FOR BUFFER
CONNECTED USERS
LOGFILE WRITES
TERMINAL INPUT MESSAGES
TERMINAL OUTPUT MESSAGES
UNPROCESSED ATACS
type=SYSLOG
The information in the output is identical to the output from KDCSLOG INFO (see chapter "KDCSLOG - Administer the SYSLOG file").
type=SYSPARM
appliname APPLINAME version VERSION OF UTM ON|OFF ACCOUNT ON|OFF CALC FOR ACCOUNTING ON|OFF SM2 ON|OFF KDCMON ON|OFF TESTMODE percent % MAX CACHE PAGING RATE number PROGRAM FGG seconds TERMWAIT number USLOG FGG seconds RESWAIT-TA number MAX TASKS seconds RESWAIT-PR number CURRENT TASKS seconds CONRTIME number MAXASYN TASKS seconds LOGACKWAIT number CURRENT MAXASYN TASKS number CURRENT MAX TASKS IN PGWT seconds PTCTIME seconds CONCTIME seconds PGWTTIME number TASKS WAITING IN PGWT YES|NO PROGRAM EXCHANGE IS RUNNING number MAX TASKS IN PGWT YES|NO CLUSTER-APPLICATION PS|DS CACHE LOCATION ON|OFF DATA COMPRESSION (GEN)
Explanation of the output
APPLINAME | Name of the application defined in MAX APPLINAME during KDCDEF generation. |
VERSION OF UTM | |
openUTM version used, including the correction status and generation variant of the application (UTM-S or UTM-F). | |
ACCOUNT | The accounting phase for the accounting function is switched on (ON) or switched off (OFF). |
CALC FOR ACCOUNTING | |
The calculation phase of the accounting function is switched on (ON) or switched off (OFF). | |
SM2 | Data supply to openSM2 is switched on (ON) or switched off (OFF) for the application. |
KDCMON | The event monitor KDCMON is switched on (ON) or switched off (OFF). |
TESTMODE | Test mode is switched on (ON) or switched off (OFF). |
MAX CACHE PAGING RATE | |
Current value for CACHE. The pageing rate indicates the maximum number of pages in cache memory (in percent) to be written to KDCFILE when shortages occur. | |
PROGRAM FGG | |
Generation number of the currently loaded application program. For UTM applications on BS2000 systems, the value 0 is always output for PROGRAM FGG. For UTM applications running on Unix, Linux or Windows systems that were not started from the file generation directory PROG, the value 0 is output for PROGRAM FGG. | |
TERMWAIT | Current value representing the maximum length of time in seconds that can elapse in a multi-step transaction (PEND KP is called in the KDCS program unit) between an output to the terminal and the next entry made by the user (the time the terminal user takes to think). |
USLOG FGG | Number of the file generation for the user log file to which the user is writing at the present time. |
RESWAIT-TA | Current value representing the maximum time in seconds that the system can wait for another locked resource (GSSB, ULS,TLS). |
MAX TASKS | Maximum number of processes allowed in this application (see the chapter "kc_tasks_par_str" data structure, tasks parameter). |
RESWAIT-PR | Current value representing the maximum time in seconds that the system can wait for a resource locked by another process (GSSB, ULS, TLS). |
CURRENT TASKS | |
Number of processes in the application at the present time (see the chapter "kc_tasks_par_str" data structure , curr_tasks parameter). | |
CONRTIME | Current value representing the time in minutes after a connection failure after which UTM should attempt (cyclically) to re-establish the connection. |
MAXASYN TASKS | |
Maximum number of processes in the application that can be used at the same time for asynchronous processing (see the chapter "kc_tasks_par_str" data structure, asyntasks parameter). | |
LOGACKWAIT | |
Maximum time in seconds for which UTM applications on BS2000 systems can wait for a printout or transport confirmation message. | |
CURRENT MAXASYN TASKS | |
Maximum number of processes that can be used at the same time for asynchronous processing (see the chapter "kc_tasks_par_str" data structure, curr_max_asyntasks parameter). This value is adjusted automatically whenever:
| |
CURRENT MAX TASKS IN PGWT | |
Maximum number of processes currently in the application that are permitted to accept program units with blocking calls (see the chapter "kc_tasks_par_str" data structure, curr_max_tasks_in_pgwt parameter). This value is changed automatically whenever:
| |
PTCTIME | Only for distributed processing: |
CONCTIME | Only for distributed processing: |
PGWTTIME | Maximum time in seconds that a blocking function call can wait, e.g. the KDCS call PGWT. |
TASKS WAITING IN PGWT | |
Number of current processes that can be in wait state at the same time due to blocking function calls (e.g. KDCS call PGWT). | |
PROGRAM EXCHANGE IS RUNNING | |
Specifies whether openUTM is currently exchanging a program for the application. | |
MAX TASKS IN PGWT | |
Maximum number of processes in the application that can simultaneously process program units with blocking function calls (e.g. KDCS call PGWT) (see the chapter "kc_tasks_par_str" data structure, tasks_in_pgwt parameter). | |
CLUSTER-APPLICATION | |
Specifies whether the application is a UTM cluster application or a standalone UTM application. | |
CACHE LOCATION | |
Specifies whether the UTM cache lies in the program space (PS) or in one or more data spaces (DS). PS is always displayed for Unix, Linux, and Windows systems. | |
DATA-COMPRESSION (GEN) | |
Specifies whether data compression is permitted (ON) or not (OFF) for the application. The value displayed here matches the generation value for the application (see openUTM manual “Generating Applications”, MAX DATA-COMPRESSION=). If ON is displayed here, data compression can be enabled or disabled using administration facilities, e.g. with KDCAPPL. |
type=TAC
TAC LOCK STAT TCL IN-Q USED ERROR DBCNT TACELAP DBELAP TACCPU D tac number ON number number number number number msec msec mcsec D OFF type HLT KP
Explanation of the output
TAC | TAC name |
LOCK | Lock code which provides access protection for the transaction code; a number between 1 and 4000. |
STAT | Status of the transaction code: |
TCL | TAC class and type ( |
IN-Q | Number of messages that still have to be processed by the program unit started by the TAC name. |
USED | Total number of program unit runs processed with this transaction code (only for asynchronous TACs). In UTM-S applications, the value is set to 0 when the application is generated for the first time with KDCDEF or updated with KDCDEF/KDCUPD. With UTM-F applications, the value is set to 0 each time the application is started. |
ERROR | Number of program unit runs which were started by this transaction code and abnormally terminated. In UTM-S applications, the value is set to 0 when the application is generated for the first time with KDCDEF or updated with KDCDEF/KDCUPD. With UTM-F applications, the value is set to 0 each time the application is started. |
DBCNT | Average number of database calls from program units which were started with this TAC name. With database connections via the XA interface DBNCT is always 0. |
TACELAP | Average run time of the program unit which was started with this TAC (elapsed time); figure quoted in milliseconds. |
DBELAP | Average time for processing the database calls in the program unit runs. With database connections via the XA interface DBNCT is always 0. |
TACCPU | Average CPU time in microseconds used for processing this transaction code in the program unit. This corresponds to the CPU time used by openUTM plus the CPU time used by the database system. |
D | Indicates whether the transaction code was deleted (D) or not (no entry) from the configuration by means of system administration functions. |
The statistical values output for type = USED, ERROR, DBCNT, TACELAP, DBELAP and TACCPU are reset to 0 every time KDCDEF performs a new generation and every time KDCDEF/KDCUPD generates a change in UTM-S applications. With UTM-F applications, the values are set to 0 each time the application is started.
type=TAC-PROG
Output for UTM applications on BS2000 systems
TAC PROGRAM LOAD-MODULE tac1 program1 load-module1 tac2 program2 load-module2 tac3 program3 load-module3
Output for UTM applications on Unix, Linux and Windows systems
TAC PROGRAM SHARED-OBJECT tac1 program1 shared-object1 tac2 program2 shared-object2 tac3 program3 shared-object3
Explanation of the output
TAC | Name of the transaction code |
PROGRAM | Name of the program unit to which this transaction code is assigned |
LOAD-MODULE | |
On BS2000 systems: Name of the load module containing the program unit (PROGRAM) | |
SHARED-OBJECT | |
On Unix, Linux and Windows systems: Name of the shared object/DLL containing the program unit (PROGRAM) |
type=TACCLASS
TACCLASS TASKS WT MSGS AVG-WAIT-TIME PGWT PRIO* NR WAITS 1 number number msec YES|NO prio number number : 8 number number msec YES|NO prio number number 9 number number msec YES|NO prio number number : 16 number number msec YES|NO prio number number
*prio = ABS | REL | EQ | NO
Explanation of the output
TASKS | Maximum number of processes currently allowed to process jobs for transaction codes in this TAC class. |
WT MSGS | Number of messages currently stored in openUTM for transaction codes in this TAC class that have not yet been processed. |
AVG-WAIT-TIME | |
Average wait time for jobs in this TAC class in milliseconds. The wait time is calculated from the time openUTM accepts the job to the start of actual processing. AVG-WAIT-TIME=0 signifies that all jobs are being processed immediately. Wait times can, for instance, arise if not all processes in the application may process jobs for the TAC class and if openUTM consequently has to store jobs temporarily in the job queue. | |
PGWT | Specifies whether program units with blocking calls, e.g. the KDCS call PGWT, are allowed to run in this TAC class. If the application was generated with priority control (TAC-PRIORITIES statement), then the column PGWT contains NO for all TAC classes. |
PRIO | If the application was generated with priority control, then the column PRIO contains the type of priority defined for the TAC classes (ABS, REL, EQ). If the application was generated without the TAC-PRIORITIES statement, the PRIO column contains NO for all TAC classes. |
NR | Number of program unit runs for this TAC class. |
WAITS | Number of wait situations taken into account to calculate the value AVG-WAIT-TIME. |
type=USER
USER KSET STATUS OSERV NR.TACS CPUTIME SECCNT LTERM D user1 kset1 ON|OFF Y|N number msec number lterm1 D
Explanation of the output
USER | Name of the user ID |
KSET | Key set assigned to this user ID (access rights) |
STATUS | User ID is disabled (OFF) or not disabled (ON). |
OSERV | Y signifies that the user is currently processing a service and that this service has reached at least one synchronization point. |
NR.TACS | Number of program unit runs entered under this user ID. In UTM-S applications, the value is set to 0 when the application is generated for the first time with KDCDEF or updated with KDCDEF/KDCUPD. With UTM-F applications, the value is set to 0 each time the application is started. |
CPUTIME | Number of CPU milliseconds used up by the user for processing these jobs (does not include the CPU time for the database calls). The value is reset to 0 after the user has signed off (KDCOFF) or after the connection has been cleared. |
SECCNT | Number of security violations for this user ID (e.g. incorrect password entered) since the start of the application. This number is reset to 0 each time the application is started. |
LTERM | The following cases must be distinguished:
If the user ID is generated with RESTART=YES, LTERM contains the name of the LTERM or OSI-LPAP partner via which a client with this user ID is signed on. Exceptions: Signing on took place by means of OSI TP, and the functional unit “Commit” was selected, or signing on was via OSI TP to start an asynchronous service. In this case, LTERM contains blanks. In all other cases, LTERM contains blanks. |
D | Indicates whether the user ID was deleted (D) or not (no entry) from the configuration by means of system administration functions. |
The password for the user ID is not output.