Upgrading

From time to time, it may be necessary to provide updates to the installed versions of your BMC AMI Security products, either to correct minor faults or to provide updated or new features.

Updates are provided as a binary offload of a z/OS XMIT file which you can upload to your system using FTP or any other accepted method. After upload, the TSO RECEIVE command is used to load the PTF to your installation PTF library.

After the PTF has been TSO received, the APPLYPTF procedure from the original installation data set is used to apply the PTF to your BMC product. Contact BMC Support, if required.

Before you begin

Before you update the content, perform the following actions:

Ensure that the Resident Security Server (RSS) component is up to date. It provides core components for the product. For details, see Upgrading RSS.
Download the relevant files from the Product and Patches tabs of the BMC AMI Security Self Service Password Reset version 2.1 section of the Electronic Product Distribution (EPD) website. Your ability to access product pages on the EPD website is determined by the license entitlements purchased by your company.

Uploading and receiving PTFs

The PTF is a binary TSO XMIT data set, 80-byte records in a 3120-byte fixed length block.

To upload the PTF with FTP

Make an FTP connection to your system and sign on with your normal user ID and password.
Use the following command format to upload the binary file. For FTP details, see the procedure to upload the binary in Preparing for installation.
type binary
literal site recfm=fb lrecl=80 blksize=3120
literal site cyl pri=5 sec=1
put <ptfName>.xmit
quit
Some FTP clients use QUOTE instead of LITERAL, but either command writes the data set to the target system with the correct characteristics.

To upload the PTF with IND$FILE

Instead of FTP, you can use the IND$FILE command to upload the PTF.

Use the following format for the IND$FILE command:
IND$FILE PUT <ptfName>.XMIT RECFM(F) LRECL(80) BLKSIZE(3120)
If the generated statement does not have these attributes, modify the IND$FILE utility to use the specified data set attributes. Make sure that the data set does not have ASCII or CRLF appended to the statement.
If you experience issues, or if you cannot change the default parameters of IND$FILE, preallocate the data set on the host system. The attributes of a preallocated data set override the RECFM, LRECL and BLKSIZE specified on the IND$FILE PUT statement so you can omit them from the command.
From ISPF option 6, enter the following:
RECEIVE INDA('<profilePrefix>.<ptfName>.XMIT')
The input data set is the one you built during the upload step.
At the prompt INMR906A Enter restore parameters or 'DELETE' or 'END' + enter the following:
DA('<HLQ>.PTFLIB')

The PTF or PTFs are unloaded into the HLQ.PTFLIB library

To run the PTF Procedure

In the installation data set, HLQ.INSTALL, which was built during the product installation process, is the APPLYPTF procedure. Use the procedure to build the job control that applies the service to your product.

To run the procedure, locate it in the member list and enter the EX command against it.
You can also issue the following command from ISPF option 6:
ex <HLQ>.INSTALL(APPLYPTF)
In the procedure's panel, enter the PTF number, such as in the following example:
---------------------------- RSS PTF Installation ----------------------------
Command ===> _________________________________________________________________

PTFs to be installed : ZDT1049

Jobcard:
//<userID> JOB (),CLASS=A,MSGCLASS=X,REGION=0M,NOTIFY=&SYSUID__

Press Enter to generate PTF JCL.
Press PF3 to terminate
Press Enter.
The procedure builds the JCL and opens an edit session so that you can make any installation-specific changes before submitting the job.
Submit the job.
A successful job completes with a return code of 0.
Perform a cold start on the product or products to bring the updated service into production.