Defining groups of IMS data stores

The Datastore Groups panel allows you to view groups of IMS data stores controlled by IMS Connect Extensions. To access this ISPF panel, select option 1.4 Datastore Groups from the IMS Connect Extensions primary menu.

The Datastore Groups panel is displayed with a list of IMS data store groups defined in your IMS Connect Extensions repository. Use the Filter field to list only items that match a filter pattern.

Figure 1. The Datastore Groups panel in the IMS Connect Extensions ISPF dialog

  File  Menu  Settings  Help 
──────────────────────────────────────────────────────────────────────────────
                               Datastore Groups                   Row 1 from 1 
Command ===>                                                  Scroll ===> PAGE

Filter . . .           (Blank or pattern)

Enter "/" to select action

/   Name      Description                     ----- Changed -----     ID    
    ORG1                                      2018/07/27 14:36:02  AXL
******************************* Bottom of data ********************************

To define a new group, enter NEW on the Command line. Enter the 1-8 character name of your list and press Enter. The Datastore Group panel is displayed.

Figure 2. The Datastore Group panel in the IMS Connect Extensions ISPF dialog

  File  Menu  Settings  Help 
──────────────────────────────────────────────────────────────────────────────
EDIT                      Datastore Group                      Row 1 to 3 of 3 
Command ===>                                                  Scroll ===> PAGE

Name  . . . . : ORG1     
Description . .                                

Datastore Group Options:                                                       
    Activate Pacing     
    Warning threshold . . 0       Reject threshold . . 0      

               - Primary for -
/   Datastore  System   Active  Description                    
    IMD1       HWS1     YES     Payroll IMS for HWS1
    IMD2       HWS2     YES     Payroll IMS for HWS2
    IMD3       HWS3     YES     Payroll IMS for HWS3
******************************* Bottom of data ********************************

The panel displays the following information. Enter line action / next to an IMS data store name to see a complete list of options.

Note: To add an IMS data store to the group, use the Datastore panel. See Defining IMS data stores.

Name

The name of the IMS data store group.

Description

A description of this group

Activate Pacing

This field allows you to activate and deactivate the transaction pacing feature for this group.

Transaction pacing monitors incoming transaction request rates according to thresholds assigned to this group. Based upon these thresholds, IMS Connect Extensions either issues warning messages or rejects transactions.

The acceptable field values are:

/: Transaction pacing is activated for this group. Where pacing threshold settings have been defined, these will be honored. Warning messages or transaction rejections may occur.
Note: Pacing must also be active in the system definition. See Defining IMS Connect systems.
blank: Transaction pacing is not active for this group.

The following fields apply to transaction pacing:

Warning Threshold

This field defines the Warning Transaction threshold for this group. At this threshold, IMS Connect Extensions issues a warning message to the IMS Connect Extensions message log and z/OS® operator console indicating this threshold level has been exceeded.

At the group level, warning thresholds use the Interval Count as defined in the system definition. See Defining IMS Connect systems.

The acceptable field values are any number less than 999999. A value of 0 deactivates warning processing for this group.

Reject Threshold

This field defines the reject transaction rate for this group. At this threshold IMS Connect Extensions rejects incoming messages. A message is issued to the IMS Connect Extensions message log and z/OS operator console indicating maximum pacing rates have been reached.

At the group level, reject thresholds use the Interval Count as defined in the system definition. See Defining IMS Connect systems.

The acceptable field values are any number less than 999999. A value of 0 deactivates reject processing for this group.

Commands

You can use the following commands in the Command field:

LOCATE string: Locate the specified IMS data store definition.
NEW: Create a new IMS data store definition using the current group.
REFRESH: Refresh the list of IMS data stores.
RESET: Clear line actions.
SORT column: Sort the IMS data stores by the specified column.