Status Policies

An object's status defines the policies available to it. By default, all policies are permitted.

Object Status Policies lists the applicable status policies for devices, subscription, groups, and users.
Table 1. Object Status Policies
Action Device Subscription Group User Description
Create Object X X X X When selected, if a device, subscription, group, or user is in the selected status, a device, subscription, group, or user can be created.
Query Object X X X X When selected, if a device, subscription, group, or user is in the selected status, a device, subscription, group, or user can be queried.
Modify Object X X X X When selected, if a device, subscription, group, or user is in the selected status, a device, subscription, group, or user can be modified.
Delete Object X X X X When selected, if a device, subscription, group, or user is in the selected status, a device, subscription, group, or user can be deleted. For groups, all group members (subgroups or subscriptions) or administrators must be removed before the delete operation. For subscriptions, if a subscription owns devices, there must be no active sessions.
Note: When a subscription is automatically deleted, associated devices are removed from the subscription, but they are not automatically deleted.
Authorize Usage X X When selected, usage can be authorized. If either the device or subscription is in a state that does not allow usage, then usage is blocked.
Purchase X X X When selected, if a device, subscription, or group is in the selected status, product offers can be purchased.
Cancel X X X When selected, if a device, subscription, or group is in the selected status, product offers and bundles can be canceled.
Add Device X When selected, if a subscription is in the selected status, a device can be added.
Remove Device X When selected, if a subscription is in the selected status, a device can be removed.
Auto Recharge X X X When selected, if a device, subscription, or group is in the selected status, automatic recharges are enabled and funds are automatically acquired through Pay Now for the prepaid main balance.
Add Member X X When selected, if a group or user is in the selected status, a member can be added.
Remove Member X X When selected, if a group or user is in the selected status, a member can be removed.
Exclude Device Activity X When selected, if a subscription is in the selected status, the activity for all associated devices is excluded when calculating the subscription's activity and LastActivityTime.
Offline Charging X X When selected, offline usage is allowed. This is the default setting. When this policy is not allowed, an attempt to report offline usage for the subscriber or device causes a SERVICE_DENIED code to be returned.

To enable a policy, it must be selected in the status definition. For example, to deny catalog item purchases when the device life cycle is in status Suspended, the Purchase policy must not be selected.

To enable auto-deletion using Delete Object, the Delete Type field value must be delete_on_inactivity. The Inactivity Unit and Inactivity Count fields must be configured. The Inactivity Unit must be equal to or greater than 1. When the inactivity trigger time is reached, MATRIXX Engine tries to delete the object. If the object is deleted, an EDR is generated, but a notification is not. If the object cannot be deleted, an error is logged. To prevent continual retries, if a delete fails, the delete attempt is considered an activity and therefore resets the inactivity timeout.

When configuring Delete Object:
  • Select the allowed activity types. The activity types available are dependent on the status life cycle object type:
    • Subscriber — All activity types are available.
    • Group — All activity types except usage are available.
    • Subscriber and Group — All activity types except usage are available.
    • Device — Only usage, offer_purchase, offer_cancel, and offer_modify are available.
    • User — Activity types are not used by default.
    If you do not specify an activity type, all activities are allowed. For more information about activity types, see the discussion about status activities.
  • Select if associated subscriptions, devices, or sessions are also automatically deleted when the parent object is deleted. This option does not apply to groups. The selections available depend on the object type:
    • Users — Subscriptions, devices, and open sessions can be deleted.
    • Subscription — Devices and open sessions can be deleted.
    • Devices — Open sessions can be deleted.

      Deleting devices and open sessions is only applicable when also deleting the associated subscriptions.

Note: For SubMan operations, status policies are evaluated on the primary target of the SubMan operation only. The primary target is listed after Request in the SubMan API. For example, in the MtxRequestSubscriberAddDevice API, the primary object is Subscriber. Because the policy is evaluated only on the primary target, when the MtxRequestSubscriberAddDevice API is invoked, the device object status is not considered. Only the primary object is considered when an operation involves multiple objects. For more information about primary targets, see the discussion about SubMan data objects in MATRIXX Subscriber Management API.