GwManagedStatus()

Retrieves the managed status of a specified entity. This rule checks for managed status by containment, and returns the actual managed status of the entity. For example, if the entity ID represents an entity contained in an unmanaged main node, then the contained entity is implicitly unmanaged and this rule returns the status as unmanaged, regardless of the status given in the ncimCache.managedStatus table.

Syntax

The GwManagedStatus(); statement uses the following syntax.

GwManagedStatus ( entity ID );

Arguments

The following table lists the properties of the arguments of this stitcher rule.
Table 1. Arguments of GwManagedStatus()
Argument Description Accepts constants Accepts variables Accepts eval clauses
entity ID Integer entity ID of the entity. Yes Yes Yes

Returns

This stitcher returns the managed status value for the specified entity.

Updating the current in-scope event

This example retrieves the managed status of the entity with entity ID 99. If this entity is listed as unmanaged in the managedStatus table, or a containing main node of entity ID 99 is unmanaged, then this rule will return the managed status value for entity ID 99 as unmanaged.
int nmosEntityId = 99;
int status = GwEntityData( nmosEntityId );