Downloading and Transferring SMA Tables

This document covers the following topics:


General Information

The names of all downloaded SMA tables are composed as follows:

pppvrs.BIN

ppp represents the three-character product code of the Software AG product (for example, "ADA" for Adabas, "NAT" for Natural, or "WCP" for Entire Net-Work).

vrs represents the version number of the Software AG product.

Warning:
Using utilities instead of native FTP commands for transferring the SMA tables may corrupt the SMA tables.

During the product installation on the mainframe, the SMA tables are loaded and processed as required by your Software AG mainframe product. For further information, refer to the installation documentation for your Software AG mainframe product.

Transferring SMA Tables from a PC to a z/OS Host Using FTP

Important:
Make sure to switch to binary transfer and verify that the resulting data set has RECFM=FB and LRECL=80.

Start of instruction setTo transfer SMA tables from a PC to a z/OS host

  1. Download the SMA tables (pppvrs.BIN) to your PC's hard disk.

  2. Start an FTP session for communication with the z/OS host using the following FTP command:

    ftp host-name

    where host-name is the name of the z/OS host.

  3. Enter your login ID and password for the z/OS host.

  4. Switch to binary data mode (an SMA table must retain its format as EBCDIC during the transfer):

    binary
  5. Specify that the data set for the SMA tables must be written with RECFM=FB and LRECL=80:

    quote site RECFM=FB LRECL=80 BLKSIZE=4000
  6. Write the SMA tables as a data set to the z/OS system:

    put pppvrs.BIN 'hilev.pppvrs.smatabs'

    where hilev is the high-level qualifier (for example, "SAG") to be used for the data set.

    This command will create a data set called hilev.pppvrs.smatabs with RECFM=FB and LRECL=80. The SMA tables which are stored in the data set will be in EBCDIC format.

Transferring SMA Tables from a PC to a z/VSE Host Using FTP

The FTP sample session described in the steps below loads the SMA tables into a sequential z/VSE data set (with RECFM=FB and LRECL=80). The sequential data set must be accessible via FTP. That means, the data set must be included as a DLBL statement in the startup of the z/VSE TCP/IP partition:

// ASSGN  SYSnnn,DISK,VOL=vvvvvv,SHR   
// DLBL SMATABS,'SAGNET.SMATABS',0 
// EXTENT SYSnnn,vvvvvv,1,0,ssss,ttt

In addition, it must be defined in the z/VSE TCP/IP config member IPINIT00 with a DEFINE FILE statement with type SAM:

DEFINE FILE,PUBLIC='SMATABS',TYPE=SAM,DLBL=SMATABS

For more information, refer to your FTP documentation.

Start of instruction setTo transfer SMA tables from a PC to a z/VSE host

  1. Download the SMA tables (pppvrs.BIN) to your PC's hard disk.

  2. Start an FTP session for communication with the z/VSE host using the following FTP command:

    ftp host-name

    where host-name is the name of the z/VSE host.

  3. Enter your login ID and password for the z/VSE host.

  4. Once the FTP session has been established, you can optionally reset the default working directory. To determine what the default working directory is, enter the following command:

    pwd

    To reset the default working directory, enter the following command:

    cd ..
  5. Switch to binary data mode (an SMA table must retain its format as EBCDIC during the transfer):

    binary
  6. Specify that the data set for the SMA tables must be written with RECFM=FB and LRECL=80:

    quote site recfm fb
    quote site lrecl 80
    quote site blksize 4000
  7. Write the SMA tables to a sequential data set on the z/VSE system (in this example, it is named SMATABS):

    put pppvrs.BIN SMATABS

    This command will write the SMA tables pppvrs.BIN to a sequential data set called SMATABS. The data set will have RECFM=FB and LRECL=80. The SMA tables will be stored in EBCDIC format.

Transferring SMA Tables from a PC to a BS2000/OSD Host Using FTP

Important:
Make sure to switch to binary transfer and verify that the resulting data set has file type SAM.

Start of instruction setTo transfer SMA tables from a PC to a BS2000/OSD host

  1. Download the SMA tables (pppvrs.BIN) to your PC's hard disk.

  2. Start an FTP session for communication with the BS2000/OSD host using the following FTP command:

    ftp host-name

    where host-name is the name of the BS2000/OSD host.

  3. Enter your user ID, password and (if relevant) account number for the BS2000/OSD host.

  4. Switch to binary data mode (an SMA table must retain its format as EBCDIC during the transfer):

    binary
  5. Specify that the file for the SMA tables must be written with FCBTYPE=SAM, RECFORM=F and RECSIZE=80:

    quote file pppvrs.SMATABS,FCBTYPE=SAM,RECFORM=F,RECSIZE=80
  6. Write the SMA tables to the BS2000/OSD host:

    put pppvrs.BIN pppvrs.SMATABS