1 03/27/85 poll_fnp
 2 
 3 Syntax as a command:  poll_fnp {fnp_list} {-control_args}
 4 
 5 
 6 Function:  initiates and controls automatic polling of FNPs.  Polling
 7 consists of reading error statistics from the FNP memory and logging
 8 them in either the syserr log or a file.  This command sets up timers
 9 and event call handlers within the process.  Once initiated, FNP
10 polling is performed periodically, independent of whatever else is
11 going on in the process.  This command is normally used by the
12 initializer or a daemon.
13 
14 
15 Arguments:
16 fnp_list
17    is a list of the FNP names to be polled.  If no names are listed,
18    all FNPs are polled.
19 
20 
21 Control arguments:
22 -debug, db
23    prints extra debugging information each time polling is performed.
24 -log
25    writes statistical information to the syserr log.  This is the
26    default.  Access to the hphcs_ gate is required.
27 -output_file path, -of path
28    writes statistical information to the segment specified by path.
29    This control argument can be used in conjunction with -log.
30 -time N, -tm N
31    specifies the polling interval in minutes.  The default polling
32    interval is 15 minutes.
33 
34 
35    The following control arguments modify the polling already in
36    process and cannot be used on the initial invocation of the poll_fnp
37    command.
38 -stop, -sp
39    stops polling for the FNPs specified with the fnp_list argument.  If
40    no FNPs have been specified, polling of all FNPs is stopped.
41    Polling continues to be scheduled periodically, even though no FNPs
42    are being polled.
43 -start, -sr
44    resumes polling for the FNPs specified with the fnp_list argument.
45    If no FNPs have been specified, polling of all FNPs is resumed.
46    Note that the next polling does not occur immediately; it is
47    performed during the next scheduled polling cycle.
48 
49 
50 -finish
51    schedules the last polling cycle immediately.  Once this cycle
52    completes, polling is disabled, and a new poll_fnp command is
53    required to start it again.  To stop polling without performing one
54    last cycle, use both -stop and -finish.
55 
56 
57 Notes:  If polling of an individual FNP fails three consecutive times,
58 polling of that FNP is stopped.  If three consecutive scheduled polling
59 cycles are missed because a previous cycle did not complete, an
60 automatic finish operation is performed, and no further cycles are
61 scheduled.
62 
63 Polling of FNPs has no effect on the users of devices connected to the
64 FNP.