Defining Parameters for an FTP Job

#### Search Results

Search

# 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

- 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 like 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.

### On this page

- Adding an FTP Parameter Definition
- JCL Generation for FTP Jobs