ZBEVF SET: Set business event processing control values

Use this command to set business event processing control values.

Last updated

Added in 2023.

Requirements and restrictions

None.

Format

Read syntax diagramSkip visual syntax diagramZBEVF SET MAXEVents- maxeventvalMAXECBs- maxecbval DISPQueue- dispatchQueueNameMAXERRors- maxerrvalQDEPthwarn- qdepthval
MAXEVents-maxeventval
Sets the maximum number of tpf_bev_signal function calls that one entry control block (ECB) can run in 1 second, where maxeventval is a value of 0 or a value in the range 2 - 999999. If an ECB runs more than the specified number of function calls, the ECB exits with system error 064014. If you specify a value of 0, there is no maximum; that is, an unlimited number of business events can be processed per second by the ECB. The initial value is set to 0.
MAXECBs-maxecbval
Sets the maximum number of ECBs that can process items from the named business event dispatch queue, where maxecbval is a value in the range 1 - 99999. The initial value is set to 1. If you specify a value of 0, this parameter is automatically set to 1.
DISPQueue-dispatchQueueName
Specifies the dispatch queue that the maximum number of ECBs are set for, where dispatchQueueName is the name of the dispatch queue that must start with IBEV.UNORDERED. The dispatch queue can be an unordered user-defined dispatch queue, or the system default dispatch queue. Specify IBEV.UNORDERED.DISPATCH.QUEUE for the system default dispatch queue.
MAXERRors-maxerrval
Sets the maximum number of errors that can occur in a 1-minute time period for a business event dispatch adapter before the dispatch adapter is automatically undeployed, where maxerrval is a value in the range 0 - 999999. If you specify a value of 0, there is no maximum; that is, business event processing does not check for the maximum number of errors in 1 minute. The initial value is set to 0.
QDEPthwarn-qdepthval
Sets the queue depth warning level for business event dispatch queues, where qdepthval is a value in the range 0 - 999999. A warning message is issued if the number of messages on a dispatch queue is larger than the value specified by this parameter. If you specify a value of 0, a warning message is not sent. The initial value is set to 0.

Additional information

  • Online help information is available for this command. To display the help information, enter one of the following commands:
    • ZBEVF HELP
    • ZBEVF ?
  • The ZBEVF commands rely on the following business event deployment descriptors:
    • Business event specification, which is a z/TPF-specific XML file that is a valid instance of the specific business event specification schema.
    • Business event dispatch adapter specification, which is a z/TPF-specific XML file that is a valid instance of the specific business event dispatch adapter specification schema.

Examples

The following example shows how to set the maximum number of tpf_bev_signal function calls that one ECB can run in one second.
User:   ZBEVF SET MAXEVENTS-200

System: BEVF0009I 10.03.11 BUSINESS EVENTS MAXEVENTS HAS BEEN SET TO 200
The following example shows how to set the maximum number of ECBs that can process items from the system default dispatch queue.
User:   ZBEVF SET MAXECBS-50 DISPQUEUE-IBEV.UNORDERED.DISPATCH.QUEUE

System: BEVF0024I 10.06.10 BUSINESS EVENTS MAXECBS HAS BEEN SET TO 50 FOR DISPATCH
        QUEUE IBEV.UNORDERED.DISPATCH.QUEUE+
The following example shows how to set the maximum number of ECBs that can process items from unordered user-defined dispatch queue IBEV.UNORDERED.MY.QUEUE.
User:   ZBEVF SET MAXECBS-25 DISPQUEUE-IBEV.UNORDERED.MY.QUEUE

System: BEVF0024I 09.47.32 BUSINESS EVENTS MAXECBS HAS BEEN SET TO 25 FOR DISPATCH
        QUEUE IBEV.UNORDERED.MY.QUEUE+
The following example shows how to set the maximum number of errors that can occur in a 1-minute time period for a business event dispatch adapter before the dispatch adapter is automatically undeployed.
User:   ZBEVF SET MAXERRORS-100

System: BEVF0011I 10.07.48 BUSINESS EVENTS MAXERRORS HAS BEEN SET TO 100
The following example shows how to set the queue depth warning level for business event dispatch queues. A warning is issued if the number of messages on a dispatch queue is larger than the value specified by this parameter.
User:   ZBEVF SET QDEPTHWARN-3000

System: BEVF0025I 10.09.08 BUSINESS EVENTS QDEPTHWARN HAS BEEN SET TO 3000