tcl.where Verb: Access/TCL

tcl.where

Command tcl.where Verb: Access/TCL
Applicable release versions: AP, AP 6.2, R83
Category TCL (746)
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".
Syntax where {port.number{-port.number}} {user-id} {(options)}
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
Purpose
Related tcl.w
tcl.wheresp
port.number
tcl.startsched
tcl.what
tcl.wheres
port.number
tcl.whered
tcl.whereovf
tcl.whereindx
tcl.wheret
tcl.whereall
tcl.who_rp
tcl.wherebt
tcl.wherepu
ue.0011
ue.0079
ue.3b
ue.2117
tcl.wherelk
tcl.psr
tcl.t-verify
pib.status
tcl.pibstat
tcl.unlock-group