The following applies to the addressing of a partner system:
You can specify the name of the partner from the partner list provided that the partner has been entered in the partner list.
A partner has to be entered in the partner list by the FT administrator. For this purpose, the FT administrator can use the following commands:
FTADDPTN
FTMODPTN
You can access a partner directly via its address in FT or file management requests even if it is not entered in the partner list. This is only possible if the “dynamic partner” function is enabled via operating parameters.
Partner addresses
A partner address has the following structure:
[protocol://]host[:[port].[tsel].[ssel].[psel]]
host (= computer name, see host) is mandatory; all other specifications are optional. In many cases, the other specifications are covered by the default values, so that the host name suffices as the partner address, see Examples. Final ’.’ or ’:’ can be omitted.
The individual components of the address have the following meanings:
protocol://
Protocol stack via which the partner is addressed. Possible values for protocol (uppercase and lowercase are not distinguished):
openft
openFT partner, i.e. communication takes place over the openFT protocol.
ftp
FTP partner, i.e. communication takes place over the FTP protocol.
ftadm
ADM partner, i.e. communication takes place over the FTADM protocol for remote administration and ADM traps.
Default value: openft
host
Computer name via which the partner is addressed. Possible entries:
internet host name (e.g. DNS name), length 1 to 80 characters, up to 24 characters for z/OS partner systems with openFT < V12.1.
TNS name from the z/OS library (TNSTCPIP member), up to 8 characters in length.
SNA LU name, length 1 to 8 characters.
IPv4 address with the prefix %ip, i.e. for example %ip139.22.33.44.
The IP address must always be specified as a sequence of decimal numbers separated by dots and without leading zeros.
port
When a connection is established over TCP/IP, you can specify the port name under which the file transfer application can be accessed in the partner system.
Permitted range of values: 1 through 65535.
Default value:
1100 for openFT partners.
A different default value can also be set in the operating parameters using the following command: FTMODOPT21 for FTP partners
11000 for ADM partners
tsel
Transport selector under which the file transfer application is available in the partner system. The transport selector is only relevant for openFT partners.
You can specify the selector in printable or hexadecimal format (0xnnnn...).
openFT partner:
Length, 1 through 8 characters; alphanumeric characters and the special characters # @ $ are permitted. A printable selector will be coded in EBCDIC in the protocol and may be padded with spaces internally to the length of eight characters.Default value: $FJAM
Printable transport selectors are always used in uppercase in openFT even if they are specified or output in lowercase.
ssel
Session selector under which the file transfer application is accessible in the partner system. You can specify the selector in printable or hexadecimal format (0xnnnn...). Length, 1 through 10 characters; alphanumeric characters and the special characters @ $ # _ - + = * are permitted. A printable selector is encoded in ASCII with a variable length in the log.
Default value: empty
Printable session selectors are always used in uppercase in openFT even if they are specified or output in lowercase.
psel
Not used under z/OS.
Examples
The partner computer with the host name FILESERV is to be addressed over different protocols/connection types:
Connection type/protocol | Address specification |
openFT partner | FILESERV |
FTP partner | ftp : / /FILESERV |
FTADM partner | ftadm://FILESERV |
SNA partner via openFT protocol | FILESERV:sna |