tcl.where
Displays system execution information.
Syntax
where {port.number{-port.number}} {user-id} {(options)}
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 AP. (AP only)
'account' Outputs status for processes using the specified account name. Quotes are required surrounding the account name in R83 versions 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).
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
See Also
User Comments
What do you think?
Share your experience or ask a question by using the form below.
Login to leave your comments.