Using physical media

Use the following procedures to obtain RSL maintenance by using physical media:

To generate the SMP/E maintenance jobs

  1. On the Installation System Main Menu, select Apply SMP/E Maintenance and press Enter.

     BMIPMENU     BMC Software Installation System V4.02.00 - Main Menu              
     Command ===> ________________________________________________________________  
                                                                                    
     Select one of the following actions:                                           
     __  1. Resume Active Project                                                   
         2. Manage Projects                                                         
         3. Apply SMP/E Maintenance                                                 
         4. Maintain Product Passwords                                              
         5. Set Site Wide Default Values                                            
         6. Check for Installation System Update                                    
         7. Information on new features in this release                             
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
     Active Project: MARYTEST - testing for doc                                     
        JCL Library: ROHMKC.ROHMKC.V4020.JCL                                        
                                                                                    
     CICS, DB2, IBM, IMS and MVS are trademarks or registered trademarks of         
     International Business Machines Corporation in the United States, other        
     countries, or both.                                                            
                                                                                    

  2. On the SMP/E Maintenance Delivery Media panel, select Receive RSL maintenance from physical media, and press Enter :

                          SMP/E Maintenance Delivery Media  
     Command ===> _____________________________________________________________                                          
                                                            
     Select the option to process the RSL Maintenance:                   
     __  1. Receive RSL maintenance from physical media      
  3. On the Generated Job Options panel, in the Job Card Template fields, specify a valid job card statement.

    The Installation System uses this information to create the job card in the generated JCL.

     BMIPMT10               USER1 - Generated Job Options
     Command ===> ________________________________________________ Scroll ===> CSR  
                                                                                    
     Enter the Generated Job options for the maintenance jobs.                      
                                                                                    
     Job Card Template                                                              
       //<jobid>  JOB (9999),INSTALL-&SYSUID,                                   
       //             class="A",MSGCLASS=X,                                       
       //             NOTIFY=&SYSUID                                            
       //*                                                                      
    
     Job Name Options                                                               
       Match generated member names . . . . . Y (Y/N - These options are            
       Suffixed with member name number . . . N        mutually exclusive)
  4. On the Generated Job Options panel, in the Job Name Options fields, specify how you want the generated job cards named and press Enter.

    The Match generated member names and Suffixed with member name number fields are mutually exclusive. Specify:

    • Y for Match generated member names to have the job card name match the generated member name.

      For example, if the member is $M45RECV, the job card name becomes //$M45RECV.

    • Y for Suffixed with member name number to have the job card name suffixed with the numeric ID of the member.

      For example, if the member is $M45RECV and the job card is //BMCIVPJB, the ID is 45 and the job card name becomes //BMCIVP45.

    • Specifying N for both fields to use whatever you have in Job Card Template.

  5. On the JCL Generation Options panel, select Generate JCL and press Enter.

                          JCL Generation Options                  
     Command ===> _________________________________________________
                                                                  
     Select an option.  Press Enter to continue or F12 to go back.
                                                                  
      S Generate JCL into ROHMKC.V3800.JCL                        
      _ Skip generation process and display next panel            
                                                                  
                                                                  
                                                                  
                                                                  
                                                                  
        Member   Status     Function                              
        SETUP               Create RSL Maint Members              
        $M42DCMP            Decompress RSL Maintenance            
        $M45RECV            Receive Maintenance                   
        $M50HOLD            Receive BMC HOLD Data                 
        $M55LIST            List Hold Data                        
        $M75APCK            Apply Check Job                       
        $M76APLY            Apply JOB                             
        $M80ACCK            Accept Check Job                      
        $M81ACPT            Accept Job                            
  6. When the Installation JCL Execution Review panel is displayed, review the information, and press Enter.

     BMIP090              JCL Execution Review                                      
     Command ===> _________________________________________________________________
                                                                                    
     Several jobs were generated into the following library:                        
       USER1.JCLLIB                                                      
                                                                                    
     Review and submit those jobs whose names start with $M in the sequence implied 
     by the 3rd and 4th characters of the jobname. Execute the jobs one at a time.  
     Do not skip any of the jobs because they are generally dependent on the jobs   
     earlier in the sequence.  The jobs should complete without abends or return    
     codes greater than 4 unless documented otherwise in the job's documentation.   
                                                                                    
     The exceptions are the #D9 jobs.  If generated, these jobs should              
     only be submitted when you want to remove the installed product(s)             
     libraries from your environment.                                               
                                                                                    
     If any installation steps remain, a $M00DOC member is created                  
     containing documentation which describes these remaining steps.                
                                                                                    
                                                                                    
                                                                                    
     Press Enter to display an Edit member list of the $M generated jobs.

    The list of generated maintenance jobs is displayed.

       Menu  Functions  Utilities  Help                                             
     ------------------------------------------------------------------------------ 
     EDIT     USER1.JCLLIB                                  Row 0000001 of 0000008 
     Command ===> ________________________________________________ Scroll ===> CSR  
        Name     Prompt          Size    Created           Changed            ID    
     . $M42DCMP                    55   2020/12/04   2020/12/04 08:09:26    User1
     . $M45RECV                   110   2020/12/04   2020/12/04 08:09:26    User1
     . $M50HOLD                    51   2020/12/04   2020/12/04 08:09:26    User1
     . $M55LIST                    45   2020/12/04   2020/12/04 08:09:26    User1
     . $M75APCK                    59   2020/12/04   2020/12/04 08:09:26    User1
     . $M76APLY                    58   2020/12/04   2020/12/04 08:09:26    User1
     . $M80ACCK                    31   2020/12/04   2020/12/04 08:09:26    User1
     . $M81ACPT                    30   2020/12/04   2020/12/04 08:09:26    User1
       **End**
  7. Press F3 to exit the list of generated jobs.
  8. Proceed to To run the generated SMP/E maintenance jobs.

