1QMCSOURCE(3)               Library Functions Manual               QMCSOURCE(3)
2
3
4

NAME

6       QmcSource  - manages contexts created by all groups
7

C++ SYNOPSIS

9       #include <QmcSource.h>
10
11       CC ... -lqmc -lpcp
12

DESCRIPTION

14       The  QmcSource  class  maintains a unique list of all metric sources in
15       use to minimize the creation of new contexts (see pmNewContext(3)) when
16       the  context  could  have  been duplicated (see pmDupContext(3)).  This
17       also reduces the duplication of descriptions of each source.
18
19       In general, QMC users should only need to access QmcSource  methods  to
20       obtain  source  descriptions  for  a QmcContext(3) object.  All context
21       creation by the user should be handled through QmcGroup(3).
22

DESTRUCTOR

24       ~QmcSource();
25           Destructor.
26

CONSTRUCTORS

28       static QmcSource* getSource(int type, const char* source,
29           bool matchHosts)
30
31           This method will return a QmcSource object that represents  a  con‐
32           text  of  type to source.  The QmcSource object may be a new object
33           if the source has not been previously requested. Memory  management
34           of  the  QmcSource objects is handled by QmcSource.  If all QmcCon‐
35           text(3)s to the QmcSource have been deleted, the  QmcSource  object
36           will also be deleted.
37
38           The  matchHosts  flag  controls the algorithm that is used to match
39           hosts to archives.  If matchHosts is equal to false then no attempt
40           will  be made by this method to match a host context to an existing
41           source context. A QmcSource object will always be returned in  this
42           case,  although  the  QmcSource::status  method may indicate that a
43           context to source failed.
44
45           If matchHosts is equal to true, host contexts will be matched to  a
46           pre-defined  archive  source collected from that source.  If no ar‐
47           chive sources for the source have  been  previous  specified,  get‐
48           Source will return a NULL pointer.
49

SEE ALSO

51       PMAPI(3),    QMC(3),   QmcContext(3),   QmcGroup(3),   pmDupContext(3),
52       pmflush(3), pmNewContext(3) and pmprintf(3).
53

DIAGNOSTICS

55       Error messages are generated using pmprintf(3) but are not flushed.  It
56       is the responsibility of the user to call pmflush(3) to output any mes‐
57       sages.
58
59       Additional diagnostics may be activated by adding the option pmc to the
60       global debugging specification, as described in pmSetDebug(3).
61
62
63
64Performance Co-Pilot                  SGI                         QMCSOURCE(3)
Impressum