Statements used for FTP_JOB in WA ESP Edition

Products

• Workload Automation Agent

Issue/Introduction

When attempting to set up FTP_JOB, what statements should be coded on the FTP_JOB and what do these statements mean?

 

Environment

Release:  11.4 & 12.0
Component: CA Workload Automation ESP Edition

Resolution

Let me explain generally the statements used in FTP_JOB. You can find some related information in "Administrator's Guide" and "Guide to Schedule Workload".

1. USER statement used in FTP_JOB is not the userid that can access the agent server, but the userid used to do the FTP.
2. Userid defined by USER statement needs to be defined to CA ESP Workload Automation with PASSWORD command.
3. userid defined in USER statement in FTP_JOB also needs to be specified using CybFTPSecurityUtility on the agent server, then one record should be written to ftpusers.txt
4. The SERVERADDR and SERVERPORT should be related to the FTP server where the REMOTEFILE resides. For example, when REMOTEFILE is a mainframe file, they should be the mainframe FTP server address and port.
5. LOCALFILENAME is the one residing on the same server as the agent.
6. UPLOAD in TRANSFERDIRECTION means FTP LOCALFILE to REMOTEFILE and DOWNLOAD is the opposite direction.
7. If LOCALFILENAME or REMOTEFILE is a mainframe file, please add three single quotes on both sides of the file name.

Here is one example with explanation:

APPL FTPJOB 

FTP_JOB MYTEST
   AGENT LZHP
   RUN ANY   
   USER CYBLZ01                          --> this is my mainframe userid, should be defined by PASSWORD on ESP,
                                             and CybFTPSEcurityUtility on agent   
   SERVERADDR 10.1.15.1                  --> mainframe IP address   
   SERVERPORT 21                         --> mainframe FTP port   
   TRANSFERDIRECTION UPLOAD              --> FTP LOCALFILE to REMOTEFILE   
   FTPFORMAT A   
   LOCALFILENAME test                     --> this file resides on server where agent LZHP is installed, it's in agent
                                             installation folder;   
   REMOTEFILENAME '''CYBLZ01.FTP.GET'''  --> mainframe file name 
ENDJOB