To run the generated SMP/E maintenance jobs

Run the maintenance jobs or files in the following order. Review the JCL before submitting the jobs. You do not have to submit the generated jobs from within the Installation System. You can submit them from your JCL library at any convenient time.

Job or file

Description

See

#M42PUT

Upload the RSL image file to your mainframe

Use with physical media.

To obtain an RSL image

$M42DCMP

Decompress the downloaded RSL image file

Use with the physical media.

To decompress the RSL image

$M45RECV

Receive maintenance

To receive maintenance data

$M50HOLD

Receive hold statements

To receive SYSMOD HOLDDATA during maintenance

$M55LIST

List HOLDDATA

To list SYSMODS with a HOLD status

$M60DOCL

Print PTF documentation

To print PTF documentation

$M65CLNU

Clean up the maintenance input files

Not applicable

$M75APCK

Apply check job

To apply maintenance

$M76APLY

Apply job

To apply maintenance

$M80ACCK

Accept check job

To accept maintenance data

$M81ACPT

Accept job

To accept maintenance data

To obtain an RSL image

If you are using physical media to obtain maintenance, you must obtain the RSL images before running any of the generated maintenance JCL.

  1. Obtain the files indicated in the following table from your mainframe JCL library.

    You can transfer the files to your personal computer (PC), or you can copy the content of the files and paste them into text files on your PC.

    #Mnnxxx files

    Installation media you are usingObtain these filesPC file name
    Physical media#M42PUTuploadfiles.txt
  2. Verify the information in the downloadfiles.txt file.
  3. Modify the uploadfiles.txt file as follows:

    Variable to replace

    Description

    Your_zOS_SSID

    Enter the domain name server (DNS) host name for your mainframe subsystem.

    Your_Mainframe_UserID

    Enter your mainframe user ID.

    Your_Mainframe_Password

    Your mainframe password.

    #####

    Enter the RSL version you want to apply.

    Important

    There are two occurrences of this variable. They should be the same in both places.

    Important

    Remove the angle brackets from the variables in the file.

    You can modify the file on the mainframe, but ensure that the content remains in mixed case.

  4. Open a command prompt and go to the drive that contains the media, and change to the ga directory.
  5. Execute the following command:

    ftp -n -s:'myPath/uploadfiles.txt'

    Important

    This command is case sensitive. Update myPath with the path where you saved the uploadfiles.txt file.

    The command transfers the RSL image files to your mainframe.

