NOTIFYME

NAME
UNIX SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
SEE ALSO
DIAGNOSTICS
BUGS and LIMITATIONS

NAME

notifyme - ldm NOTIFYME example client

UNIX SYNOPSIS

notifyme [−vxyz] [−l logdest] [−h remote] [−p pattern] [−f feedtype] [−o offset] [−t timeout] [−T TotalTimeo]

DESCRIPTION

This program receives notification messages from the Unidata Local Data Management system (ldm) and optionally prints the notification information with timestamps. It establishes a connection with the LDM server at remote and requests notification of the arrival data whose identifier matches pattern. As data arrives at the server, notification is sent to this program.

This program is an example of how to use ldm4 notification.

OPTIONS

−f feedtype

Requests that notification of data that originates in a feed type of type feedtype be sent along. The default is ‘ANY’.

−h remote

Requests notification from the ldm server on remote. Default is "localhost".

−l logdest

Log to logdest. One of ’’ (system logging daemon), ’-’ (standard error stream), or file logdest. Default is the standard error stream if the process has a controlling terminal (i.e., the process isn’t a daemon); otherwise, either the LDM log file or the system logging daemon (execute this program with just the option ’-?’ to determine which).

−o offset

Requests notification for data that arrived offset seconds before NOW. The default is 0.

−p pattern

Requests that notification of data be sent along that matches pattern. The default is ‘.*’.

−T TotalTimeo

Give up attempting to make a connection after TotalTimeo seconds. Any partially built up client connnection is destroyed and we start over.

−t timeout

Sets the RPC timeout on FEEDME requests to timeout seconds.

−v

Verbose flag. If present, the log will contain a line for each product that was received. Each line reports (1) the current system time, (2) the string ’notifyme’, (3) the product size, (4) the time the product was injected into the IDD, (5) the feed type, (6) a sequence number, and (7) the product ID with the actual product time. (If you take the difference between the first and fourth fields, you can see how long it took the product to arrive at the host.)

−x

Requests that debugging information also be printed.

-y

Use logging timestamps with microsecond resolution. The default is second resolution.

-z

Use logging timestamps formatted according to the ISO 8601 standard (e.g. YYYYMMDDThhmmss). The default is Mon day hh:mm:ss

EXAMPLE

The command

notifyme -v

will let you watch the data come in to the local host.

SEE ALSO

ldmd(1), ldmd.conf(5), feedme(1)

DIAGNOSTICS

Error messages and log messages are written to the log file.

BUGS and LIMITATIONS

While this is the most important diagnostic tool in the LDM package, if you leave off the -v flag, you won’t see much.