z/TPF - Group home

Business events ZBEVF command enhancements (APAR PJ45677)

  

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.