basis

Basis

Operational questions about a running system, answered from an ADT session rather than SAP GUI.

The repository skills (abap, clean-abap, rap, …) look at what is in the system. This one looks at what the system is doing.

Who is logged on

{"tool":"listLoggedOnUsers","args":{}}

Returns a summary rather than a dump: sessionCount, userCount, then byUser (busiest first, ties alphabetical) and byClient. A busy server has hundreds of sessions, and the summary is usually the whole answer.

{"tool":"listLoggedOnUsers","args":{"currentUserOnly":true,"includeSessions":true}}
{"tool":"listLoggedOnUsers","args":{"user":"SOMEUSER","includeSessions":true}}
{"tool":"listLoggedOnUsers","args":{"client":"100"}}

currentUserOnly means the user this server connects as — it resolves SAP_USER itself, so do not hard-code a name to ask "do I have a session". Every response also carries currentUser, which is how you tell your own sessions from everyone else's.

Each session carries tid, client, user, transaction, terminal, host, time, guiVersion, rfcType, the mode counts, and the raw logonType / logonState / logonProtocol.

Four things to know before you answer

1. It is one application server, not the system. TH_USER_LIST reports the instance your session is connected to — the equivalent of SM04, not AL08. On a multi-instance system, "nobody is logged on" means nobody on this instance. Say so rather than implying the system is idle.
2. logonType, logonState and logonProtocol are raw integers on purpose. Their data elements (UEXT_TYPE, USTATE, UPROTOCOL) have no domain, so the dictionary carries no fixed values and any label would be invented. Use the observable fields instead: a transaction and a guiVersion mean a SAP GUI dialog session; an rfcType of I or E means an RFC connection.
3. Most sessions are not people. Service users (SAPJSF_*, SM*AGENT*, BGRFCSUPER, SAPSYS, RFC*, CTMAGENT, FC*) dominate the list. When asked "is anyone using the system", separate named users from technical ones instead of quoting the raw count.
4. A filtered result of zero is not "nobody is on". The response carries filter.totalBeforeFilter for exactly this reason — quote it.