NAME

MQSeries::FDC::Entry -- One entry in an MQSeries FDC file

SYNOPIS

#
# Assuming we get an array of parsed MQSeries::FDC::Entry
# objects from somewhere, here's how we dump them to syslog.
#
use Sys::Syslog;
openlog($0, 'pid', 'daemon');

sub process_fdc_entries {
    foreach my $entry (@_) {
        syslog('info', "$entry"); # Overloaded operator-""
    }
}

DESCRIPTION

The MQSeries::FDC::Entry class is not used directly, but invoked through the MQSeries::FDC::Parser class.

When the MQSeries::FDC::Tail or MQSeries::FDC::Parser classes return an array of entries, these can be queried for their parsed fields.

This class has overloaded the '""' (to-string) operator, which means that printing an object results in reasonable results.

METHODS

new

Create a new MQSeries::FDC::Entry object. The parameters are not documented; use the MQSeries::FDC::Parser class to create these.

get_header

Return a field parsed from the header. Any field from the header is available directly; in addition, a number of parsed fields are derived. Most FDC entries have following standard fields:

Date/Time
Host Name
QueueManager (sometimes missing)
PIDS
LVLS
Product Long Name
Vendor
Probe Id
Application Name
Component
Build Date
UserID
Program Name
Process
Thread
Major Errorcode
Minor Errorcode
Probe Type
Probe Severity
Probe Description
Comment1

In addition, the following parsed fields are available (these have all lower-case names):

uid        (numerical userid from UserID field, if available)
userid     (text userid from UserID field, if available)
event_code (event code from Probe Description, if available)

get_body

Return the body with all details from the FDC entry

as_string

Return a string with the details of this entry; also invoked by the overloaded operator-"".

SEE ALSO

MQSeries(3), MQSeries::FDC::Tail(3), MQSeries::FDC::Parser(3)