Progress
Language Reference


SUBSCRIBE Statement

Interfaces
OS
SpeedScript
All
All
Yes

Creates a subscription to a Progress named event.

NOTE: Progress named events are completely different from the key function, mouse, widget, and direct manipulation events described in the “Events Reference” chapter in this manual. For more information on Progress named events, see the Progress Programming Handbook .

SYNTAX

SUBSCRIBE [ PROCEDURE subscriber-handle ]
  [ TO ] event-name
  { IN publisher-handle | ANYWHERE }
  [ RUN-PROCEDURE local-internal-procedure ]
  [ NO-ERROR ] 

PROCEDURE subscriber-handle

A procedure or handle representing the subscriber.

The PROCEDURE option lets one procedure create a subscription on behalf of another. For example, if you want procedure A to create a subscription on behalf of procedure B, set subscriber-handle to the procedure handle of B.

If the PROCEDURE option does not appear, Progress creates a subscription on behalf of THIS-PROCEDURE, the procedure that contains the SUBSCRIBE statement.

TO event-name

A quoted string or a character expression representing the name of the event.

IN publisher-handle

Subscribes to the named events published by publisher-handle.

If publisher-handle is not a valid procedure or widget handle at the time the SUBSCRIBE statement executes, Progress reports a run time error unless you specify the NO-ERROR option.

ANYWHERE

Subscribes to named events published within the Progress session-regardless of the publisher.

RUN-PROCEDURE local-internal-procedure

A quoted string or character expression representing the name of an internal procedure that resides within the subscribing program. Progress runs local-internal-procedure when the named event occurs.

If the RUN-PROCEDURE option does not appear, when the named event occurs, Progress runs an internal procedure with the same name as the named event.

NOTE: The RUN-PROCEDURE option lets you create a subscription when the event name and the procedure name do not match, or when you must subscribe to two different events that have the same name.

When the named event occurs, Progress RUNs each subscriber’s local internal procedure, passing the parameters, if any, The order in which Progress notifies subscribers is undefined. Progress always performs this RUN with an implicit NO-ERROR, and logs errors to the ERROR-STATUS system handle.

NO-ERROR

Tells Progress not to report a run time error if publisher-handle or subscriber-handle is not a valid procedure handle, or if Progress cannot evaluate an event-name expression. Errors are still generated, however, and are stored in the ERROR-STATUS handle.

EXAMPLE

For an example, see the reference entry for the PUBLISH Statement in this manual.

NOTES

SEE ALSO

PUBLISH Statement, PUBLISHED-EVENTS Attribute, UNSUBSCRIBE Statement


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095