1 02/25/85 meter_fnp_idle
 2 
 3 Syntax as a command:  meter_fnp_idle fnp_name {-control-args}
 4 
 5 
 6 Function:  reads FNP idle metering information at specified intervals
 7 and stores the information in a segment for later viewing through the
 8 display_fnp_idle command.
 9 
10 
11 Arguments:
12 fnp_name
13    identifies the FNP for which idle time is to be recorded.
14 
15 
16 Control arguments:
17 -directory path, -dr path
18    specifies that the segments in which idle time information is to be
19    stored are to be created in the directory with pathname path.  The
20    default is the user's working directory.  Segment names are of the
21    form fnp_idle_data.F.MMDDYY.HHMMSS.I where F is fnp_name,
22    MMDDYY.HHMMSS is the starting date and time of recording, and I is
23    the specified interval in minutes.
24 -interval N
25    specifies that metering information is to be sampled every N
26    minutes.  The default is 1.
27 -stop, -sp
28    terminates meter reading on this FNP.  No other control argument may
29    be specified with -stop.
30 
31 
32 Access required:  Use of this command requires access either to the
33 metering_gate gate or the phcs_ gate.
34 
35 
36 Notes:  Information is appended to the idle time segment until the
37 -stop control argument is encountered or the process terminates.
38 Maximum length of an idle time segment is 64K (to avoid exhausting a
39 256K ASTE).  If a segment becomes full, a new one is created.  On
40 average, taking readings at one-minute intervals would fill a 64K
41 segment in a little over three weeks (if a single process in which the
42 command was invoked were to run that long).
43 
44 Each invocation of the command creates a new segment.