KDCISAT - query information on SAT logging values

The SAT administrator can use the KDCISAT command to obtain information on the values currently set for SAT logging or query the syntax of the KDCISAT command. KDCISAT indicates the UTM event classes from which the events are logged for a particular processing result (positive or negative). The information can also be queried for specific TACs and/or specific users. The UTM event classes are listed in the description of the EVENT operand in the KDCMSAT statement ("KDCMSAT - modify SAT logging").

The output for each KDCISAT inquiry indicates whether SAT logging is switched on or off.

KDCISAT

{ [ TAC=tacname ] [, USER=username] | HELP }

KDCISAT entered without operands:

The output indicates the event classes from which events are logged. For the individual event classes, it specifies whether successful or failed events are logged (see Example 1). The values which are set identically for all users and for all TACs are output, i.e. all SAT logging values that were either generated in the SATSEL statement or were defined with the command KDCMSAT SATSEL=...,EVENT=(...).

TAC=tac

From the individual event classes, it is indicated which events are specifically logged for this TAC (see Example 2).

USER=user

From the individual event classes, it is indicated which events are specifically logged for this user.

TAC=tacname,USER=username

For the individual event classes, it is indicated which events are logged in total for the specified user and the specified TAC. The output includes the defined event-specific values (KDCISAT without operand), the TAC-specific values (KDCISAT TAC=...), and the user-specific values (KDCISAT USER=...) for SAT logging (see Example 3).

HELP

Indicates the syntax of this command.

Output of KDCISAT

All information is output at the terminal of the SAT administrator. The RESULT column indicates whether the system has logged events that indicate positive execution or negative processing. The value specified in RESULT is the result arising from the combination of the defined SAT logging conditions. The result is the inclusive-OR operation from the logging values defined for EVENT and possibly USER and possibly TAC (see the tables in section"Linking the preselection values").

If an invalid USER or TAC is specified, then the UTM message invalid TAC or invalid USER is output.

 

Example 1

If you enter:

KDCISAT

the following is output:

SAT	USER	TAC	EVENT 1	RESULT
ON			SIGN CHANGE-PW START-PU END-PU GSSB TLS ULS ADM-CMD	BOTH BOTH NONE NONE BOTH BOTH BOTH BOTH

¹The meaning of the event classes (EVENT) and the values of RESULT are described for the KDCMSAT command (KDCMSAT - modify SAT logging).

Example 2

If you enter:

KDCISAT TAC=tac1

the following is output:

SAT	USER	TAC	EVENT	RESULT
ON		tac1	SIGN CHANGE-PW START-PU END-PU GSSB TLS ULS ADM-CMD	BOTH BOTH NONE NONE BOTH BOTH BOTH BOTH

 

Example 3

If you enter:

KDCISAT TAC=tac2,USER=user2

the following is output:

SAT	USER	TAC	EVENT	RESULT
ON	user2	tac2	SIGN CHANGE-PW START-PU END-PU GSSB TLS ULS ADM-CMD	BOTH BOTH NONE NONE BOTH BOTH BOTH BOTH