The PS EXEC

Syntax

PS <s1> <s2> <cmd> <parms> <;cmd> <parms> .....

This is the Per-Slot exec. It will repeatedly execute a DF command string or REXX exec for each thread slot in the range specified. The linear addresses of slot related control blocks (TCB, PTDA and TSD) may be specified symbolically in the command string so that the correct address will be substituted for each slot traversed by PS.

The parameters to PS are:

<s1>

Starting (hexadecimal) slot number
<s2>
Ending (hexadecimal) slot number or *, which signifies highest active slot in the system.
<cmd>
is any string of DF commands separated by ; or a single REXX exec prefixed by %.
<parms>
are any valid parameters where @TCB, @PTDA and @TSD are substituted with their corresponding linear addresses. @disp is the scheduler's ESP relative to the TSD. N.B @disp is only defined when page table entries are present for the TSD.

Example 1:

Display priority information (on a 2.11 system) for slots 30 to 33 where priority class is at TCB+e4, priority delta is at TCB+e5 and dispatching priority is a word at TCB+e8.

Enter:

%PS 30 33 DB @TCB+e4 L2; DW @TCB+e8 L1

Slot 30
Warning: not all addresses are present
DB %7BA8FE78+E4 L2; DW %7BA8FE78+E8 L1

%7ba8ff5c 02 0f                                           ..
%7ba8ff60  020f

Slot 31
DB %7BA9002C+E4 L2; DW %7BA9002C+E8 L1

%7ba90110 02 00                                           ..
%7ba90114  0200

Slot 32
Warning: not all addresses are present
DB %7BA9002C+E4 L2; DW %7BA9002C+E8 L1

%7ba90110 02 00                                           ..
%7ba90114  0200

Slot 33
DB %7BA90394+E4 L2; DW %7BA90394+E8 L1

%7ba90478 03 00                                           ..
%7ba9047c  0800
ps ended rc: 0

Note:

For slot 30 a warning message is issued because in this instance .s30 gave an error because slot 30 page tables were swapped out.

---

[Back: The RUNCHAIN EXEC]
[Next: The TEMPLATE EXEC]