To decompress the RSL image

  1. In the $M42DCMP member in your Installation System JCL library, perform the following tasks:
    • Review the instructions in the member for additional modifications you might need to make.
    • In the INFILE DD statement, replace the ##### variable with the RSL level number.
    • Optionally modify the JOB card to comply with your site’s requirements.
  2. Run the $M42DCMP job.

To receive maintenance data

  1. In the $M45RECV member in your Installation System JCL library, perform the following tasks:
    • Optionally modify the JOB card to comply with your site’s requirements. Usually this is not needed if you use the direct file transfer method.
    • Review the instructions in the member for additional modifications you might need to make.
  2. Run the $M45RECV job to receive RSL maintenance data.

    Important

    The maintenance media includes maintenance for all BMC products. The output might include ++VER messages, indicating that maintenance for other products was not received. Therefore, the submitted job receives diagnostic messages with a step return code of 4. These messages do not require any action.

To receive SYSMOD HOLDDATA during maintenance

  1. Download the enhanced HOLDDATA file.
  2. Modify the $M50HOLD job to process the enhanced HOLDDATA file.
  3. Run the $M50HOLD and $M55LIST jobs.
  4. Review the list output to determine whether you need to download additional resolving PTFs.

To list SYSMODS with a HOLD status

  1. Submit the $M55LST job to list any SYSMODs that have a HOLD status.

    Important

    SYSMODs that are held because of errors are automatically released when an APAR or PTF resolves the error. SYSMODS held for documentation or action are released by specifying BYPASS(HOLDSYS) in the following jobs:

    • $M75APCK
    • $M76APLY
    • $M80ACCK
    • $M81ACPT
  2. Review the hardcopy listings to determine whether you need to take any action.

To print PTF documentation

  1. Submit the $M60DOC job to print the documentation in the PTF.

To apply maintenance

  1. Perform APPLY checking before applying maintenance:
    1. Review comments near the beginning of the $M75APCK job.
    2. Submit the $M75APCK job to perform APPLY checking.
    3. Review the $M75APCK output to verify that the expected maintenance will be applied by the $M76APLY job.
  2. Review the comments near the beginning of the $M76APLY job.
  3. Change the BYPASS keyword to take appropriate action for system HOLDs, as in the following example:

    BYPASS(HOLDSYS(doc,action))

    This statement releases SYSMODs that are held for documentation and action.

  4. Save your changes.
  5. Submit the $M76APLY job to run the APPLY.

    Important

    $M76APLY applies a selected list of PTFs and their prerequisites.

To accept maintenance data

  1. Perform ACCEPT checking before accepting maintenance:
    1. Review the comments near the beginning of the $M80ACCK job.
    2. Submit the $M80ACCK job to perform ACCEPT checking.
    3. Review the $M80ACCK output to verify that the expected maintenance will be accepted by the $M81ACPT job.
  2. Review the comments near the beginning of the $M81ACPT job.
  3. Change the BYPASS keyword to take appropriate action for system HOLDs, as in the following example:

    BYPASS(HOLDSYS(doc,action))

    This statement releases SYSMODs that are held for documentation and action.

  4. Save your changes.
  5. Submit $M81ACPT to run the ACCEPT.

    Important

    You should accept PTFs and APARs before applying the next maintenance media for the following reasons:

    • Accepting PTFs and APARs removes them from the SMPPTS data set and makes the space available for additional use. The data set must be compressed.

    • Accepting the PTFs and APARs reduces the required effort if you need to restore future PTFs.

    • The prerequisite chains become long and complex if you defer ACCEPT processing.

    • After doing an ACCEPT you cannot restore a PTF that goes PE. You will have to wait for a correcting PTF.

  6. Copy the updated data sets from your SMP/E target libraries to your runtime data sets.

    You can make a copy of the $206RTEC job that created the runtime data sets to help you copy the data sets from your SMP/E target libraries to your runtime data sets.

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

Comments