KDCINF allows you to query the names and properties of objects in an application as well as the application parameters generated and statistical information about the utilization level of the application. The parameter type allows you to define which information you require.
Effect in UTM cluster applications:
The information that is output always refers only to the local node application at which the job was executed.
Restricting the scope of information output
You can use a KDCINF call to query the properties of objects of a given type. The operands CONT, LIST and PRONAM define the scope of information that UTM is to output. You should define explicitly those objects about which you want UTM to provide information and define the scope of information for each object:
In LIST you can explicitly define the names of the objects about which UTM is to provide information.
By entering LIST=KDCNAMES you can restrict the output to a list of names of all objects of a given type. No other properties will then be displayed.
LIST=KDCCON causes UTM to display only the properties of objects in a given type which are active at the current time, i.e. properties of clients, printers or partner systems to which there is a connection, or of users who are working on the system at the current time.
CONT determines the object with which the list is to start. These lists are arranged alphabetically in order of object name. In CONT you enter a name. This can be any name - it does not have to be the name of an existing object. If the name you specify is the name of an object, the output list will start with that object. If there is no object with the name specified in CONT, the list will start with the object name that immediately follows the specified name in alphabetical order. No information is then provided about objects whose names come before the name specified in CONT when viewed in alphabetical order.
With PRONAM you can restrict the output of object properties and names to objects located on a specific computer.
It is advisable in many cases to restrict KDCINF output, for example in large applications and for the output of information to a terminal. Full output of all information relating to one type of object is often so extensive that it can extend over many screen pages when output to the administrator’s terminal. It is then not possible to retain a clear overview. With large applications, generation of complete lists takes UTM a great deal of time. For this reason, when dealing with larger applications, you should avoid requesting complete lists about objects of a given type, or lists of all objects and application parameters. In other words, avoid queries which take the following forms:
KDCINF ..,LIST=KDCALL,OUT=KDCPRINT or
KDCINF ..,LIST=KDCALL,OUT=KDCBOTH
Information output
The OUT operand allows you to define the location to which UTM is to output the requested information. You can also display information directly on the administrator terminal, send the information to a printer or transfer it directly to a program unit (asynchronous TAC) which will further process it.
For some objects, such as TAC, the output line of KDCINF does not provide sufficient space to display all the numeric values in their full length, for instance the value of the IN-Q field. When these values are too large to be displayed with KDCINF, they are truncated meaningfully and displayed in floating point presentation. In other words the leftmost digits are displayed, followed by an exponent e. The approximate actual value of the field is then obtained from the leading digits multiplied by 10 "to the power of" e.
Example:
When KDCINF TAC is output, four digits are available for the IN-Q field. If the number of messages which still needs to be processed by the TAC is greater than 9,999, the truncated presentation is used. A value of 11,235 is displayed as 11e3, i.e. the actual value lies in the range between 11,000 and 11,999.
Calculation of mean values
The mean values displayed with KDCINF are calculated as an arithmetic mean for the first 32767 values. After this, the new value is weighted with 1/32767. The previous mean value is weighted with 32767/32768. Slight inaccuracies caused by rounding may occur in the calculation of the mean values. This is particularly the case, if the new value differs considerably from the mean value.
You will find examples of output and an explanation of the information that is output in the following description of operands (see chapter "Output from KDCINF (examples)").
Special features of terminal output:
If the requested output does not fit on one screen, UTM displays a continuation command at the bottom of the screen (on the last line) which can be used to continue output from that position.
If you wish to page through the list using continuation commands, proceed as follows:
on BS2000 systems:
only overwrite one character in the specified command and press the <DUE> key.on Unix, Linux and Windows systems:
enter the continuation command as displayed.