Searching event specifications and EP adapter configurations

You can use the event processing (EP) search function to search event bindings and EP adapter configurations for named resources. You can search by variable, structure, and copybook name of an imported language structure. You can search your workspace or installed CICS® resources.

About this task

The EP search is specific to event processing and is provided in CICS Explorer® where you edit event bindings, EP adapter configurations, and other bundle resources in a CICS bundle project. The EP search is available in all perspectives in CICS Explorer from the search menu, and is provided in a separate tab in the search dialog for CICS Explorer.

File search can be used for finding any text in the workspace, whereas the EP search is used to find matches for the named resource in event specifications and EP adapter configurations. The search function checks whether the specified name of the resource matches the predicate when it examines capture specification predicates.

Procedure

  1. From the workbench menu bar, click Search > Search to open the search window, or press Ctrl+H (cmd+H for OSX).
  2. Click the EP Search tab and type the search string.
    EP Search tab in the Search window
  3. Optional: To make the search case sensitive, select the Case sensitive check box.
  4. Optional: To search for a resource type, select the Search for resource type check box and select the required type from the list. You can select one of the following resource types:
    • ABCODE
    • CHANNEL
    • CONTAINER
    • EVENT
    • FILE
    • FROMCHANNEL
    • MAP
    • MAPSET
    • MESSAGE_ID
    • OPERATION
    • PROGRAM
    • QNAME
    • QUEUE
    • SERVICE
    • TRANCLASS
    • TRANSACTION
    • URI
    • URIMAP
    • USER
    • WEBSERVICE
  5. Optional: To limit the search for a resource type to one or more of the context, event options, or EP adapters, select the corresponding check box.
    Note: If the search scope is set to CICS resources installed in a CICS system, the in adapters check box is disabled; you cannot search for EP adapters in an online CICS system.
  6. Optional: Clear the Ignore predicates with operator "All" check box. The default setting for a predicate in a capture specification is All; when this check box is not selected, you receive search matches for all of these default predicates. It is likely that you want to search for capture specifications where the predicates specify filters such as Equals or Starts with for the resource name, so this box is selected by default.
  7. Select or clear one or more check boxes in the Search for source information section. You can search for source information in one of the following entities:
    • Application data
    • Information sources
    When Application data or Information sources is selected, you can search for one or more of the following name types:
    • Variable names
    • Structure names
    • File names
  8. To search your workspace, click Workspace. To search CICS resources installed in a CICS system, click CICS resources installed in, then select a CICSplex from the list.
    The following table shows sample EP searches that you can use with the event binding editor examples:
    Table 1. Example EP searches
    Search string Search for resource type Where found
    EGUI TRANSACTION Context
    EXMPCAT FILE Event option
  9. Optional: Click Customize to set the scope of your search to a file search, EP search, or both. Click OK. This setting is saved across search sessions.
  10. Click Search.

Results

The Search results tab opens. You can expand each search result to show the event specification, capture specification, and location where the search match is. You can double-click on any of these items to load the result into the editor and display it.

Search tab with EP search results