IEC_BACNET_SUBSCRIBE_COV_INFO (STRUCT)ΒΆ

TYPE IEC_BACNET_SUBSCRIBE_COV_INFO : STRUCT

Subscribe COV Info is the service data type which appears in the Subscribe COV service to transport the information from the COV Client to the COV Server.

InOut:

Name

Type

Comment

fSubscribe

IEC_BACNET_BOOLEAN

The fSubscribe attribute is TRUE if the data structure is used to create a new subscription. It is FALSE if this data structure is used to cancel the existing subscription. In this case the last two attributes (issueConfirmedNotifications and lifetime) are not use by the service routine.

processID

IEC_BACNET_UNSIGNED

The processID attribute is the numeric identifier of the Process within the COV client which shall receive the COV notifications.

monitoredObjectID

IEC_BACNET_OBJECT_ID

The monitoredObjectID attribute is the identifier of the object within the receiving device for which a subscription is desired.

issueConfirmedNotifications

IEC_BACNET_BOOLEAN

The issueConfirmedNotifications attribute indicates whether the COV-server device shall issue ConfirmedCovNotification (TRUE) or UnconfirmedCovNotification (FALSE).

This parameter is not valid if fSubscribe is False.

lifetime

IEC_BACNET_UNSIGNED

The lifetime attribute indicates the lifetime of the subscription in seconds. The value of BACNET_INFINITE_LIFETIME indicates an indefinite lifetime, with shall not automatically cancelled after any time. If the Subscribe COV Info data is to cancel the subscription, then fSubscribe value is FALSE.

This parameter is not valid if fSubscribe is False.

activeSubscribers

IEC_BACNET_UNSIGNED

Contains the number of active subscriptions in the server API database.

This is the number of subscribers to this object (only valid in the service hook as additional information for the user application from the server API, otherwise this parameter is 0 and shall be ignored by the application).