Installation : Uploading the Software

Uploading the Software
If you have acquired the Adapter for Files z/OS software by downloading it from the TIBCO web site, you will need to upload the software to the z/OS MVS host system using the FTP file transfer utility. The sample JCL below illustrates the statements needed to perform this file transfer.
Initial Installation
Sample JCL for an FTP Upload of DFSMS Files
The sample JCL illustrates the process, using IBM's FTP to copy TIBCO Adapter for Files z/OS installation file(s) from a LAN server or PC to the z/OS MVS host. The maximum length that can be used for #USERHLQ is 19 characters.
//#JOBNAME JOB (&SYSUID),'FileAdapter FTP',CLASS=A
//*
// SET FTPADDR=10.10.2.99 < IP Address or Host Name
//*
//FTP EXEC PGM=FTP,REGION=0M,PARM='&FTPADDR (TIMEOUT 20'
//SYSPRINT DD SYSOUT=*
//OUTPUT DD SYSOUT=*
//SYSTCPD DD DISP=SHR,DSN=TCPIP.PROFILE(FTPDATA) < Host Member
//INPUT DD *
<lan-userid>
<lan-password>
cd /<lan-file-dir>
binary
LOCSITE RECFM=FB LRECL=80 BLKSIZE=27920 CYL PRI=2 SEC=1
get TIB_fa_4.7.0_zos16.mvs.xmit.inst '#USERHLQ.XMIT.INST' (REPLACE
LOCSITE RECFM=FB LRECL=80 BLKSIZE=27920 CYL PRI=15 SEC=2
get TIB_fa_4.7.0_zos16.mvs.xmit.main '#USERHLQ.XMIT.MAIN' (REPLACE
quit
/*
//
 
Sample JCL for an FTP Upload of non-DFSMS files
The sample JCL illustrates the process, using IBM's FTP to copy TIBCO Adapter for Files z/OS installation file(s) from a LAN server or PC to the z/OS MVS host. The maximum length that can be used for #USERHLQ is 19 characters.
//#JOBNAME JOB (&SYSUID),'FileAdapter FTP',CLASS=A
//*
// SET FTPADDR=10.10.2.99 < IP Address or Host Name
//*
//FTP EXEC PGM=FTP,REGION=0M,PARM='&FTPADDR (TIMEOUT 20'
//SYSPRINT DD SYSOUT=*
//OUTPUT DD SYSOUT=*
//SYSTCPD DD DISP=SHR,DSN=TCPIP.PROFILE(FTPDATA) < Host Member
//INPUT DD *
<lan-userid>
<lan-password>
cd /<lan-file-dir>
binary
LOCSITE RECFM=FB LRECL=80 BLKSIZE=27920 CYL PRI=15 SEC=2
get TIB_fa_4.7.0_zos16.mvs.xmit.nodfs.load +
'#USERHLQ.XMIT.LOAD' (REPLACE
LOCSITE RECFM=FB LRECL=80 BLKSIZE=27920 CYL PRI=2 SEC=2
get TIB_fa_4.7.0_zos16.mvs.xmit.nodfs.data +
'#USERHLQ.XMIT.DATA' (REPLACE
get TIB_fa_4.7.0_zos16.mvs.xmit.nodfs.emscntl +
'#USERHLQ.XMIT.EMS.CNTL' (REPLACE
get TIB_fa_4.7.0_zos16.mvs.xmit.nodfs.inst +
'#USERHLQ.XMIT.INST' (REPLACE
get TIB_fa_4.7.0_zos16.mvs.xmit.nodfs.jcl +
'#USERHLQ.XMIT.JCL' (REPLACE
get TIB_fa_4.7.0_zos16.mvs.xmit.nodfs.proc +
'#USERHLQ.XMIT.PROC' (REPLACE
get TIB_fa_4.7.0_zos16.mvs.xmit.nodfs.rvcntl +
'#USERHLQ.XMIT.RV.CNTL' (REPLACE
get TIB_fa_4.7.0_zos16.mvs.xmit.nodfs.skel +
'#USERHLQ.XMIT.SKEL' (REPLACE
quit
/*
//
Sample JCL for Tape/Cartridge Unload
//#JOBNAME JOB (&SYSUID),'UNLOAD TAPE',CLASS=A,MSGLEVEL=(1,1)
//*
// SET USERHLQ=#USERHLQ
// SET USERVOL=#USERVOL
//*
//* COPY THE XMIT FILE(S) FROM 3480 TAPE TO DISK
//*
//XMITINST EXEC PGM=IEBGENER
//SYSPRINT DD SYSOUT=*
//SYSUT2 DD DSN=&USERHLQ..XMIT.INST,VOL=SER=&USERVOL,
// DCB=(DSORG=PS,RECFM=FB,LRECL=80,BLKSIZE=27920),
// DISP=(NEW,CATLG,DELETE),SPACE=(TRK,(2,1),RLSE)
//SYSUT1 DD DISP=SHR,DSN=TIBCO.SXF.INST.XMIT,
// LABEL=(1,SL),VOL=(,RETAIN,SER=SXS210),UNIT=TAPE
//SYSIN DD DUMMY
//*
Receiving the Initial Installation File
The <USERHLQ>.XMIT.INST file contains the JCL that is required to receive other files and to create the appropriate libraries for Adapter for Files z/OS. To complete this process, you must substitute the appropriate site-specific user values for the TIBCO supplied variables.
Follow these steps:
1.
From the ISPF Command Shell Panel, type the following command to receive a file containing the JCL required to begin a first time installation:
   receive inda('<USERHLQ>.XMIT.INST')
TSO will prompt with the following:
   INMR906A Enter restore parameters or 'DELETE' or 'END' +
2.
   DA('<USERHLQ>.INSTALL')
After a successful receive, the following message is displayed:
   INMR001I Restore successful to dataset '<USERHLQ>.INSTALL'
The data set name supplied in Step 2 is output and populated with the members that are required in order for you to continue with the installation.