1 05/22/84 write_notify_test
 2 
 3 Syntax:  write_notify_test {CPU_STR} {-control_args}
 4 
 5 
 6 Function:  Test the ability of the DPS8M CPU and SCU interface to
 7          selectively clear CACHE when  another active unit writes
 8          into main memory. As an active function return the results
 9          of the test (see NOTE).
10 
11 Arguments:
12 CPU_STR
13      This is a  character string of cpus to  use for testing.  At
14      least two cpus  are required, and one must  be a DPS8M.  The
15      default is  to select all  the DPS8M cpus on  the system, if
16      only one DPS8M cpu if found to be on_line then a L68 will be
17      used as the  second processor.  If There is  only one cpu on
18      system, or there are no DPS8M cpus the test will not run.
19 
20 
21 Control arguments:
22 -brief, -bf
23      Displays the brief form of  errors and meters.  This control
24      argument is the default.
25 -deactivation_count, -dc N
26      This is number  (N) of times to deactivate  the data segment
27      used.  This  deactivation is to  change the location  of the
28      test page  in main memory.   The default is 1%  of the total
29      on_line pages.
30 -loop_count, -lc N
31      This is the number (N)  of times to loop before deactivating
32      the segment.  The default is 10.
33 -long, -lg
34      Displays the long form of errors and meters.
35 -meter
36      Displays  the  memory  utilization  percentages.   If  -long
37      argument has  been given then  the actual pages  and address
38      lines are displayed.
39 -word_increment, -wi N
40      This is the word increment to use for the test page.  N is a
41      decimal  number  greater that  0  and less  that  1023.  The
42      default is 52.
43 
44 
45 NOTE:  This command requires phcs_ and hphcs_ access.
46 
47        When invoked as an active function write_notify_test will return
48        the results of the test. If no erroes are found, the return
49        string is the word "passed". If the test detects errors then
50        the first word of the return string is "failed" followed by the
51        failing unit or units.
52   example:
53        failed CPU_A
54        or
55        failed CPU_A SCU_B