Jobs of the type FTP use JCL generated by Entire Operations, depending on the defined FTP (File Transfer Protocol) parameters.

This section covers the following topics:

• Adding an FTP Parameter Definition

• JCL Generation for FTP Jobs

---

Adding an FTP Parameter Definition

To add or modify an FTP parameter definition

1. In the Job Definition (Master) window of the required job, enter FTP in the Job Type field and choose PF9 (JCL).

   Or:
   On the Job Maintenance screen, type J (JCL) in the line command input field next to the job of the type FTP whose definition you want to modify, and press ENTER.

   A Job Definition - FTP Attributes screen similar to the example below appears:

   24.10.08 ***** Entire Operations ***** 09:12:22 Job Definition - FTP Attributes Owner ==> SN Run ==> Network ==> FTP-002 Execution Node ==> N0517 Linux Job ==> LIN-01 Symbol Table ==> FTP-002 --------------------------------------------------------------------------- Remote ... Host ==> §HOST_____________________________________________ User ID ==> §FUSER______________ Account ==> ________ Group ==> ____________________ Password ==> def. Y Remote Directory §REMOTEDIR____________________________________________________________________ File test__________________________________________________________________________ File 2 (Target) ______________________________________________________________________________ Local Directory localdir______________________________________________________________________ FTP Type ==> _ Function ==> reget___ File Type ==> A Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help End Save Symb

2. Enter the required values.

   The input fields are explained in Fields: FTP Parameter Definition.

   The special PF key function available is described in Special PF Keys: FTP Parameter Definition.

3. When you are finished, choose PF5 to save your entries.

This section covers the following topics:

• Fields: FTP Parameter Definition

• Special PF Keys: FTP Parameter Definition

Fields: FTP Parameter Definition

The fields on the Job Definition - FTP Attributes screen are described in the following table.

Field	Description
Remote Host	Name of the remote host to be used for the file transfer. Example: host1.company.net Symbols can be used.
Remote User ID	User ID for the FTP login on the remote host. Symbols can be used. Note for UNIX: If you use .netrc (on the execution node’s host) to specify user IDs and passwords for remote hosts, you may leave this field empty.
Remote Account	Account for the FTP login on the remote host. Required for some platforms only. Symbols can be used.
Remote Group	Group or domain, respectively, for the FTP login on the remote host. Required for some platforms only. Symbols can be used.
Remote Password	Password for the FTP login on the remote host. Note for UNIX: If you use .netrc (on the execution node’s host) to specify user IDs and passwords for remote hosts, you may leave this field empty.
def.	Y	A password is defined
	N	A password is not defined.
Remote Directory	Directory on the remote host, which contains (or is the target) of the file(s) to be transferred. Symbols can be used.
File	File(s) to be transferred. Symbols can be used.
File 2 (Target)	File name for the target (optional). Use this field only if the file is to be renamed on the target machine. Symbols can be used.
Local Directory	Directory on the local host (execution node), which contains (or is the target) of the file(s) to be transferred. Symbols can be used.
FTP Type	FTP type Valid input value: F (standard FTP)
Function	File transfer function to be used. Examples: get, put, mget, mput
File Type	File type. Valid file types are:
	A	ASCII for text files.
	I	Binary for other files.

Special PF Keys: FTP Parameter Definition

The following special PF key is provided on the Job Definition - FTP Attributes screen:

PF Key	Name	Function
PF7	Symb	Display the symbol table specified in the Symbol Table field. You can define or change the symbol table.

JCL Generation for FTP Jobs

Submit User ID

If no Submit User ID is defined for a z/OS FTP job, Entire Operations tries to use the network's default Submit User ID. If this fails, Entire Operations attempts to use the execution node's default Submit User ID.

z/OS Job Card

The z/OS job card generation can be done manually by defining the symbol FTP-JOBC1-jobname.

A job card continuation can be defined optionally in FTP-JOBC2-jobname.

If neither symbol is present, the z/OS job card is generated as

//submit-userid JOB ...

Site Commands

If the predefined symbols FTP-SITE1-jobname and FTP-SITE2-jobname are defined, one or two FTP site commands are generated, appended by the contents of these symbols.

FTP Function

If the FTP function is put, and if the target file is to be renamed, a sequence of put (with the origin name) and rename is generated now.

FTP Parameters

The FTP parameter generation can be done manually by defining the symbol FTP-PARM1-jobname.

The default is:

For z/OS:	"-e -i -v -n"
For UNIX, Windows:	"-d -i -v -n"

See also Predefined Symbols in the section Symbol Table and Symbol Maintenance.