The where command displays the current execution status of all processes currently logged on to system, or for selected port numbers.
Syntax
where {port.number{-port.number}} {user-ID} {(options)} |
Synonym(s)
w |
Parameter(s)
user-ID |
Outputs status for a specific user-ID only. Quotation marks are optional in D3. |
|
account |
Outputs status for processes using the specified account name. |
|
port.number{-port.number} |
Outputs the status for the specified port, or a range of ports. |
|
options |
a |
Displays a character next to the PIBs display to indicate the license consumption type. Possible types are:
When used with the o option, only those PIBs that are using a license are displayed. NOTE—In this mode, an asterisk is not displayed next to the port that issued the command. |
h |
Suppresses the heading. |
|
l |
Displays the status for each pushed level. |
|
n |
No pause option suppresses the pause at the end of the page on the terminal. |
|
o |
Displays information only for those PIBs that have the specified settings when used with the a option. |
|
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). |
The where command displays this information:
Ln |
Port number. NOTE—An asterisk indicates the port that issued the command. |
||
PCB FID |
FID of the PCB for each port. |
||
PIB STAT |
PIB status of each port. |
||
ABS base |
Beginning FID of the ABS currently being executed by each port. |
||
Stat |
Current port status: |
||
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. |
||
u |
When this option is used, the Stat fields contain the user tally code. Possible values for the user tally codes: |
||
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 that the workspace is not properly setup or the process is in the middle of push level or pop level. |
||
w |
Synonym of the where command. |
NOTE |
The where command (even with the Z option) only displays lines which have undergone some type of activity. |
Example(s)
Displays the status of those ports which are currently logged into the dm user-ID.
where ’dm’ |
Outputs the status of port numbers 13 through 22.
where 13-22 |
Outputs the status of all port numbers.
where (z |
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 |
F310 |
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
PIB Status, pibstat Command, Port Number, psr Command, startsched Command, t-verify Command, u0011 User Exit, u0079 User Exit, u2117 User Exit, u3b User Exit, unlock-group Command, what Command, wherebt Macro, whered Macro, whereindx Macro, wherelk Macro, whereovf Macro, wherepu Macro, wheres Command, wheresp Macro, wheret Macro