Business events ZBEVF command enhancements improve the usability of the usage and error displays and provide several new ways to search for and display business events and dispatch adapters.
Previously, the ZBEVF usage and error displays listed information for all business events and dispatch adapters across all ECB activation levels. In most cases, however, you need the usage or error counts only for deployed items at the current activation level. The display contained more information than necessary because it included undeployed items or listed items multiple times if the same item was included in multiple loadsets. In addition, you could use the ZBEVF command to list all business events or dispatch adapters or list information for a specific business event or dispatch adapter. However, the ZBEVF command could not be used to display a subset of business events.
Display usage and error counts
With this enhancement, the default behavior for the ZBEVF command is updated to display usage and error counts only for deployed business events and dispatch adapters at the current ECB activation level. As shown below, the display is also updated to include the type of event (signal event, data event for z/TPFDF, and data event for z/TPF) as well as separate totals for business events and dispatch adapters.
==> ZBEVF DISPLAY USAGE
BEVF0021I 08.27.35 COLLECTION OF BUSINESS EVENT USAGE STARTED.
DISPLAY WILL BE IN 4 SECONDS.+
BEVF0059I 08.27.39 DISPLAY OF BUSINESS EVENT USAGE DURING THE 4-SECOND INTERVAL
FILTERS: ACTivation-CURrent STatus-DEPloyed TYPe-ALL
NAME TYPE STATUS LOADSET RATE TOTAL
DFTDdevIRAA DATADF DEPLOY BASE 537 8435767
DFTDdev_Adapter DISPATCH DEPLOY CR7836 536 8435759
AIRFandAIRT2 DISPATCH DEPLOY BASE 223 745634
sendLetter SIGNAL DEPLOY BASE 223 745634
AIRFandAIRT DISPATCH DEPLOY BASE 0 0
CustAdJSONFormat DISPATCH DEPLOY BASE 0 0
CustAdXMLFormat DISPATCH DEPLOY BASE 0 0
DelLocStdCustAd SIGNAL DEPLOY BASE 0 0
DelRemJSONCust SIGNAL DEPLOY BASE 0 0
DFTDdevIRAB DATADF DEPLOY BASE 0 0
DFTDdevIRA9 DATADF DEPLOY BASE 0 0
IPSendBINAdapter DISPATCH DEPLOY BASE 0 0
JSONtoOpsMyMQ DISPATCH DEPLOY BASE 0 0
TPFDEVTE8C1 DATATPF DEPLOY BASE 0 0
WMQAdCustFormat DISPATCH DEPLOY BASE 0 0
WMQAdNoneFormat DISPATCH DEPLOY BASE 0 0
7 BUSINESS EVENTS MATCH FILTERS TOTALS: 760 9181401
9 DISPATCH ADAPTERS MATCH FILTERS TOTALS: 759 9181393
END OF DISPLAY+
In addition, you can use new filter parameters (ACTIVATION, STATUS, and TYPE) with the USAGE and ERRORS parameters to display any combination of business events, dispatch adapters, deployed items, undeployed items, items at the current ECB activation level, or items at all activation levels. For example, you can display the error counts for just deployed dispatch adapters.
==> ZBEVF DISPLAY ERRORS TYPE-DISPATCH
BEVF0060I 08.59.14 DISPLAY OF BUSINESS EVENT ERRORS
FILTERS: ACTivation-CURrent STatus-DEPloyed TYPe-Dispatch
NAME TYPE STATUS LOADSET LAST MIN TOTAL
AIRFandAIRT DISPATCH DEPLOY BASE 0 0
AIRFandAIRT2 DISPATCH DEPLOY BASE 0 0
CustAdJSONFormat DISPATCH DEPLOY BASE 0 0
CustAdXMLFormat DISPATCH DEPLOY BASE 0 0
DFTDdev_Adapter DISPATCH DEPLOY CR7836 0 0
IPSendBINAdapter DISPATCH DEPLOY BASE 0 0
JSONtoOpsMyMQ DISPATCH DEPLOY BASE 0 0
WMQAdCustFormat DISPATCH DEPLOY BASE 0 0
WMQAdNoneFormat DISPATCH DEPLOY BASE 0 0
9 DISPATCH ADAPTERS MATCH FILTERS TOTALS: 0 0
END OF DISPLAY+
Display a subset of business events
Several new parameters are added to the ZBEVF command so you can easily display a subset of business events, allowing you to quickly find business event information without manually searching business event specifications. These new parameters are listed below and are used with the DISPLAY and EVENT parameters to display a list of business events that match the requested criteria.
- DISPADAPTER - Business events that use the specified dispatch adapter
- DISPQUEUE - Business events that use the specified dispatch queue
- EVTYPE - Business events for a specific type of event (signal event, data event for z/TPFDF, or data event for z/TPF)
- ID - Data events defined for the specified z/TPF record ID or z/TPFDF file ID
For example, you can display all business events that use the
DFTDdev_Adapter dispatch adapter.
==> ZBEVF DISPLAY EVENT DISPADAPTER-DFTDdev_Adapter
BEVF0061I 09.30.50 DISPLAY OF BUSINESS EVENTS
FILTERS: DISPAdapter-DFTDdev_Adapter
NAME EVTYPE STATUS FILE IN /sys/tpf_pbfiles/tpf-fdes
DFTDdevIRAA DATADF DEPLOY DFTDdevIRAA.de.evspec.xml
DFTDdevIRAB DATADF DEPLOY DFTDdevIRAB.de.evspec.xml
DFTDdevIRA9 DATADF DEPLOY DFTDdevIRA9.de.evspec.xml
3 BUSINESS EVENTS MATCH FILTERS
END OF DISPLAY+
Display items using wildcard characters
With this enhancement, most of the ZBEVF parameters that accept a name (business event name, dispatch adapter name, file name, dispatch queue name, and ID) support wildcard characters. Supported wildcard characters are the asterisk (*), which matches zero or more characters, and the question mark (?), which matches exactly 1 character. Multiple wildcard characters can be used and can occur anywhere in the string. Depending on your naming conventions, you can use wildcard characters to display related groups of business event files, business events, or dispatch adapters. For example, you can use wildcard characters with the FILE parameter to display all business event files that start with a specific prefix.
==> ZBEVF DISPLAY FILE-FLY*
BEVF0063I 10.02.04 DISPLAY OF BUSINESS EVENT FILES
FILTERS: FILe-FLY*
NAME TYPE STATUS FILE IN /sys/tpf_pbfiles/tpf-fdes
ArrUEnrWMQCBEFmt SIGNAL UNDEP FLYTArrivalUserEnrichCBEWMQAd.evspec.xml
CustAdJSONFormat DISPATCH DEPLOY FLYTCustomAdapterJSONFormat.evda.xml
CustAdXMLFormat DISPATCH DEPLOY FLYTCustomAdapterXMLFormat.evda.xml
DelLocEnCustCust SIGNAL UNDEP FLYTDelayLocalEnrichCustFormCustAd.evspec.xml
DelLocCBECustAd SIGNAL UNDEP FLYTDelayLocalNoEnrichCBECustAd.evspec.xml
DelLocStdCustAd SIGNAL DEPLOY FLYTDelayLocalNoEnrichStdCustAd.evspec.xml
DelRemJSONCust SIGNAL DEPLOY FLYTDelayRemoteNoEnrichJSONAd.se.evspec.xml
DepartLocEnrich SIGNAL UNDEP FLYTFlightDepartingLocalEnrichMultipleAdapters
.evspec.xml
LocCustAdCustFmt SIGNAL UNDEP FLYTLocalQueueCustAdapterCustFormat.evspec.xml
UsrWMQAdCustFmt SIGNAL UNDEP FLYTUserQueueWMQAdapterCustomFormat.evspec.xml
WMQAdCustFormat DISPATCH DEPLOY FLYTWMQAdapterCustomFormat.evda.xml
WMQAdNoneFormat DISPATCH DEPLOY FLYTWMQAdapterNONEFormat.evda.xml
12 FILES MATCH FILTERS
END OF DISPLAY+
Another use of wildcard characters is to use the asterisk to display the requested information for all business events. For example, you can use ID-* to display all data events and the z/TPF record ID or z/TPFDF file ID for those events.
==> ZBEVF DISPLAY EVENT ID-*
BEVF0067I 10.15.54 DISPLAY OF DATA EVENTS
FILTERS: ID-*
NAME EVTYPE STATUS ID FILE IN /sys/tpf_pbfiles/tpf-fdes
DFTDdevIRA9 DATADF DEPLOY B0A9 DFTDdevIRA9.de.evspec.xml
DFTDdevIRAA DATADF DEPLOY B0AA DFTDdevIRAA.de.evspec.xml
DFTDdevIRAB DATADF DEPLOY B0AB DFTDdevIRAB.de.evspec.xml
Credit_Trxns DATADF UNDEP B212 Credit_Trxns.de.evspec.xml
PurchaseUpdate DATADF UNDEP B412 PurchaseUpdate.evspec.xml
TPFDEVTE8C1 DATATPF DEPLOY E8C1 DEB5_E8C1_YA_destination.de.evspec.xml
TPFDEVTE8C2 DATATPF UNDEP E8C2 DEB5_E8C2_YB_destination.de.evspec.xml
7 BUSINESS EVENTS MATCH FILTERS
END OF DISPLAY+
A similar approach can be used with the DISPADAPTER and DISPQUEUE parameters to display all events and their dispatch adapters or display all events and their dispatch queues.
For more information about APAR PJ46577, see the APEDIT.