Previous Topic: DISPLAY INDEX OUTPUT CommandNext Topic: Field Definitions


DISPLAY INDEX SESSION Command

The DISPLAY INDEX SESSION command lists the name and status of each current user. Information is provided to determine who is active in the Session Control Facility (SCF) environment. Computer Associates products that run in the SCF environment are CA Ideal and Datadictionary (DDOL). You can only issue this command under CICS in the VSE and z/OS environments.

The command returns a snapshot of the environment. The environment can change before the information is returned. The information that is returned is information retrieved from control blocks kept in CICS Auxiliary Temporary Storage records, which are updated at a transaction boundary. This implies that the information is not current if the user is an active CICS task.

If your terminal is split into multiple regions, a set of information is returned for each region. If you are running a program in the CA Ideal environment (which can only occur in region one), the main program, system, version, and the number of programs in the run unit are returned. (You can issue the RUN command only in region one.)

The IDs returned are the op‑IDs defined for the user in the CICS signon table (SNT). If the signon table is not used, they are the IDs placed in the TCTTEOI field of the terminal control table (TCT). All user IDs are returned, regardless of the products the user is logged onto.

If you initiate an asynchronous task (a compile or network print) and log off before the completion message is sent, you still show up as logged on.

This command has the following format:

DISPLAY INDEX SESSION

The following example illustrates the index of users this command produces. Each column is described.

Command User OPID Reg User name Term Product Sys Main PGM Ver Sub ====== ================================ T O P ================================= 000001 RAY RAY 1 RAY Z000 IDEAL WOR WORUN PRD 0017 000002 MDF MDF 1 MDUFFY Z002 IDEAL WOR WORUN PRD 0018 000003 SFT SFT 1 SEIFERT Z003 IDEAL **NONE** 0000 ====== ============================= B O T T O M ==============================