Defining ODBM routing rules

ODBM routing rules enable you to specify routing behavior for DRDA requests. They convert an input alias into a target selected from a collection of ODBM targets that you specify. To define an ODBM routing rule, use the ODBM Routing Rules panel. To access this ISPF panel, select option 1.12 ODBM Routing Rules from the IMS Connect Extensions primary menu.

The ODBM Routing Rules panel is displayed with a list of ODBM routing rules defined in your IMS Connect Extensions repository. Use the Filter field to list only items that match a filter pattern.

Figure 1. The ODBM Routing Rules panel in the IMS Connect Extensions ISPF dialog
   File  Menu  Settings  Help 
 ──────────────────────────────────────────────────────────────────────────────
 CEXDFORR                      ODBM Routing Rules                  Row 1 from 7 
 Command ===>                                                  Scroll ===> PAGE

 Filter . . .           (Blank or pattern)

 Enter "/" to select action
               IMS   PSB name                      ------- Applies to --------
 /   Name      alias list                          Type    Definition Plan     
     DEFRULE   LSB1                                ALL    
     GRPRULE   LSB2  PSBLIST2                      GROUP   ALL      
     HOPSRULE                                      SYSTEM  HWSOPGS1   WEEKLY   
     ODRR1                                         ALL    
     ODRR2                                         GROUP   ALL      
     ODRR3                                         SYSTEM  SBPI01   
     SYSRULE   SSG1  PSBLIST1                      SYSTEM  HWSOPGS1   MAINT    
 ******************************* Bottom of data ********************************

To define a new ODBM routing rule, enter NEW on the Command line. Enter the 1-8 character name of your routing rule and press Enter. The ODBM Routing Rule panel is displayed. In this dialog you will define the routing behavior for DRDA requests with a specified input alias.

Figure 2. The ODBM Routing Rule panel in the IMS Connect Extensions ISPF dialog
  File  Menu  Settings  Help 
──────────────────────────────────────────────────────────────────────────────
EDIT                          ODBM Routing Rule                              
Command ===>                                                                  

Name  . . . . : GRPRULE  
Description . . Alias LSB PSB PSBLIST2        

Apply rule to:                       Rule is active when:
2  1. System  . . . . .           +     Routing Plan . . OFFPEAK   +
   2. Group . . . . . . MF1       +     Rules with no plan are always active
   3. All systems                   

Condition:                                                                    
   Input Alias  . . . . LSB2 
   PSB name list  . . . PSBLIST2  +

                                                      ---- Routing lists -----
/  Request types                                      Target    +  Fallback  +
Y  DRDA Requests                                      NEHROD
The panel displays the following information:
Name
The name of the ODBM routing rule.
Description
A description of this routing rule.
Apply rule to
Specifies the IMS Connect system or systems to which this rule will apply. Choose from the following options:
1 System
Apply the rule to a single system. Use the the Prompt function key (F4) to select from a list of defined systems. To define an IMS Connect system, see Defining IMS Connect systems.
2 Group
Apply the rule to a group of systems. Use the the Prompt function key (F4) to select from a list of defined groups. To define a group, see Defining system groups.
3 All systems
Apply the rule to all IMS Connect systems.
Routing Plan
Optional. Assign the routing rule to a routing plan. A routing plan defines a group of routing rules that are intended to operate at the same time.

Use the Prompt function key (F4) to select from a list of defined routing plans. To define a routing plan, see Defining routing plans.

Note: A routing rule that is not assigned to a routing plan will always be in effect, except when it is overridden by a routing rule that contains a more specific message matching condition.
Condition
Specifies the conditions that must be met by the incoming DRDA request for the rule to take effect. Select from the following options:
Input Alias
The alias name supplied by the client in the DRDA request.
PSB name list
Optional. A list of IMS program specification block (PSB) names that may be in the DRDA request. Use the Prompt function key (F4) to select from a list of defined PSB name lists. To define a PSB name list, see Defining PSB name lists.

If a PSB name list is specified, a routing rule is built for the alias name and each member of the PSB name list. If the PSB name list is blank, the routing rule applies to all PSB names.

Tip: The alias name and PSB name are supplied in the DRDA request message in the distributed data management (DDM) architecture ACCRDB command (X'2001') in the RDBNAM parameter. For more information, refer to the topic ACCRDB command (X'2001') in the IMS documentation. To see what alias and PSB name is being used by your client applications, use IBM IMS Problem Investigator for z/OS to format and view IMS Connect Extensions journal record X'5B' DRDA Request. See Reporting and analysis with IMS Problem Investigator.
Request types
Specify one of the following line actions next to the DRDA Requests field:
Y
Enable DRDA message routing. Requests are routed to a list of ODBM targets specified in the Target field. Use the optional Fallback field to specify a list of fallback ODBM targets in the event that the ODBM targets listed in the Target field are unavailable. Use the Prompt function key (F4) to select a list of defined OTMA routing lists. To define an OTMA routing list, see Defining OTMA routing lists.
blank
Inherit settings from rules applying to the same condition at either the All systems or Group level. A Group level rule will inherit settings from the All systems level. A system level rule will inherit settings from the Group level, if one is defined, otherwise from the All systems level. The Target and Fallback fields are ignored and no routing will occur.
N
Disable ODBM rules-based routing. In other words, this rule will not apply to this request type at the level specified in the Apply rule to field. Any values in the Target and Fallback fields are ignored and no routing will occur.
If there is no higher level rule for the condition, then INHERIT (blank) is the same as DISABLE (N).
  • For SYSTEM the higher level is GROUP and ALL.
  • For GROUP the higher level is ALL.
  • for ALL there is no higher level.

To save your new routing rule, press the Exit function key (F3). The new routing rule is displayed in the ODBM Routing Rules panel.

Before ODBM routing rules can take effect, you must select the Activate ODBM rules option in the system definition. See Defining IMS Connect systems.