Setting up initial values for the BMC ISR jobs

Complete this one-time procedure to set up BMC ISR.

For more information, view the Quick Course Internet Service Retrieval - Getting Started.

Note: You must already be logged into BMC Support Central or you will receive a Page Not Found error.

For a list of Quick Courses about the Installation System, see PDFs and videos.

Before you begin

Ensure that you have met the requirements for BMC ISR. For more information, see Requirements for using BMC ISR.

To access BMC ISR

Access BMC ISR by using one of the following methods:

  • From within the Installation System, select Apply SMP/E Maintenance on the Installation System Main Menu, and press Enter.

  • From a CLIST, in ISPF, on the TSO Commands panel, enter the following command:

    EX 'HLQ.BMRCLIB(BMCISR)'

    Or execute your runtime CLIST library for BMC ISR.

To set up initial values for the BMC ISR jobs

  1. (Displayed when accessed through the Installation System only) On the SMP/E Maintenance Delivery Media panel, select Retrieve maintenance using BMC Internet Service Retrieval.

     BMIPE37              SMP/E Maintenance Delivery Media
     Command ===> _________________________________________________________________
    
     Select one of the following actions:
     __  1. Retrieve maintenance using BMC Internet Service Retrieval
         2. Receive maintenance downloaded from eFix
         3. Get RSL maintenance from the ESD site
         4. Receive RSL maintenance from Distributed FTP or
            from physical media
  2. (Displayed when accessed through the Installation System only) On the Specify BMC Internet Service Retrieval Library panel, specify the library name where BMC ISR is located.

    The BMC ISR library is named HLQ.BMRCLIB by default.

     BMIPE45             Specify BMC Internet Service Retrieval Library            
     Command ===> _________________________________________________________________
                                                                                   
     Location of BMC Internet Service Retrieval                                    
                                                                                   
     Data Set Name . . .  ____________________________________________

    Tip

    Access the online Help to see the name of the library that was set up for BMC ISR.

  3. On the BMC Internet Service Retrieval (ISR) Menu, select Specify job card and ISR data set information and press Enter.

  4. On the BMC ISR Job Card and Data Set Information panel, perform the following actions:
    1. Modify the JCL information as needed to meet your requirements.
    2. Verify the BMC ISR process load library.

      This field is populated with the library where ISR was installed.

    3. Specify the HLQ of the data sets that ISR will generate to store request information.
    4. Specify the non-VSAM data set unit name and VOLSER.
    5. If your data sets are managed by SMS, type Y in the Manage Non-VSAM Data Sets with SMS field, and specify the storage class, management class, and data class for the data sets. Otherwise, leave these fields blank.
    6. Press Enter.
     BMRPSR01           BMC ISR Job Card and Data Set Information                   
     Command ===> __________________________________________________________________
                                                                                    
     Job Card Information                                                           
      ===> //<jobid>  JOB (9999),INSTALL-&SYSUID,                                   
      ===> //             class="A",MSGCLASS=X,                                       
      ===> //             NOTIFY=&SYSUID                                            
      ===> //*                                                                      
                                                                                    
     BMC ISR process Load Library. . USER1.BMRLOAD                    
                                                                                    
     HLQ for generated Data Sets . . _________________  (17 char. max)              
                                                                                    
     Non-VSAM Unit Name  . . . . . . SYSALLDA                                       
     Non-VSAM Data Set VOLSER  . . . ______   <-- Not required with SMS             
     Manage Non-VSAM Data Sets with SMS:  N   (Y/N)                                 
         Storage Class . . . . . . . ________                                       
         Management Class  . . . . . ________                                       
         Data Class  . . . . . . . . ________                                       
                                                                                    
                                                                                    
                                                                                    
         Press Enter to continue or F12 to go back.

    The information on this panel is used to create the JCL in the generated files.

  5. On the BMC Internet Service Retrieval (ISR) Menu, select Specify z/OS File System (zFS) information and press Enter.

  6. On the Application Server UNIX Options panel, identify the file system directories into which all incoming and outgoing BMC ISR request ID files will be compressed and decompressed.

    For more information about the file system, see About the zFS file system used by BMC ISR.

    1. Specify the numeric UNIX user ID and group ID.

      If you are unsure about these values, consult your security administrator.

    2. Specify a root directory for the location of the BMC ISR file path.

      This specification is the path prefix used by all subsequent jobs generated by BMC ISR. The path prefix has /bmc/bmr/v15  automatically appended to it, which is required and should not be modified. The v15 portion will vary depending on the release number of BMC ISR.

    3. Specify the file system information.
    4. Press Enter.
     BMRPSR05                Application Server UNIX Options                        
     Command ===> __________________________________________________________________
                                                                                    
     Numeric UNIX User-ID  . . . . . . . . . . . . 2258                             
     Numeric UNIX Group-ID . . . . . . . . . . . . __________                       
     Define root directory for File System path  . _______________________          
                                                                                    
     Specify File System Data Set HLQ  . . . . . . __________________________       
     Specify File System Data Set LLQ  . . . . . . BMCISRFS                         
     Specify File System Unit  . . . . . . . . . . SYSALLDA                         
     Specify File System Data Set VOLSER . . . . . ______ <-- Not required with SMS 
       Manage File System with SMS:  N  (Y/N)                                       
         File System Storage Class . . . . . . . . ________                         
         File System Management Class  . . . . . . ________                         
         File System Data Class  . . . . . . . . . ________                         
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
         Press Enter to continue or F12 to go back.

    BMC ISR creates a job to allocate and mount the zFS file system.

    Note

    Before sending or receiving a request, always run this job to allocate and mount the zFS file system.

  7. Press END to exit the editor and save the job.

  8. On the BMC Internet Service Retrieval (ISR) Menu, select Specify File Transfer method and press Enter.

  9. On the Specify File Transfer Method dialog:

    1. Select which file transfer method you want to use.
    2. If you selected SFTP, indicate if you are using a firewall.
    3. Press Enter.
    +---------------Specify File Transfer Method ----------------+
    | BMRPSR30                                                   |
    | Command ===>                                               |
    |                                                            |
    |  Select File Transfer method:                              |
    |                                                            |
    |   _  File Transfer Protocol (FTP)                          |
    |   _  File Transfer Protocol Secure (FTPS)                  |
    |   _  Secure File Transfer Protocol (SFTP)                  |
    |      Site has a Firewall/Proxy . . .  N  (Y=YES, N=NO)     |
    |                                                            |
    |  Press Enter to continue or F3 to exit.                    |
    |                                                            |
    +------------------------------------------------------------+
  10. Enter firewall information on the Firewall Free Form Input Template Specifications panel.

    • If your site does not have requirements to allow access through a firewall, press Enter.

    • If your site has requirements to allow access through a firewall, supply the information (see the following example firewall panels; they are slightly different for each file transfer method), and press Enter.

      For creating the extract JCL, you can optionally use <dvinuser> for the user ID and <dvinpswd> for the password and values will be substituted when $E05XTRT is generated.

      Example

      Host-Site-<dvinuser>@Proxy-User@Host-Site-Name

      Host-Site-<dvinpswd>@Proxy-Password

      For creating the retrieval JCL, you can optionally use <dvoutusr> for the user ID and <dvoutpswd> for the password and values will be substituted when $J05RETV is generated.

      Example

      Host-Site-<dvoutusr>@Proxy-User@Host-Site-Name

      Host-Site-<dvoutpswd>@Proxy-Password

    Note

    The information entered on this panel is used as specified. Data entered in mixed case will be used in mixed case.

    FTP Firewall Free Form Input Template Specifications panel

     BMRPSR04        Firewall Free Form Input Template Specifications               
     Command ===> __________________________________________________________________
                                                                                    
     Enter the FTP requirements to get outside your firewall. The BMC ISR 
     system will use the entered values to connect to the BMC FTP Site.     
     //FTPCALL  EXEC PGM= FTP      ,REGION=5120K,                                   
                    PARM= filedownload.bmc.com (timeout 720 exit=8                  
     Enter the DD(s) and dataset(s) required for FTP connectivity.                  
     // ________ DD DISP=SHR,DSN= ____________________________________________      
     // ________ DD DISP=SHR,DSN= ____________________________________________      
     // ________ DD DISP=SHR,DSN= ____________________________________________      
     // ________ DD DISP=SHR,DSN= ____________________________________________      
     // ________ DD DISP=SHR,DSN= ____________________________________________      
                                   *Do not enclose in quotes*                       
     In the INPUT section, enter only the login credentials required.  The correct  
     syntax is critical for establishing a successful connection.                   
     //INPUT     DD *                                                               
     _____________________________________________________________________________  
     _____________________________________________________________________________  
     _____________________________________________________________________________  
     _____________________________________________________________________________  
     _____________________________________________________________________________  
     _____________________________________________________________________________

    FTPS Firewall Free Form Input Template Specifications panel

     BMRPSR04        Firewall Free Form Input Template Specifications               
     Command ===> __________________________________________________________________
                                                                                    
     Enter the FTP requirements to get outside your firewall. The BMC ISR 
     system will use the entered values to connect to the BMC FTP Site.     
     //FTPCALL  EXEC PGM= FTP      ,REGION=5120K,                                   
                    PARM= filedownload.bmc.com -a TLS -v (timeout 720 exit=8                 
     Enter the DD(s) and dataset(s) required for FTP connectivity.                  
     // ________ DD DISP=SHR,DSN= ____________________________________________      
     // ________ DD DISP=SHR,DSN= ____________________________________________      
     // ________ DD DISP=SHR,DSN= ____________________________________________      
     // ________ DD DISP=SHR,DSN= ____________________________________________      
     // ________ DD DISP=SHR,DSN= ____________________________________________      
                                   *Do not enclose in quotes*                       
     In the INPUT section, enter only the login credentials required.  The correct  
     syntax is critical for establishing a successful connection.                   
     //INPUT     DD *                                                               
     _____________________________________________________________________________  
     _____________________________________________________________________________  
     _____________________________________________________________________________  
     _____________________________________________________________________________  
     _____________________________________________________________________________  
     _____________________________________________________________________________

    SFTP Firewall Free Form Input Template Specifications panel

     BMRPSR31        Firewall Free Form Input Template Specifications               
     Command ===> __________________________________________________________________
                                                                                    
     Enter the SFTP requirements to get outside your firewall. The BMC ISR          
     system will use the entered values to connect to the BMC FTP Site.             
                                                                                    
     NOTE: The PARM field can be up to 100 characters in length.                    
                                                                                    
     //FTPCALL  EXEC PGM= BPXBATCH ,REGION=5120K,                                   
                    PARM= sh sftp -vvv <dvinuser>@filedownload.bmc.com______________
    __________________________________________                                                                                
                                                                                    
     Enter the passwords for the BMC FTP Site and your Firewall/Proxy               
                                                                                    
        Firewall/Proxy password . . .  <dvinpswd>________________________
                                                                                    
     NOTE: When <dvinuser> and <dvinpswd> are used in either the PARM or            
           the Firewall/Proxy fields, the values will be substituted from           
           the panels.  When <dvinfwus> or <dvinfwpw> are used in either            
           the PARM or Firewall/Proxy fields, you will be prompted for your         
           site-specific userid and password.                                       
Was this page helpful? Yes No Submitting... Thank you

Comments