Refreshing in-memory definitions from the IMS Connect Extensions repository

Use the Refresh Commands panel to reload IMS Connect Extensions in-memory definitions for the selected system from definitions stored in the IMS Connect Extensions repository. To access this ISPF panel, select option 2 Refresh on the Commands panel.

The Refresh Commands panel displays a list of definitions that can be reloaded from the IMS Connect Extensions repository.
Figure 1. The Refresh Commands panel in the IMS Connect Extensions ISPF dialog
  File  Menu  Help 
──────────────────────────────────────────────────────────────────────────────
                               Refresh Commands 
Command ===>                                                                  

System . . : HWS1     

Select an option then press Enter.
2  1. System Definition
   2. Datastore . . . . . . . . IMSB      +
   3. Datastore Group . . . . .           +
   4. Affinity List . . . . . .           +
   5. Application . . . . . . .           +
   6. Transaction . . . . . . .           +
   7. OTMA Routing Rules
   8. ODBM Routing Rules                                                      
   9. IP Address Rules
To refresh a set of definitions, complete the following steps:
  1. For IMS Connect systems definitions and routing rules, simply type the associated number and then press Enter. For all other types, use the Prompt function key (F4) first to select a definition of that type and then press Enter. These definitions can only be refreshed for the system on which the command will run.
  2. Select all of the commands displayed on the Command Preprocessor panel by entering line action / next to each command.
  3. Press Enter to submit the request. The result for each command is displayed in the Response column. A response of 0000 indicates that the command was processed successfully.
    Note: Values will be reloaded from the definition in the IMS Connect Extensions repository regardless of whether they have been changed. Any changes previously made by setting override values will be lost. See Setting in-memory IMS Connect Extensions definitions.
  4. Use the message log to view the results of the refresh. See Browsing the message log for an IMS Connect.
Use the following information to determine which values in each definition will be refreshed.
Note: All definitions in the IMS Connect Extensions repository are refreshed on an IMS Connect system restart, even if they are not listed in the section below.
1 System Definition
The System Definition option reloads values from the IMS Connect Extensions repository for the following fields in the System Definition definition:
  • Message recall count
  • Activate Mixed Case Passwords
  • Collection level
  • Activate Pacing
  • Interval count
  • Warning threshold
  • Reject threshold
  • Activate Session Message Limit
  • Limit threshold
  • Activate Security
  • Activate ACEE Cache
  • Ageing interval
  • Activate validation
  • Validation type
  • Security class
  • Activate IP Address Rules
  • Activate OTMA rules
  • Activate ODBM rules
  • Activate Transaction Routing
  • The list of applications defined in the System Definition - Applications panel in the Define Applications for option.
  • Activate Workload Balancing
  • Activate Statistics Collection
For a description of each field, see Defining IMS Connect systems.
Tip: To refresh IMS Connect Extensions journal options, see Managing the IMS Connect Extensions journal.
Important:
  1. Options for pacing, security, transaction routing, workload balancing and statistics collection will not be activated if the IMS Connect system was started with the Activate Advanced Features field set to inactive.
  2. If the list of defined applications is changed, IMS Connect Extensions will reload all transaction definitions associated with the new list of applications.
  3. The security class is reloaded whenever the class name is changed (and the security and IMS Connect validation options are active) or whenever the security option or IMS Connect validation options are activated.
2 Datastore
The Datastore option reloads values from the IMS Connect Extensions repository for the following fields in the Datastore definition:
  • Datastore Group
  • Use as Primary Datastore for IMS Connect System
  • Activate Pacing
  • Warning threshold
  • Reject threshold
  • Routing options (including Also route Send Only requests and Route Resume TPIPE requests to Affinity List)
  • Capacity weight rating
For a description of each field, see Defining IMS data stores.
Important:
  • IMS data stores are only available to be refreshed if they are defined both in the IMS Connect Extensions repository and in the IMS Connect configuration member.
  • If the Datastore Group name, Transaction Routing options or Capacity weight rating were changed in the data store definition in the repository, IMS Connect Extensions will rebuild the Candidate List, updating the Transaction Routing definitions.
  • You cannot add a new data store using the Datastore option. To add a new data store, see Dynamically adding IMS data stores as targets for OTMA routing.
3 Datastore Group
The Datastore Group option reloads values from the IMS Connect Extensions repository for all fields in the Datastore Group definition:
  • Activate pacing
  • Warning threshold
  • Reject threshold
