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.

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.

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.

    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.