| what | Index Level | whereall |
| Syntax | where {port.number{-port.number}} {user-id} {(options)} |
| Category | TCL |
| Type | Verb |
| Description |
displays the current execution status of all processes currently logged on to system, or for selected port.numbers.
The information displayed by "where" includes: "Ln:" is the port.number. An "*" (asterisk) indicates the port that issued the command. "PCB FID:" is the frame-id ("fid") of the primary control block (pcb) for each port. "PIB STAT:" is the pib status of each port. See the "pibstat" command for an explanation of the bit settings. "ABS base:" is the beginning fid of the abs currently being executed by each port. "Stat:" is the current status of the port: n: (hexadecimal) current TCL level. If blank, the port is at the primary level (level 1). d: in system debugger. p: phantom process. t: tape attached. When the (U) option is used, the "stat" fields contains the 'user tally' code. Possible values for the user tally are: 0 Port is logged off. 1 Port is pushed a level. 2 Port is in process of logging on. 3 Port is in "break/end" sequence. 5 Normal setting. -1 Spooler controlled process. -2 Scheduler process. "R1 & Return stack contents:" displays the abs mode currently executing on the port. The first entry is the current location. Subsequent entries (which are separated by spaces) are the return stack mode addresses. If the display says "corrupted workspace", the most likely cause is the workspace is not properly setup or the process is in the middle of "push level" or "pop level". "w" is a synonym of "where". |
| Options |
user-id Outputs status for a specific user-id only. Quotes are optional in D3. (D3 only)
'account' Outputs status for processes using the specified account name. Quotes are required surrounding the account name in R83 releases of Pick. (R83 only) port.number{-port.number} Outputs the status for the given port, or a range of ports. h Suppresses the heading. l Displays the status for each "pushed" level. n No pause. Suppresses the pause at the end of the page on the terminal. p Directs output to the system printer, via the Spooler. u Returns the user tally (under the "Stat" column heading). z Displays "where" status for all ports, including "inactive" ports (those which are not currently logged on). |
| See Also | w wheresp port.number startsched what wheres port.number whered whereovf whereindx wheret whereall who (R83) wherebt wherepu u0011 u0079 u3b u2117 wherelk psr t-verify pib status pibstat unlock-group |
| Example |
where 'dm'
Displays the status of those ports which are currently logged into the "dm" user-id. where 13-22 Outputs the status of port.numbers 13 through 22. where (z Outputs the status of all port.numbers. where Ln PCB PIB ABS Stat R1 & Return stack contents 011 00060B BF10 000018 sp.serialsleep:080 012 00060C FF10 000018 au.tcl.upd:084 au.start:36C 013 00060D BF10 000018 sp.serialsleep:080 014 00060E BF10 000018 sp.serialsleep:080 015 00060F BF10 000018 sp.serialsleep:080 019 000613 BF10 000018 sp.serialsleep:080 045 0469F9 F310 000018 3 au.input:000 au.get.cmnd:0D8 *056 046AA6 FF30 000018 2 ws.where1:000 ws.whatwhere:354 069 0457DD F310 000018 1 me.pause:018 me.display:598 070 04514D F310 000018 1 me.pause:018 me.display:598 074 00064A BF10 000018 sp.serialsleep:080 082 000652 BF10 000018 sleepsub:0F4 br.rqm:18C 128 000680 BF10 000018 P sp.sleep:040 sp.spoolout:0F0 130 04AA25 FF10 000018 P br.unix.bix:000 137 039A0B BF10 000018 P pp.sched:038 |
| Warnings | In release 7.0 and above, the "where" command (even with the Z option) will only display lines which have undergone some type of activity. |
| Compatibility | D3 7.0 AP R83 |
| what | Index Level | whereall |