Downloading z/OS gateway fixes from FTP

About this task

This section describes how to obtain the files in a fix or fix pack from the IBM software FTP site.

If a fix or fix pack for Access method for z/OS is issued by IBM, you can receive it by downloading the files from the IBM software FTP site.

Download the z/OS gateway fix pack files as follows:
  1. Allocate two data sets with LRECL=80 RECFM=80 to hold the downloaded files. For example:
    • TWS4APPS.LOADLIB.L80 (for the load library)
    • TWS4APPS.SAMPLIB.L80 (for the samples library)
    Use the file characteristics shown in File characteristics for obtaining the gateway fix pack files by FTP.
    Table 1. File characteristics for obtaining the gateway fix pack files by FTP
    CharacteristicValue
    Organization PS
    Record formatFB
    Record length80
    Block size27920
    1st extent cylinders1
    Secondary cylinders1
    Note: These files are not allocated as type PDS but as regular sequential files.
  2. Use FTP to retrieve the LOADLIB and SAMPLES fix pack files from the download site, by logging in as anonymous, with your e-mail address as the password. Issue the following commands:
    tso ftp ftp.software.ibm.com
    anonymous
    your_e-mail_address
    cd software/support/patches/patches_8.4.0/
    cd patch_name
    cd ZOS
    bin
    get loadlib_file_name 'TWS4APPS.LOADLIB.L80' (rep
    get samples_file_name 'TWS4APPS.SAMPLIB.L80' (rep
    quit
    For example, for Fix Pack 01 the variables in this list of commands would have the following values:
    patch_name
    8.4.0-TIV-TWSWSE-FP0001
    loadlib_file_name
    LOADLIB_820WSEFP07
    samples_file_name
    SAMPLES_820WSEFP07
    Note: The data set names in quotes on the get commands (the MVS file names) must match the files that were allocated in step 1.
  3. The downloaded files are in an 80-byte packed format. To ensure that the files have been downloaded correctly, browse them. The beginning of the output should be similar to the following:
    BROWSE TWS4APPS.LOADLIB.L80 Line
    \INMR01. ....&......NODENAME......TWSUSR2......A......A......20                 
    ....... \INMR02..........IEBCOPY......... ........ ....... .....                
    ..........."8. .... ................TWS84..XAGENT..V8R4M0..FIXPAC04..DRV1511..LO 
    If it is not, retry the downloads.
  4. Receive the downloaded data sets, as follows:
    LOADLIB
    1. Issue the following command:
      TSO RECEIVE INDSN('TWS4APPS.LOADLIB.L80')
      A prompt is displayed similar to the following:
      INMR901I Dataset TWS84.XAGENT.V8R4M0.FIXPAC04.DRV1511.LOADLIB 
      from TWSUSR2 on NODENAME NMR906A 
      Enter restore parameters or 'DELETE' or 'END' +
      ***
    2. Reply:
      da('TWS4APPS.LOADLIB')
      where da means data set and the MVS data set name in quotes is the name you want for the output loadlib data set.

      Some IEBCOPY messages are displayed as the library is uncompressed.

    SAMPLIB
    1. Issue the following command:
      TSO RECEIVE INDSN('TWS4APPS.SAMPLIB.L80')
      A prompt is displayed similar to the following:
      INMR901I Dataset TWS84.XAGENT.V8R4M0.FIXPAC04.DRV1511.SAMPLIB 
      from TWSUSR2 on NODENAME NMR906A 
      Enter restore parameters or 'DELETE' or 'END' +
      ***
    2. Reply:
      da('TWS4APPS.SAMPLIB')
      where da means data set and the MVS data set name in quotes is the name you want for the output samplib data set.

      Some IEBCOPY messages are displayed as the library is uncompressed.

    After receiving the files, the file characteristics change to those shown in File characteristics for the LOADLIB file after receiving it.
    Table 2. File characteristics for the LOADLIB file after receiving it
    Characteristic Value
    Data Set NameTWS4APPS.LOADLIB
    OrganizationPO
    Record format U
    Record length0
    Block size32760
    1st extent blocks10
    Secondary blocks5
    Data set name typePDS
    Table 3. File characteristics for the SAMPLIB file after receiving it
    CharacteristicValue
    Data Set Name TWS4APPS.SAMPLIB
    OrganizationPO
    Record formatFB
    Record length 80
    Block size27920
    1st extent blocks4
    Secondary blocks1
    Data set name typePDS
Configure the downloaded fix pack files as described in Configuring.