Defining Parameters for an FTP Job

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

Start of instruction setTo 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 press 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, press PF5 to save your entries.

This section covers the following topics:

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) (optional)

File name for the target.

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.

Job Card z/OS

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 will be 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 will be 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.