Preparing for installation
Perform the following tasks before you run the product installation.
To prepare an installation data set on the z/OS system
The product runs on any supported version of z/OS and z/OS compatible hardware.
Use ISPF option 3.2 (Data Set Utility) to preallocate the product installation data set with the following attributes to receive the installation objects. The data set has enough space to avoid issues later if you need to apply SMP/E maintenance to the product.
For example, create a data set named BMC.RSS.INSTALL with the following parameters:
Parameter | Value |
---|---|
Primary allocation | 20 cylinders |
Secondary allocation | 2 cylinders |
Record length | 80 |
Block size | 8000 |
To prepare the PC for product use
The product is supplied as a binary offload of a TSO XMIT file and requires a PC capable of using FTP to transfer the installation file to the target z/OS system. If you cannot use FTP, you can perform the upload by using IND$FILE instead.
The RSS browser interface requires Internet Explorer (IE) version 8 or later, any Mozilla-based browser such as Firefox, Chrome, Opera, or Safari, with JavaScript enabled.
To upload the RSS binary
Save the installation package to your networked PC and upload it to your target z/OS system. The installation package is a binary offload of a z/OS TSO XMIT file.
Download the installation files from the BMC Electronic Product Distribution (EPD) website. Your access to product pages on the EPD website depends on the license entitlements purchased by your company.
- Use FTP (or IND$FILE if you do not have access to FTP) to upload the installation package file to the data set created in the "To prepare an installation data set on the z/OS system" section.
Sample FTP session to upload the installation file
The following is a sample from an FTP session used to upload the installation file to a system at IP address 12.12.5.40. This session includes the client commands issued at the PC and the server responses:
Connected to 12.12.5.40.
220-FTPD1 IBM FTP CS V2R4 at yourLPAR.yourDomain.com, 16:30:17 on 2022-07-21.
220 Connection will close if idle for more than 30 minutes.
User (<yourLPAR>.<yourDomain>.com:(none)): <yourUser>
331 Send password please.
Password:
230 <yourUser> is logged on. Working directory is "<yourUser>.".
ftp> bin
200 Representation type is Image
ftp> literal site recfm=fb lrecl=80 blksize=3120
200 SITE command was accepted
ftp> literal site cyl pri=20 sec=5
200 SITE command was accepted
ftp> put <productName>.xmit
200 Port request OK.
125 Storing data set <yourUser>.<productName>.XMIT
250 Transfer completed successfully.
ftp: 5028480 bytes sent in 9.44Seconds 532.57Kbytes/sec.
ftp> bye
221 Quit command received. Goodbye.
Replace the following placeholders:
- <yourLPAR>.<yourDomain>
- <yourUser>
- <productName>
The LITERAL SITE (some FTP clients use QUOTE rather than LITERAL) command ensures that the data set has the correct characteristics when it is written to the target system.
If you do not have access to or are prevented from using FTP, you can use the IND$FILE utility instead. The following code shows the general command format:
IND$FILE PUT productName RECFM(FB) LRECL(80) BLKSIZE(3120)
productName represents the name of the product XMIT file. This statement must not have ASCII or CRLF appended. If you experience any issues uploading the file, preallocate the data set using the attributes given above. These will override the RECFM, LRECL, and BLKSIZE specified on the IND$FILE PUT statement.
After you upload the product binary, it exists on the target z/OS system as yourUser.productName.XMIT. This file needs to be TSO RECEIVED.
To unload the installation data set
Use a TSO RECEIVE command to unload the binary XMIT install file into the installation data set that you created. Use the command shell session (option 6 from the ISPF menu) to issue the RECEIVE command.
In the following example, the RECEIVE command unloads the XMIT file:
receive indsn('hlq.XMIT')
The system responds as in the following example:
INMR901I Dataset hlq.PACKAGE from userID on NODENAME
INMR906A Enter restore parameters or 'DELETE' or 'END' +
Enter the name of the preallocated installation data set such as in the following example:
da('
Unknown macro: confluence_display. Click on this message for details.
')
The following code block shows some of the output messages issued during the RECEIVE process. When you enter this command and press Enter, the system unloads the members into the named data set issuing a confirmation message for each one.
IEB1135I IEBCOPY FMID HDZ1D10 SERVICE LEVEL UA61306 DATED ... IEB1035I IBMUSER ISPFPROC ISPFPROC 11:15:47 THU 10 APR 2014 ...
COPY INDD=((SYS00009,R)),OUTDD=SYS00007
IEB1013I COPYING FROM PDSU INDD=SYS00009 VOL=ZDSYS1 DSN=SYS14...
IEB1014I TO PDSE OUTDD=SYS00007 VOL=Z13WK5
DSN=
Unknown macro: confluence_display. Click on this message for details.
IEB154I INSTALL HAS BEEN SUCCESSFULLY LOADED
IEB154I RSMRV21 HAS BEEN SUCCESSFULLY LOADED
IEB154I RSMJCLA HAS BEEN SUCCESSFULLY LOADED
IEB154I RSMJCLC HAS BEEN SUCCESSFULLY LOADED
IEB154I RSMJCLE HAS BEEN SUCCESSFULLY LOADED
IEB154I RSMJCLG HAS BEEN SUCCESSFULLY LOADED
IEB154I RSMJCLJ HAS BEEN SUCCESSFULLY LOADED
IEB154I RSMJCLR HAS BEEN SUCCESSFULLY LOADED
IEB154I RSMJCLS HAS BEEN SUCCESSFULLY LOADED
IEB154I RSMVARS HAS BEEN SUCCESSFULLY LOADED
IEB154I RSMWING HAS BEEN SUCCESSFULLY LOADED
IEB154I RSMWIN0 HAS BEEN SUCCESSFULLY LOADED
IEB1098I 12 OF 12 MEMBERS LOADED FROM INPUT DATA SET REFERENCED BY
SYS00025
IEB144I THERE ARE 0 UNUSED TRACKS IN OUTPUT DATA SET REFERENCED BY
SYS00023
IEB149I THERE ARE 5 UNUSED DIRECTORY BLOCKS IN OUTPUT DIRECTORY
IEB147I END OF JOB - 0 WAS HIGHEST SEVERITY CODE
INMR001I Restore successful to dataset '
Unknown macro: confluence_display. Click on this message for details.
'
If you remain in your TSO command session, you can run the INSTALL procedure next to create the SMP/E installation of the product.
Where to go from here
To run the installation procedure, see Running-the-INSTALL-procedure.
Related topic