Installation methods

You can install a resource update list by using one of the three methods.

Use any of the following methods to install a resource update list:
  • Select option 4 (Install) from the IMS™ HP Sysgen Tools Primary Options menu (Figure 1).

    By using this method you can select multiple resource update lists to install in a single pass as though they were a single resource update list. This feature is useful if you need to install multiple resource update lists at the same time. For example, for multiple application maintenance releases in a single maintenance window.

  • Use the Resource update list edit selection panel (Figure 1).

    Use the I line command on the Edit member selection list to install a resource update list from the same panel where you can edit a resource update list. If you previously created a resource update list and want to install it, issue the I line command after you save the resource update list.

  • Perform the installation by using a batch job.

    Refer to Using the Batch Update List utility for details about how to set up JCL and control cards to install one or more resource update lists.

To use option 4 on the IMS HP Sysgen Tools Primary Options menu, Figure 1, to install one or more resource update lists, complete the following steps:
  1. Select option 4 from the HP Sysgen Primary Options menu and press Enter.
    The Update List Selection panel is displayed.
    Figure 1. Initial panel for installing resource update list
    INSTALL    IMS HP Sysgen Tools - Update List Selection     Row 20 to 34 of 167
Command ===> ________________________________________________ Scroll ===> CUR 
                                                                 More -> 
   Primary Commands: 
      S    Select a Member       Select one or more Resource Update Lists you
      L    Locate a Member       want to install. Press Enter without any 
      SORT Sort the List         changes to the screen to continue.

     Name     Target    Status   Lines  Created        Updated        Upd-ID 
 _ #TERMSE4  IMS9                    1  2016/03/17  2017/05/06 13:46  P390M
 _ A         IMS7                   20  2016/02/02  2017/05/06 13:47  P390M   
 _ ADDINV    IMS7      VERIFY        1  2015/09/04  2017/05/06 13:47  P390M   
 _ ANDREW1   IMS7                    1  2015/11/17  2017/05/06 13:48  P390M   
 _ ANDREW2   IMS7                    6  2015/11/17  2017/05/06 13:48  P390M   
 _ ANDREW3   IMS7                    2  2016/11/20  2017/05/06 13:48  P390M   
 _ ANDREW4   IMS7                    2  2016/11/20  2017/05/06 13:48  P390M   
 _ ANDREW5   IMS7                    3  2016/11/20  2017/05/06 13:48  P390M   
 _ A1        IMS9                    6  2016/03/12  2017/05/06 14:23  P390M   
 _ BCMIVPS1  IMS7                    1  2015/09/14  2017/05/06 13:49  P390M   
 _ CCFAOPGM  IMS9      VERIFY        3  2016/06/29  2017/05/06 13:49  P390M   
 _ CLSTIMS6  IMS9      VERIFY        1  2016/06/16  2017/05/06 13:50  P390M
 _ CLSTIMS7  IMS7                  152  2016/09/14  2017/05/06 13:50  P390M   
 _ CLSTIMS9  IMS9                    5  2016/06/16  2017/05/06 13:50  P390M
 _ CMD1      IMS7      VERIFY        2  2016/01/26  2017/05/06 13:50  P390M

    Scroll the Update List Selection panel by using the RIGHT and LEFT commands or PF11 and PF10. Install panels 1, 2, and 3 have the same fields as edit panels 1, 2, and 3. Sample Install panels 2 and 3 are shown in Figure 2 and Figure 3.

    Figure 2. Sample resource update list install panel (1 of 2)
    INSTALL    IMS HP Sysgen Tools - Update List Selection       Row 27 to 60 of 184
Command ===> ________________________________________________ Scroll ===> CUR
                                                              <- More ->
   Primary Commands:
      S    Select a Member       Select one or more Resource Update Lists you
      L    Locate a Member       want to install. Press Enter without any
      SORT Sort the List         changes to the screen to continue.

   Name           Updated         Upd-ID         Installed       Inst-ID  
_ #TERMSE4    2017/05/06 13:46:45 P390M       2016/03/18 0:00:00  P390M
_ A           2017/05/06 13:47:03 P390M 
_ ADDINV      2017/05/06 13:47:11 P390M       2016/09/08 0:00:00  P390M
_ ANDREW1     2017/05/06 13:48:08 P390M 
_ ANDREW2     2017/05/06 13:48:01 P390M 
_ ANDREW3     2017/05/06 13:48:26 P390M 
_ ANDREW4     2017/05/06 13:48:35 P390M 
_ ANDREW5     2017/05/06 13:48:43 P390M 
_ A1          2017/05/06 14:23:55 P390M       2016/03/18 0:00:00  P390M 
_ BCMIVPS1    2017/05/06 13:49:18 P390M       2016/01/02 0:00:00  P390M 
_ CCFAOPGM    2017/05/06 13:49:35 P390M       2016/06/29 0:00:00  P390M 
_ CLSTIMS6    2017/05/06 13:50:07 P390M 
_ CLSTIMS7    2017/05/06 13:50:19 P390M 
_ CLSTIMS9    2017/05/06 13:50:37 P390M 
_ CMD1        2017/05/06 13:50:52 P390M       2016/02/04 0:00:00  P390M
    Figure 3. Sample resource update list install panel (2 of 2)
    IINSTALL    IMS HP Sysgen Tools - Update List Selection     Row 20 to 340 of 167
