Using physical media

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

To generate the SMP/E maintenance jobs

On the Installation System Main Menu, select Apply SMP/E Maintenance and press Enter.
BMIPMENU     BMC Software Installation System V4.08.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.V4080.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.
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
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)
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.
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
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**
Press F3 to exit the list of generated jobs.
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.

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 using
Obtain these files
PC file name
Physical media
#M42PUT
uploadfiles.txt
Verify the information in the downloadfiles.txt file.

Installation media you are using	Obtain these files	PC file name
Physical media	#M42PUT	uploadfiles.txt

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.

Open a command prompt and go to the drive that contains the media, and change to the ga directory.
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

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.
Run the $M42DCMP job.

To receive maintenance data

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.
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

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

To list SYSMODS with a HOLD status

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
Review the hardcopy listings to determine whether you need to take any action.

To print PTF documentation

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

To apply maintenance

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.
Review the comments near the beginning of the $M76APLY job.
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.
Save your changes.
Submit the $M76APLY job to run the APPLY.
Important
$M76APLY applies a selected list of PTFs and their prerequisites.

To accept maintenance data

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.
Review the comments near the beginning of the $M81ACPT job.
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.
Save your changes.
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.
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.