For a description of each field, see Defining groups of IMS data stores.
Important:
  • Groups are only available to be refreshed if they contain a datastore that is defined in the IMS Connect configuration member.
  • You cannot add a new group using the Datastore Group option. To add a new group, use option 2 Datastores and ensure that your new group is referenced by an IMS data store definition that was not previously defined when IMS Connect Extensions was started.
4 Affinity List
The Affinity List option reloads the specified affinity list definition. The list of data stores defined in the affinity list will be rebuilt in memory, replacing the previous definition. See Defining affinity lists.
Important:
  • Affinity lists are only available to be refreshed if they contain an IMS data store that is defined in the IMS Connect configuration member.
  • If any Datastore Affinity or Transaction Affinity refer to the Affinity List, IMS Connect Extensions will rebuild the Candidate List, updating the Transaction Routing definitions.
  • You cannot add a new affinity list using the Affinity List option. To add a new affinity list, it must be referenced by at least one IMS data store, application, or transaction definition that was not previously defined when IMS Connect Extensions was started. Once the reference is in place, use option 1 Datastore, 5 Application, , or 6 Transaction to refresh the definition as appropriate.
5 Application
The Application option reloads values from the IMS Connect Extensions repository for all fields in the Application definition:
  • Activate Transaction Routing
  • Values specified in the Route transactions to option
  • Values specified in the Routing Error processing option
For a description of each field, see Defining applications.
Important:
  • Applications are only available to be refreshed if they are included in the IMS Connect Extensions system definition.
  • Refreshing an application definition will automatically update all the transactions that are part of the application and IMS Connect Extensions will rebuild the Candidate List, updating the Transaction Routing definitions.
  • You cannot add a new application using the Application option. To add a new application, use option 1 System Definition and ensure that your new application is referenced by an IMS Connect system definition.
6 Transaction
The Transaction option reloads values from the IMS Connect Extensions repository for all fields in the Transaction definition:
  • Application
  • Override Transaction Timer
  • Message timeout
  • ACK/NAK timeout
  • Override Transaction Expiration
  • Set F1_TRNEXP
  • Override Client ID Cancellation
  • Set F3_CANCID
  • Activate Transaction Routing
  • Values specified in the Route transactions to option
  • Values specified in the Routing Error processing option
For a description of each field, see Defining transactions.

Users can also use this option to add a new transaction.

Important: If the Application name or Transaction Routing options have been changed in the transaction definition, IMS Connect Extensions will rebuild the Candidate List, updating the Transaction Routing definitions.
7 OTMA Routing Rules
The OTMA Routing Rules option rebuilds all of the system internal routing rules for OTMA messages based on the current routing rule and routing list definitions in the IMS Connect Extensions repository. See Defining OTMA routing rules.
Tip: Routing rules are written to the IMS Connect Extensions log (CEXPRINT) at system startup and after OTMA routing rules are refreshed. See OTMA workload routing in IMS Connect.
Important:
  • If you change the active OTMA routing plan you must then refresh the OTMA routing rules to load the new set of rules. See Setting in-memory IMS Connect Extensions definitions.
  • If you have changed another definition that would affect rules-based routing behavior for OTMA messages, you must refresh that definition first. This is so that when the routing rules are refreshed, they operate on the updated definition. For example, if you have defined a set of routing lists and routing rules and then activated OTMA rules-based routing, you must first refresh the system definition using option 1 System Definition and then refresh the routing rules.
8 ODBM Routing Rules
The ODBM Routing Rules option rebuilds all of the system internal routing rules for DRDA® requests based on the current routing rule, routing list, and ODBM target and PSB name list definitions in the IMS Connect Extensions repository. See Defining ODBM routing rules.
Tip: Routing rules are written to the IMS Connect Extensions log (CEXPRINT) at system startup and after ODBM routing rules are refreshed. See ODBM workload routing in IMS Connect.
Important:
  • If you change the active ODBM routing plan you must then refresh the ODBM routing rules to load the new set of rules. See Setting in-memory IMS Connect Extensions definitions.
  • If you have changed another definition that would affect rules-based routing behavior for ODBM messages, you must refresh that definition first. This is so that when the routing rules are refreshed, they operate on the updated definition. For example, if you have defined a set of routing lists and routing rules and then activated ODBM rules-based routing, you must first refresh the system definition using option 1 System Definition and then refresh the routing rules.
9 IP Address Rules
The IP Address Rules option rebuilds all of the system internal IP address rules for all the IP address rule definitions in the IMS Connect Extensions repository. See Creating workload rules for specific IP addresses.