SYSAPPL-MIB Table View

The table listing the software application packages
installed on a host computer. In order to appear in
this table, it may be necessary for the application
to be installed using some type of software
installation mechanism or global registry so that its
existence can be detected by the agent implementation.

This table details the individual application package
elements (files and executables) which comprise the
applications defined in the sysApplInstallPkg Table.
Each entry in this table has an index to the
sysApplInstallPkg table to identify the application
package of which it is a part. As a result, there may
be many entries in this table for each instance in the
sysApplInstallPkg Table.
          
Table entries are indexed by sysApplInstallPkgIndex,
sysApplInstallElmtIndex to facilitate retrieval of
all elements associated with a particular installed
application package.

The table describes the applications which are executing
on the host.  Each time an application is invoked,
an entry is created in this table. When an application ends,
the entry is removed from this table and a corresponding
        entry is created in the SysApplPastRunTable.
          
A new entry is created in this table whenever the agent
implementation detects a new running process that is an
installed application element whose sysApplInstallElmtRole
designates it as being the application's primary executable
(sysApplInstallElmtRole = primary(2) ).
          
The table is indexed by sysApplInstallPkgIndex,
sysApplRunIndex to enable managers to easily locate all
invocations of a particular application package.

A history of the applications that have previously run
on the host computer.  An entry's information is moved to
this table from the sysApplRunTable when the invoked
application represented by the entry ceases to be running.
          
An agent implementation can determine that an application
invocation is no longer running by evaluating the running
elements of the application instance and their Roles as
defined by sysApplInstallElmtRole.  Obviously, if there
are no running elements for the application instance,
then the application invocation is no longer running.
If any one of the REQUIRED elements is not running,
the application instance may be in the process of exiting.
Most agent implementations will wait until a second internal
poll has been completed to give the system time to either
restart partial failures or to give all elements time to
exit.  If, after the second poll, there are REQUIRED
elements that are not running, then the application
instance may be considered by the agent implementation
to no longer be running.
          
Entries remain in the sysApplPastRunTable until they
are aged out when either the table size reaches a maximum
as determined by the sysApplPastRunMaxRows, or when an entry
has aged to exceed a time limit as set by
sysApplPastRunTblTimeLimit.
          
Entries in this table are indexed by sysApplInstallPkgIndex,
sysApplPastRunIndex to facilitate retrieval of all past
run invocations of a particular installed application.

The table describes the processes which are
currently executing on the host system. Each entry
represents a running process and is associated with
the invoked application of which that process is a part, if
possible.  This table contains an entry for every process
currently running on the system, regardless of whether its
'parent' application can be determined.  So, for example,
processes like 'ps' and 'grep' will have entries though they
are not associated with an installed application package.
          
Because a running application may involve
more than one executable, it is possible to have
multiple entries in this table for each application.
Entries are removed from this table when the process
terminates.
The table is indexed by sysApplElmtRunInstallPkg,
sysApplElmtRunInvocID, and sysApplElmtRunIndex to
facilitate the retrieval of all running elements of a
particular invoked application which has been installed on
the system.

The table describes the processes which have previously
executed on the host system as part of an application.
Each entry represents a process which has previously
executed and is associated with the invoked application
of which it was a part.  Because an invoked application
may involve more than one executable, it is possible
to have multiple entries in this table for
each application invocation. Entries are added
to this table when the corresponding process in the
sysApplElmtRun Table terminates.
          
Entries remain in this table until they are aged out when
either the number of entries in the table reaches a
maximum as determined by sysApplElmtPastRunMaxRows, or
when an entry has aged to exceed a time limit as set by
sysApplElmtPastRunTblTimeLimit.  When aging out entries,
the oldest entry, as determined by the value of
sysApplElmtPastRunTimeEnded, will be removed first.
          
The table is indexed by sysApplInstallPkgIndex (from the
sysApplInstallPkgTable), sysApplElmtPastRunInvocID,
and sysApplElmtPastRunIndex to make it easy to locate all
previously executed processes of a particular invoked
application that has been installed on the system.

The sole purpose of this table is to provide a
'backwards' mapping so that, given a known
sysApplElmtRunIndex (process identification number),
the corresponding invoked application (sysApplRunIndex),
installed element (sysApplInstallElmtIndex), and
installed application package (sysApplInstallPkgIndex)
can be quickly determined.
          
This table will contain one entry for each process
that is currently executing on the system.
          
It is expected that management applications will use
this mapping table by doing a 'GetNext' operation with
the known process ID number (sysApplElmtRunIndex) as the
partial instance identifier.  Assuming that there is an
entry for the process, the result should return a single
columnar value, the sysApplMapInstallPkgIndex, with the
sysApplElmtRunIndex, sysApplRunIndex, and
sysApplInstallElmtIndex contained in the instance identifier
for the returned MIB object value.
          
NOTE: if the process can not be associated back to an
invoked application installed on the system, then the
value returned for the columnar value
sysApplMapInstallPkgIndex will be '0' and the instance
portion of the object-identifier will be the process ID
number (sysApplElmtRunIndex) followed by 0.0.