holdEvents(eventIDs)

Use this method to hold a set of events.

Holding a set of events prevents them from executing. The status of the events change to suspended and can be released by calling event » releaseEvent(eventID).

For more information about event status, see the bibus » runStatusEnum enumeration set and Running Jobs.

Use of this method requires:

  • traverse permission for the ancestors of the target object associated with the event

  • one of the following conditions to be met:

    • The caller has the canUseMonitorActivityTool capability.

      This allows administrators to hold tasks initiated by other users.

    • The passport ID of the caller must match the account associated with the task.

      This allows users to hold their own tasks that are running in the background.

    • The account of the caller must match the account credential used to schedule the task.

      This allows users to hold tasks that they previously scheduled.

Signatures

Java and Apache Axis
 
public  void  holdEvents(java.lang.String[]  eventIDs) 
C# .NET
 
public  void  holdEvents(string[]  eventIDs) 

References

Part of the following method sets:
Implemented by the following services:

The services that implement the holdEvents method, along with the associated SOAP actions, are listed in the following table.

Table 1. Services implementing the holdEvents method.

Service

SOAP Action
eventManagementService

http://www.ibm.com/xmlns/prod/cognos/eventManagementService/201404/

What's new

New in Version 10.1.0 — Administration Capabilities for Background Job Queue Maintenance

This method now requires the caller to have the canUseMonitorActivityTool value capability instead of the canUseAdministrationPortal value capability when a capability check is required.

Related information:

Input parameters

Use the following parameters when calling this method.

eventIDs

Identifies the events.

This argument

  • is an array of type string

    is encoded as type tns:stringArray

Return values

None.