Modify FTP JCL

Use the following procedure to modify your FTP JCL to use IBM® Sterling Connect:Direct® FTP+ :

  1. Change EXEC PGM=FTP to EXEC PROC=CDFTP.
  2. Change the INPUT and OUTPUT DD statements and other step statements to specify the procedure step name. For example, change //INPUT to //CDFTP.INPUT and change //OUTPUT to //CDFTP.OUTPUT.
  3. Change the first statement in the INPUT data stream to specify the remote IBM Connect:Direct node name instead of the machine name for the FTP server.

    The following is an example of JCL that executes the CDFTP procedure:

    //CD$FTPJC JOB (CDHOSTD),'-CDFTP+-',TIME=(1440),CLASS=Q,
    // REGION=0M,MSGLEVEL=(1,1),MSGCLASS=X,NOTIFY=&SYSUID
    /*JOBPARM LINES=999999
    //LIBS JCLLIB ORDER=(USER1.OS390.SRCLIB)
    //CDFTP EXEC PROC=CDFTP
    //CDFTP.NETRC DD DISP=SHR,DSN=USER1.OS390.SRCLIB(NETRC)
    //CDFTP.FTPTRACE DD SYSOUT=*
    //CDFTP.OUTPUT DD SYSOUT=*
    //CDFTP.INPUT DD *
    MVSB (exit
    ebcdic
    cd /u/user3
    delimit
    mkdir cdftptestlib
    cd cdftptestlib
    lcd 'USER1.CDFTP.TESTLIB'
    delimit
    bin
    site sbdataconn=(IBM-037,ISO8859-1)
    locsite sbdataconn=(IBM-037,ISO8859-1)
    put CDFTPJC1
    ebcdic
    put CDFTPJC1 CDFTPJC2
    dir
    ls
    mdelete CDFTPJC*
    cdup
    rmdir cdftptestlib
    close
    quit
    //

    You must provide the following information in the JCL:

    • Remote host—In this example, the hostname of the FTP server is changed to specify the IBM Connect:Direct node name, MVSB, that is in the Netmap. If the DNS name or IP address used by FTP is the nodename in the Netmap, no change is required. However, duplicating the entry in the Netmap and giving it the IP address or the DNS name as the node name may cause Netmap checking problems. In this case, the script should be changed to use the Netmap entry node name.

      The remote host statement can also specify (exit, as shown in this example, or (exit=nn to specify that any error exits the script with a reason code (default is RC=8).

      The remote host statement can also specify (secure=off|ssl|tls to specify security options.

      If both exit and secure= are specified; only one open parenthesis can be used. For example, MVSB (exit 16 secure=off.

    • Remote userid and password—In this example, they are obtained from the NETRC file. If the remote userid and password are not specified in the NETRC file, they must be included in the FTP script after the remote host.

      In the following sample excerpt of JCL that executes the CDFTP procedure, the remote host is PROD.ZOS1, the remote userid is user1 and the password is S1VX$25B:

      ...
      //CDFTP.INPUT DD *
      PROD.ZOS1
      user1 S1VX$25B
      cd /u/daily
      ...

    You do not specify the use of Connect:Direct Secure Plus in the JCL. It is determined by the initialization parameters and the Connect:Direct Secure Plus parameter file definitions for the node named in the script.

    To simplify matching up statistics in the remote node with IBM Sterling Connect:Direct FTP+ for z/OS, the PROCESS name is the jobname and the process number is the jobid. The jobname is also used for the IBM Sterling Connect:Direct FTP+ Client server name when contacting the IBM Sterling Connect:Direct FTP+ Manager.

    Note: Only the JCL interface is implemented. The ISPF interface (option 6;FTP) is not supported.