================================================================================
Data Monitoring Library*
Version 2.2.1
Release Notes
Harris Computer Systems Corporation
1. Introduction
The Data Monitoring Library provides C and FORTRAN callable services
for nonintrusive monitoring of variables in executing processes.
Data monitoring is effected through the use of the usermap(3rt)
service, which employs the /proc file system (proc(4)) to read and
write the address space of executing processes. The data monitoring
services require symbolic information from the executable files of the
processes to be monitored; thus, portions of the executable files must
be built with the -g (debug) compilation option (C, FORTRAN, and Ada).
Data monitoring includes the following general capabilities:
o Retrieve values of variables (or components of variables) in a
target process
o Modify variables (or components of variables) in a target process
o Retrieve/Modify user-specified memory locations in a target
process
o Retrieve information about variables (or components of variables)
in a target process (type, address, dimensions, constraints,
etc.)
o List the components of a composite variable (e.g. record,
structure, array) (C interface only)
__________
* These release notes cover the following products: datamon
- 1 -
Data Monitoring Library 2.2.1 Release Notes
o Scan an executable file for variables that can be monitored (C
interface only)
o Variables in library-level Ada packages
o C extern and static variables
o FORTRAN common blocks and static variables
Values are expressed in symbolic formats appropriate for their
respective variables. For example, Ada variables of enumerated types
are expressed in terms of their enumeration image rather than their
underlying integer representation. In addition to the services that
return and expect values expressed in symbolic format, a low-level
interface that reads and writes variables without symbolic formatting
is provided.
The services are available in a single library, /usr/lib/libdm.a,
which includes both the FORTRAN and C interfaces.
2. Documentation
The following documentation describes this release:
_______________________________________________________
| Manual Name Pub. Number |
|______________________________________|_______________|
| Data Monitoring Library Release Notes| 0890482-2.2.1|
| PowerUX Guide to Real-Time Services | 0890479-020 |
|______________________________________|_______________|
Consult the datamon(3x) and datamon(3f) man pages for abbreviated
descriptions of each service.
Consult Chapter 10 of the PowerUX Guide to Real-Time Services
(0890479) for a detailed description of each service.
- 2 -
Release Notes 2.2.1 Data Monitoring Library
3. Prerequisites
Prerequisites for Data Monitoring Library version 2.2.1 are as
follows:
3.1 Hardware
o Any Series 6000, Power Hawk TM 610, or Motorola MVME1604
3.2 Software
o PowerUX 2.2
4. Changes In This Release
The Data Monitoring Library version 2.2.1 changed from the previous
version in the following manner.
o The syntax for expanded notation was modified to allow
specification of a source file.
o Expanded notations that reference more than one variable are now
rejected. In the previous release, one of the variables
referenced by the expanded notation was chosen at random.
Variables may always be unambiguously specified by including the
source file name (enclosed in quotation marks) as part of the
expanded notation.
o The dm_list routine no longer ignores the qualifier argument in
list_scopes mode; if a nonnull value is specified, then dm_list
will list all scopes immediately enclosed by the scope specified
by qualifier.
o A new function, dm_get_enum_image, has been added to provide the
image of an enumeration literal given an object of some
enumeration type and a position within that enumeration type.
o A new error code, DM_AMBIG, has been added. This error code is
returned on operations that specify an expanded notation that
does not unambiguously identify a variable.
o All fixes to bugs found in the previous release have been
incorporated in this release.
- 3 -
Data Monitoring Library 2.2.1 Release Notes
5. Cautions
The dm_list routine no longer ignores the qualifier parameter in
list_scopes mode; to achieve the same effect as in the previous
release (i.e. no qualification), a null string should be passed
instead.
The internal format of enumerated and structured types defined in
datamon.h and datamon_.h changed; therefore, applications using these
header files must be recompiled before being relinked.
6. Installation
The datamon installation tape contains the datamon library, header
files, and man pages. Please refer to the "Installing Add-on
Software" chapter in the System Administration Volume 1 (0890429)
manual for instructions on software installation.
7. Known Problems
None.
8. Direct Software Support
Software support is available from a central source. If you need
assistance or information about your system, please contact the Harris
Software Support Center at our toll free number (1-800-245-6453). Our
customers outside the continental United States can contact us
directly at 1-305-971-6248. The Software Support Center operates
Monday through Friday from 8 a.m. to 7 p.m., Eastern Standard time.
Calling the Software Support Center gives you immediate access to a
broad range of skilled personnel and guarantees you a prompt response
from the person most qualified to assist you. If you have a question
requiring on-site assistance or consultation, the Software Support
Center staff will arrange for a field analyst to return your call and
schedule a visit.
Harris provides a Software Action Request (SAR) form which our
customers can fill out and submit to their local field analyst or the
Software Support Center. This procedure ensures that your request is
entered into our SAR database for follow-up and action.
- 4 -
Release Notes 2.2.1 Data Monitoring Library
To obtain copies of SAR forms, call the Software Support Center and
request form number CSD1833B.
- 5 -
Contents
1. Introduction................................................... 1
2. Documentation.................................................. 2
3. Prerequisites.................................................. 3
3.1 Hardware.................................................. 3
3.2 Software.................................................. 3
4. Changes In This Release........................................ 3
5. Cautions....................................................... 4
6. Installation................................................... 4
7. Known Problems................................................. 4
8. Direct Software Support........................................ 4
- i -
_________________________________________________________________
HARRIS
COMPUTER SYSTEMS
_________________________________________________________________
Data Monitoring Library
Version 2.2.1
Release Notes
0890482-2.2.1
April 1996
_________________________________________________________________
return to index
================================================================================
================================================================================
Data Monitoring Library*
Version 3.1
Release Notes
Harris Computer Systems Corporation
1. Introduction
The Data Monitoring Library provides C and FORTRAN callable services
for nonintrusive monitoring of variables in executing processes.
Data monitoring is effected through the use of the usermap(3rt)
service, which employs the /proc file system (proc(4)) to read and
write the address space of executing processes. The data monitoring
services require symbolic information from the executable files of the
processes to be monitored; thus, portions of the executable files must
be built with the -g (debug) compilation option (C, FORTRAN, and Ada).
Data monitoring includes the following general capabilities:
o Retrieve values of variables (or components of variables) in a
target process
o Modify variables (or components of variables) in a target process
o Retrieve/Modify user-specified memory locations in a target
process
o Retrieve information about variables (or components of variables)
in a target process (type, address, dimensions, constraints,
etc.)
o List the components of a composite variable (e.g. record,
structure, array) (C interface only)
__________
* These release notes cover the following products: datamon
- 1 -
Data Monitoring Library 3.1 Release Notes
o Scan an executable file for variables that can be monitored (C
interface only)
o Variables in library-level Ada packages
o C extern and static variables
o FORTRAN common blocks and static variables
Values are expressed in symbolic formats appropriate for their
respective variables. For example, Ada variables of enumerated types
are expressed in terms of their enumeration image rather than their
underlying integer representation. In addition to the services that
return and expect values expressed in symbolic format, a low-level
interface that reads and writes variables without symbolic formatting
is provided.
The services are available in a single library, /usr/lib/libdm.a,
which includes both the FORTRAN and C interfaces.
2. Documentation
The following documentation describes this release:
_____________________________________________________
| Manual Name Pub. Number|
|______________________________________|_____________|
| Data Monitoring Library Release Notes| 0890482-3.1|
| PowerUX Guide to Real-Time Services | 0890479-030|
|______________________________________|_____________|
Consult the datamon(3x) and datamon(3f) man pages for abbreviated
descriptions of each service.
Consult Chapter 10 of the PowerUX Guide to Real-Time Services
(0890479) for a detailed description of each service.
- 2 -
Release Notes 3.1 Data Monitoring Library
3. Prerequisites
Prerequisites for Data Monitoring Library version 3.1 are as follows:
3.1 Hardware
o Any Series 6000, Power Hawk TM 610, or Motorola MVME1604
3.2 Software
o PowerUX 2.2 or later
4. Changes In This Release
The Data Monitoring Library version 3.1 changed from the previous
version in the following manner.
o Corrections were made in the determination of the address of
variables in packages marked with pragma shared_package or pragma
memory_pool for programs built with shared libraries.
o Corrections were made in locating components of complex record
types.
o All fixes to bugs found in the previous release have been
incorporated in this release.
5. Cautions
None.
6. Installation
The datamon installation tape contains the datamon library, header
files, and man pages. Please refer to the "Installing Add-on
Software" chapter in the System Administration Volume 1 (0890429)
manual for instructions on software installation.
- 3 -
Data Monitoring Library 3.1 Release Notes
7. Known Problems
None.
8. Direct Software Support
Software support is available from a central source. If you need
assistance or information about your system, please contact the Harris
Software Support Center at our toll free number (1-800-245-6453). Our
customers outside the continental United States can contact us
directly at 1-305-971-6248. The Software Support Center operates
Monday through Friday from 8 a.m. to 7 p.m., Eastern Standard time.
Calling the Software Support Center gives you immediate access to a
broad range of skilled personnel and guarantees you a prompt response
from the person most qualified to assist you. If you have a question
requiring on-site assistance or consultation, the Software Support
Center staff will arrange for a field analyst to return your call and
schedule a visit.
Harris provides a Software Action Request (SAR) form which our
customers can fill out and submit to their local field analyst or the
Software Support Center. This procedure ensures that your request is
entered into our SAR database for follow-up and action.
To obtain copies of SAR forms, call the Software Support Center and
request form number CSD1833B.
- 4 -
Contents
1. Introduction................................................... 1
2. Documentation.................................................. 2
3. Prerequisites.................................................. 3
3.1 Hardware.................................................. 3
3.2 Software.................................................. 3
4. Changes In This Release........................................ 3
5. Cautions....................................................... 3
6. Installation................................................... 3
7. Known Problems................................................. 4
8. Direct Software Support........................................ 4
- i -
_________________________________________________________________
HARRIS
COMPUTER SYSTEMS
_________________________________________________________________
Data Monitoring Library
Version 3.1
Release Notes
0890482-3.1
July 1996
_________________________________________________________________
return to index
================================================================================