Dismiss
InnovationQ will be updated on Sunday, Oct. 22, from 10am ET - noon. You may experience brief service interruptions during that time.
Browse Prior Art Database

Message Logging Services for Personal Computer Systems

IP.com Disclosure Number: IPCOM000113448D
Original Publication Date: 1994-Aug-01
Included in the Prior Art Database: 2005-Mar-27
Document File: 4 page(s) / 140K

Publishing Venue

IBM

Related People

Peterson, ST: AUTHOR

Abstract

Described is a software facility enhancement for Personal Computer (PC) systems ImagePlus* Application Management Services/2 (IPAMS/2) programming facility. The enhancement provides Message Logging Service (MLS) capability for users of IPAMS/2 so that a user may control error logging functions and the ability to retrieve error logs by means of an off-line sort of an error log field.

This text was extracted from an ASCII text file.
This is the abbreviated version, containing approximately 41% of the total text.

Message Logging Services for Personal Computer Systems

      Described is a software facility enhancement for Personal
Computer (PC) systems ImagePlus* Application Management Services/2
(IPAMS/2) programming facility.  The enhancement provides Message
Logging Service (MLS) capability for users of IPAMS/2 so that a user
may control error logging functions and the ability to retrieve error
logs by means of an off-line sort of an error log field.

      The IPAMS/2 provides a programmatic method for users of
applications by enabling them to retrieve all of the information
related to a reported error from its original lowest level cause and
to return the value reported back to the user.  At the same time, the
IPAMS/2 provides a means to be able to browse the error log file,
using a normal text editor, so as to observe the operations of the
system.

      The concept described herein enhances the IPAMS/2 by
implementing MLS functions in conjunction with the IPAMS/2.  The
IPAMS/2 MLS functions provides the ability to record information in
user defined files and makes it possible for users of applications to
optionally maintain logs separate from those maintained by IPAMS/2.
In addition, the functions provide a method whereby messages recorded
by IPAMS/2 services can be related to messages recorded by an
application.

      In actual operation, the IPAMS/2 MLS provides a means of
recording formatted readable messages in circular files managed by
the MLS as well as managing linkages between the messages.  The
process enables retrieval of all the messages relating to a
particular item in question so that the retrieval may be readily
accomplished by invoking a simple retrieval mechanism.  It provides a
set of Application Program Interfaces (APIs) to define and manage
message files and to record and retrieve messages from these files.
To accomplish this, the IPAMS/2 MLS uses the IPAMS/2 return code
structure (RCSTRUCT) that is used in all IPAMS/2 APIs to report the
status of requests made to IPAMS/2 services.  Contained within the
RCSTRUCT is a message log handle (MLH) field which is the controlling
mechanism for the management of message chains maintained by MLSs.

      An IPAMS/2 MLS managed file consists of a user defined number
of entries that usually contain from two to four lines of seventy-two
ASCII characters each.  A message entry is formatted into multiple
seventy-two character lines so that it may be viewed with most text
editors without the need to scroll horizontally to see the entire
message text.  A typical message entry contains the following
information:

o   A MLH (hErrLog) for identifying a chain of messages within a
    message file.

o   The time and date of the entry.

o   The identification (ID) of the process from which the message
    request was made.

o   A code set by the function calling MLS.  Typically, a return code
    created by the user to identify an error condition.

o   A...