Command ===> ________________________________________________ Scroll ===> CSR
                                                              <- More
   Primary Commands:
      S    Select a Member       Select one or more Resource Update Lists you
      L    Locate a Member       want to install. Press Enter without any
      SORT Sort the List         changes to the screen to continue.

CMD    Name    Comments 
 _   #TERMSE4  TEST TERMINAL SECURITY
 _   A         TEST 
 _   ADDINV    UPDATE ADDINV 
 _   ANDREW1   ANDREW CHANGES 
 _   ANDREW2   ANDREW CHANGES
 _   ANDREW3   ANDREW CHANGES
 _   ANDREW4   ANDREW CHANGES
 _   ANDREW5   ANDREW CHANGES
 _   A1        MIXED RELOAD AND SECURITY
 _   BCMIVPS1  PRF
 _   CCFAOPGM  ADD CCF AND IMSCMD 
 _   CLSTIMS6  GENERATED UPDATE LIST 
 _   CLSTIMS7  GENERATED UPDATE LIST 
 _   CLSTIMS9  GENERATED UPDATE LIST 
 _   CMD1      TEST COMMANDS
  2. Use the S line command to select resource update lists to install. You can select up to 255 resource update lists to install simultaneously. Press Enter to initiate the installation process.
    The update list entries from the update lists are shown in the following panel:
    Figure 4. Update list entries panel
    INSTALL    IMS HP Sysgen Tools - Update List Entries      Row 1 to 3 of 3 
Command ===> ____________________________________________Scroll ===> CUR
                                                                 More ->  
Target  ===> IMS8____  (IMSID or Group Name)

   Primary Commands:
      GO   Install this Update List

Function  Resource    Name    List Name  List TGT      Updated          ID
ADD       APPLCTN   DFSSAM0A  DFSSAM0A   IMS8    2017/05/06 20:47:44 P390M
ADD       DATABASE  DI21PART  DI21PART   IMS8    2017/05/06 20:48:06 P390M
UPDATE    TRANSACT  PART      DI21PART   IMS8    2017/05/06 20:48:06 P390M
*************************** Bottom of data ****************************
  3. Validate that the correct resource update lists are selected and specify the target name for which the entries are to be installed.
  4. Enter the GO primary command to initiate the installation process.
    If the installation process identifies any conflicts that would prevent the update list entries from being successfully installed, messages are displayed that describe these conditions. Example errors are shown in the following panel:
    Figure 5. Resource update list installation error message
    INSTALL   Implement Update List Results              Line 00000000 Col 001 080 
 Command ===> _______________________________________________ Scroll ===> CSR  
********************************* Top of Data **********************************
SUMMARY OF INSTALL PROCESSING:                                                  
   IMS9: VERIFY FAILED                                                          
---------------------------- MESSAGES FOR IMS IMS9 -----------------------------
IOH4104E ADD FOR DATABASE DI21PART FAILED BECAUSE IT IS ALREADY DEFINED         
******************************** Bottom of Data ********************************
After an action has completed for a member, the Update List Selection panel is updated with the current status of a member. When the status of a member is updated, the Status field is updated. For example in Figure 6, *EDIT appears in the Status column to show that member A has been edited. When the Status column shows an asterisk (*) before the status, it means that this action occurred during the current IMS HP Sysgen Tools ISPF session. Status of VERIFY or INSTALL is maintained across ISPF sessions, while status of EDIT or FAILED are not carried across ISPF sessions.
Figure 6. Resource update list after installation
EDIT       IMS HP Sysgen Tools - Update List Selection      Install Successful 
Command ===> ________________________________________________ Scroll ===> CUR  
                                                                 More ->       
   Primary Commands:          Line Commands:                                   
      S    Add/Edit a Member     S Edit a Member        E Edit a Member        
      L    Locate a Member       D Delete a Member      V Verify a Member      
      SORT Sort the List         R Rename a Member      I Install a Member     
                                                                               
     Name     Target    Status   Lines  Created        Updated        Upd-ID 
 _ #TERMSE4  IMS9                    1  2016/03/17  2017/05/06 13:46  P390M
 _ A         IMS7      *EDIT         20 2016/02/02  2017/05/06 21:21  P390M   
 _ ADDINV    IMS9      *VERIFY       1  2015/09/04  2017/05/06  0:00  P390M   
 _ ANDREW1   IMS7                    1  2015/11/17  2017/05/06 13:48  P390M   
 _ ANDREW2   IMS7                    6  2015/11/17  2017/05/06 13:48  P390M   
 _ ANDREW3   IMS7                    2  2015/11/20  2017/05/06 13:48  P390M   
 _ ANDREW4   IMS7                    2  2015/11/20  2017/05/06 13:48  P390M   
 _ ANDREW5   IMS7                    3  2015/11/20  2017/05/06 13:48  P390M   
 _ A1        IMS9      *FAILED       6  2016/03/12  2017/05/06 14:23  P390M   
 _ BCMIVPS1  IMS7                    1  2015/09/14  2017/05/06 13:49  P390M   
 _ CCFAOPGM  IMS9      VERIFY        3  2016/06/29  2017/05/06  0:00  P390M   
 _ CLSTIMS6  IMS9      *INSTALL      1  2016/06/16  2017/05/06 13:50  P390M
 _ CLSTIMS7  IMS7                  152  2016/09/14  2017/05/06 13:50  P390M   
 _ CLSTIMS9  IMS9                    5  2016/06/16  2017/05/06 13:50  P390M
 _ CMD1      IMS7      VERIFY        2  2016/01/26  2017/05/06 13:50  P390M
Parent topic: Installing a resource update list