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
- 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