Applying Maintenance on z/OS

Maintenance (a service pack or hotfix) changes the contents of one or more of the standard FOCUS libraries. For instructions on installing a service pack, see Refreshing or Upgrading FOCUS With ISETUP.

This chapter describes how to install a hotfix. Hotfixes are made available for download from an Information Builders FTP Server.

Receiving a Hotfix

How to:

Receive a Hotfix Using FTP in TSO

Customers using this procedure must receive notification from an Information Builders representative confirming that the desired maintenance has been placed on the FTP server and is ready to be received. This procedure requires basic working knowledge of site-specific FTP standards.

The following procedure describes the detailed dialog between TSO and the user.

Commands to be entered by the user are prefaced by "USER:".
Responses from the system are prefaced by "SYSTEM:".

Advanced FTP users may facilitate the process by using more efficient methods according to their site standards.

Top of page

Procedure: How to Receive a Hotfix Using FTP in TSO

Prior to starting the download process, Information Builders must provide you with the name of the FTP site (referred to in this document as ftpsite), the name of the download directory (referred to in this document as downloaddirectory), and an FTP user ID and password. In the following instructions, the user ID that you use to log onto your z/OS system is referred to as tsouser, and the FTP user ID and password you received from Information Builders are referred to as ftpuser and ftppass:

Log onto the z/OS system where the hotfix will be installed.
Enter TSO COMMAND mode or ISPF 6.
Invoke FTP.
```
USER:    ftp
SYSTEM:  EZA1450I IBM FTP CS V1R8 
         EZA1466I FTP: using TCPIP
         EZA1456I Connect to ?    
USER:    ftpsite 
```
Upon completion of the FTP process, the maintenance data set will be allocated with a one-month retention period, and the data set name will be prefixed by the TSO prefix defined in the TSO profile.

Log onto FTP with the user ID and password you received from Information Builders:

SYSTEM:  EZA1554I Connecting to: ftpsite 38.117.185.171 port: 21.
         220 Microsoft FTP Service     
         EZA1459I NAME(ftpsite:tsouser):  
USER:    ftpuser SYSTEM:  EZA1701I >>> USER ftpuser  
         331 Password required for ftpuser.
         EZA1789I PASSWORD:                                
USER:    ftppass

Note: The password will not display. Press Enter to process it:

SYSTEM:  EZA1701I >>> PASS                          
         230 User ftpuser logged in.

Use the cd command to go to the directory in which the maintenance files are stored:

SYSTEM:  EZA1460I Command:                          
USER:    cd downloaddirectory SYSTEM:  EZA1701I >>> CWD downloaddirectory         250 CWD command successful.

Use the lcd command set DOWNLOAD as the second qualifier for the data sets to be created:
```
SYSTEM:  EZA1460I Command:          
USER:    lcd DOWNLOAD 
         EZA1460I Command:
```

Issue the ls command to list the hotfix files. Note that the hotfix file names have a suffix of .BIN. You will trim this suffix when you receive the files::

USER:    ls                                                    
SYSTEM:  EZA1701I >>> PORT 172,19,1,40,28,7                   
         200 PORT command successful.                         
         EZA1701I >>> NLST                                    
         150 Opening ASCII mode data connection for file list.
         EZA2284I MF_FOCUS_Hotfix_download_instructions.pdf          
         EZA2284I HF01.ADABAS.LOAD.BIN                            
         EZA2284I HF01.DATACOM.LOAD.BIN                           
         EZA2284I HF01.FOCLIB.LOAD.BIN                            
         EZA2284I HF01.FOCM204.LOAD.BIN                           
         EZA2284I HF01.IDMS.LOAD.BIN                              
         EZA2284I HF01.IMS.LOAD.BIN                               
         EZA2284I HF01.TOTAL.LOAD.BIN                             
         226 Transfer complete.                               
         EZA1460I Command:

In a subsequent step, you will have to issue a RECEIVE command for each file in order to convert it to a PDS, so be sure to keep a copy of this list available. (You will not need to RECEIVE the file containing the download instructions.)

Issue the locsite allocation command:

USER:  
locsite PRI=5 SEC=10 RETPD=0 LRECL=80 BLKSIZE=3120 RECFM=FB CYL

Set the transfer type to BINary so that no data translation occurs during the download:

SYSTEM:  EZA1460I Command:
USER:    bin
SYSTEM:  EZA1701I >>> TYPE I
         200 Type set to I.

Issue the mget command to retrieve all of the hotfix files.

SYSTEM:  EZA1460I Command:  
USER:    mget HF*
SYSTEM:  EZA1701I >>> TYPE A 
         200 Type set to A.                                          
         EZA1701I >>> PORT 172,19,1,40,21,134                        
         200 PORT command successful.                                
         EZA1701I >>> NLST HF*                                       
         150 Opening ASCII mode data connection for file list.       
         226 Transfer complete.                                      
         EZA1701I >>> TYPE I                                         
         200 Type set to I.                                          
         EZA2696I Mget HF01.ADABAS.LOAD.BIN (Yes|No|Quit|Stop prompting)?

Enter Y at each prompt, or enter S to stop prompting. You will see messages similar to those that follow for each file that is downloaded:

USER:    S      
SYSTEM:  EZA1701I >>> PORT 172,19,1,40,21,140    
         200 PORT command successful.         
         EZA1701I >>> RETR HF01.ADABAS.LOAD.BIN   
         150 Opening BINARY mode data connection for
         HF01.ADABAS.LOAD.BIN (892560 bytes).    
         226 Transfer complete. 
         EZA1617I 892560 bytes transferred in 0.160 seconds.  
         Transfer rate 5578.50 Kbytes/sec.    
            .
            .
            .
         HF01.FOCLIB.LOAD.BIN (39902800 bytes).  
         226 Transfer complete. 
         EZA1617I 39902800 bytes transferred in 5.990 seconds. 
         Transfer rate 6661.57 Kbytes/sec.       
         EZA1460I Command:

After all the HF files have been processed, quit out of FTP:
```
USER:    quit
SYSTEM:  READY
```
You now have one or more sequential files, each starting with the qualifiers tsouser.DOWNLOAD.
The hotfix files were processed with XMIT before being transferred to the FTP site. Each one must now be processed with a TSO RECEIVE command in order to convert it to a PDS.
For each tsouser.DOWNLOAD.HFnn.name1.name2.BIN file that was downloaded, execute the TSO RECEIVE command to convert it to a PDS:

Note: You must receive each file without the .BIN suffix:
```
RECEIVE INDSN(DOWNLOAD.HFnn.name1.name2)
```
where qualif is the high-level qualifier for your FOCUS production data sets.

The RECEIVE command will prompt you for the restore parameters needed to process the command. Enter:
```
DSNAME ('qualif.HFnn.name1.name2')
```
Create a backup copy of all production FOCUS libraries.
For each qualif.HFnn.name1.name2 data set, use ISPF 3.3 or another copy utility to copy all members into the corresponding FOCUS production library (named qualif.name1.name2). You will need to specify Replace like-named members.
Verify that the hotfix has been applied:
1. Enter FOCUS.
2. From the FOCUS command prompt, issue the following command:
```
? PTF
```
  The output should show HFnn, where nn is the number of the hotfix.