Using request source and prefix directive once
The request source and prefix directive once allow mmpmon users to more finely tune their operations.
The source request causes mmpmon to read requests from a file, and when finished return to reading requests from the input stream.
The prefix directive once can be placed in front of any mmpmon request. The once prefix indicates that the request be run only once, irrespective of the setting of the -r flag on the mmpmon command. It is useful for requests that do not need to be issued more than once, such as to set up the node list or turn on the request histogram facility.
These rules apply when using the once prefix directive and source request:
- once with nothing after it is an error that terminates mmpmon processing.
- A file invoked with the source request may contain source requests, causing file nesting of arbitrary depth. No check is done for loops in this situation.
- The request once source filename causes the once prefix to be applied to all the mmpmon requests in filename, including any source requests in the file.
- If a filename specified with the source request cannot be opened for read, an error is returned and mmpmon terminates.
- If the -r flag on the mmpmon command has any value other than one, and all requests are prefixed with once, mmpmon runs all the requests once, issues a message, and then terminates.