Setting Group options

This section describes the procedures for setting Group options.

Group options allow you to treat a user-defined group of IMS systems as one IMS system. A group of IMS systems would typically be an IMS Datasharing Group, IMS Shared Queues Group, or a group of logically related or duplicated IMS systems. When you create or change Group options, the load module DLPZgggg is link-edited to your options library.

Note

Group options are NOT required.

Once you have saved the Group options module, you will have to restart IMS for the changes to take effect. If you perform a Group options REFRESH, the only changes that will take effect are the IMS command options.

You can create a new Group by using the product defaults or by copying the options for a new Group from an existing Group. For more information, see To create a new Group.

Note

When you are choosing a name for your Group options, be sure that you do not duplicate the name used for existing IMSID options. If you duplicate the IMSID options name for your Group options name, the product will not find the Group options because it will locate the IMSID options first.

BMC recommends the following regarding the Group options module:

  • Use the APF-authorized library to provide both ISPF and IMS with access to the Group options module.

  • Do not use a LINKLIST library to store the Group options module.

  • Save the Group options module in the same library with the global and IMSID options modules.

To create a new Group

  1. Invoke the online interface through the modified ISPF/PDF Primary Option Menu that you created in Accessing the products from an ISPF options menu or through the CLIST that you created in Accessing the products from a CLIST.

    The Main Menu is displayed.

  2. Type 4 in the selection field and press Enter.

    The Administration Menu is displayed.

  3. Type 2 in the selection field and press Enter.

    The IMSID/Group Options Entry panel is displayed.

  4. Determine the method that you want to use to create the new Group:

    If you want to create the new Group by

    Go to

    Using the product defaults

    Step 5

    Copying options from an existing Group

    Step 6

  5. Type the name of the new Group in the IMSID or Group field and press Enter.

    The Group options will be populated from internal product defaults.

  6. Type the name of the new Group in the IMSID or Group field and press Enter.

    The Edit Group Options panel is displayed.

    Edit Group Options panel

     File  Edit  Refresh  Format  Options  Help                                   
    -------------------------------------------------------------------------------
                                  Edit Group Options 
    Command ===> __________________________________________________________________
                                                                                   
    Group name  . . . . . . . . : IMSA                                             
                                                                      More:     +  
    BMCXLINK task network LUNAME  DLPALINK                                         
                                                                                   
    DELTA PLUS VT Log Data Set Names.                                              
      Primary Log . . . . . . . . 'DLP.PRI.LOG'                                    
      Secondary Log . . . . . . . 'DLP.SEC.LOG'                                    
                                                                                   
    DELTA PLUS VT History File Data Set Names.                                     
      Primary History File  . . . 'DLP.PRI.HIST'                                   
      Secondary History File  . . 'DLP.SEC.HIST'                                   
                                                                                   
    Command Options.  Select if desired.                                           
    _ Write IMS commands to history file                                           
                                                                                   
    Execution Options.  Select if desired.                                         
    _ Allow coordinated requests even if no IMS is active in group
  7. Type COPY name on the Command line (where name is the name of the existing Group from which you want to copy the Group options) and press Enter.

    The new options will be copied from the existing Group.

To update Group options in the control region

  1. Invoke the online interface through the modified ISPF/PDF Primary Option Menu that you created in Accessing the products from an ISPF options menu or through the CLIST that you created in Accessing the products from a CLIST.

    The Main Menu is displayed.

  2. Type 4 in the selection field and press Enter.

    The Administration Menu is displayed.

  3. Type 5 in the selection field and press Enter.

    The Refresh Menu is displayed.

  4. Type 1 in the selection field.
  5. In the IMSID or Group field, type the name of the Group that you want to update and press Enter.

    The Confirm Options Refresh pop-up window is displayed.

  6. Type 1 in the selection field and press Enter.

    The product refreshes the Group options.

To set Group options

  1. Invoke the online interface through the modified ISPF/PDF Primary Option Menu that you created in Accessing the products from an ISPF options menu or through the CLIST that you created in Accessing the products from a CLIST.

    The Main Menu is displayed.

  2. Type 4 in the selection field and press Enter.

    The Administration Menu is displayed.

  3. Type 2 in the selection field and press Enter.

    The IMSID/Group Options Entry panel is displayed.

  4. Type 2 in the selection field.
  5. Type the data set name of the library in which the Group options module (DLPZgggg) resides in the Options library field.
  6. Perform the appropriate action:

    Activity

    Action

    Indicate a specific Group that you want to customize or access.

    Type the name of the Group in the IMSID or Group field.

    Choose a Group that you want to customize or access from a list of Groups.

    Leave the IMSID or Group field blank.

  7. (optional) If your installation stores IMSID/Group options modules in separate libraries that are used by ISPF, the control region, or BMCXLINK, type the data set name of the additional library in which to store the Group options modules in the Save library 1 field. If ISPF, the control region, and BMCXLINK use the same library, this field is optional.

    Note

    If you use several load libraries, remember that it is possible to have a copy of a module in more than one library. IMS will use the first module that it finds, regardless of whether that module is the most current one available.

    Press Enter.

    Previous action

    Result

    You typed a specific Group name in the IMSID or Group field.

    The Edit Group Options panel is displayed. Go to Step 9.

    You left the IMSID or Group field blank.

    The Edit Group Options - List panel is displayed so that you can select a group. Go to Step 8.

  8. Type S next to the Group that you want to customize or access and press Enter.

    The Edit Group Options panel is displayed.

  9. Specify the Group options.

    The following fields are available on this panel:

    Group name

    The name of the Group that you are creating or modifying. This is not an editable field.

    BMCXLINK task network LUNAME

    Type a network LUNAME for the BMCXLINK VTAM subtask. The LUNAME that you specify MUST match the LUNAME that is specified in the PARM field of the BMCXLINK task.

    The default value for this field is DLPALINK.

    Primary Log

    Type the name of the primary Log data set. For this change to take effect, you must cold-start all IMS systems that are included in the Group.

    Secondary Log

    Type the name of the secondary Log data set. For this change to take effect, you must cold-start all IMS systems that are included in the Group.

    Primary History File

    Type the name of the primary History File data set. For this change to take effect, you must cold-start all IMS systems that are included in the Group.

    Secondary History File

    Type the name of the secondary History File data set. For this change to take effect, you must cold-start all IMS systems that are included in the Group.

    Write IMS commands to history file

    Type a / in the selection field to send IMS operator commands that are issued from a DELTA List or from the Execute IMS Command panel to the History File.

    Allow coordinated requests even if no IMS is active in group

    Type a / in the selection field to allow coordinated requests even if no IMS is active in the group. The Log will be updated with the requests. You need to restart BMCXLINK to apply these requests.

    Copy Group Options to an IMS STEPLIB library when saved

    Type a / in the selection field to copy Group options modules to an IMS //STEPLIB library when the module is saved in the options library.

    If you select this field, you must specify the name of the IMS //STEPLIB library in which to store the modules that are used by the control region in the IMS STEPLIB library field.

    IMS STEPLIB library

    Specify the name of the IMS //STEPLIB library in which to store the modules that are used by the control region.

    Use this field if your installation stores Group options modules in separate libraries for use by ISPF and IMS. If both ISPF and IMS use the same library, this field is optional.

  10. Press F3 to save changes to the Group options.

Was this page helpful? Yes No Submitting... Thank you

Comments