Note on usage
Function: Add remote system to the partner list
User group: FT administrator
You can issue the FTADDPTN command under TSO.
Functional description
The FTADDPTN command is used to enter a remote system in the partner list of the local openFT instance. The network or transport system must be generated beforehand.
For details concerning the generation process, please refer to the manual "openFT (z/OS) - Installation and Operation" or another relevant manual.
The specifications which you need to enter for each partner system depend on the type of partner system (openFT (z/OS), openFT (BS2000), openFT (Unisx systems), openFT (Windows) etc.), and the method of connection to the remote system (SNA, TCP/IP directly). For details on specifying partner addresses, refer to section “Specifying partneraddresses”.
If dynamic partners are permitted then inbound and outbound requests can be processed with partners which are accessed via their addresses and are not defined in the partner list.
You can issue the FTADDPTN command for all partner types while the FT system is running (openFT partner, ftp partner and ADM partner).
You can modify the partner system entry with FTMODPTN and delete it with FTREMPTN.
Format
FTADDPTN |
PARTNER-NAME = <name 1..8> / *NONE ,PARTNER-ADDRESS = <text 1..200 with-low> ,SECURITY-LEVEL = *STD / *BY-PARTNER-ATTRIBUTES / <integer 1..100> ,STATE = *PARAMETERS(...) *PARAMETERS(...) OUTBOUND = *ACT IVE(...) / *DEACT *ACT IVE(...) AUTOMATIC-DEACT = *NO / *YES ,INBOUND = *ACT IVE / *DEACT ,IDENTIFICATION = *STD / <composed-name 1..64> / <c-string 1..64 with-low> ,SESSION-ROUTING-INFO = *NONE / *IDENTIFICATION / <alphanum-name 1..8> ,PARTNER-CHECK = *BY-FT-OPT IONS / *STD / *TRANSPORT-ADDRESS ,TRACE = *BY-FT-OPT IONS / *ON / *OFF ,AUTH-MANDATORY= *NO / *YES ,PRIORITY= *NORMAL / *LOW / *HIGH ,REQUEST-PROCESSING = *STD / *SERIAL ,RECOVERY-OUTBOUND = *BY-FT-OPTIONS / *ON / *OFF |
Operands
PARTNER-NAME =
Symbolic name of the partner system. It can be freely selected and need only be unique within openFT.
PARTNER-NAME = <name 1..8>
The operand value “name” consists of a maximum of 8 alphanumeric characters and must be unique in the local system. The FT administrator defines this name. This name can be used in the PARTNER parameter in all FT commands in order to address the partner system.
PARTNER-NAME = *NONE
Specifies that the partner is a dynamic partner.
PARTNER-ADDRESS = <text 1..200 with-low>
Address of the partner system. This specifies whether the partner is an openFT or FTP or ADM partner. For more information on address specifications see section “Specifyingpartner addresses”.
SECURITY-LEVEL =
Assigns a security level to a remote system.
SECURITY-LEVEL = *STD
If you set this operand to *STD or if you do not enter a value here, a standard security level is assigned to the remote system. This standard security level is defined using the command MODIFY-FT-OPTIONS. You can define a fixed value or specify that the value should be attribute-dependent.
SECURITY-LEVEL = *BY-PARTNER-ATTRIBUTES
If you set this operand to *STD or if you do not enter a value here, a standard security level is assigned to the remote system:
This setting assigns partners that are authenticated by openFT the security level 10.
Partners known to the transport system (e.g. VTAM or DNS) are assigned security level 90.
All other partners are assigned security level 100.
SECURITY-LEVEL = <integer 1..100>
Must be specified if you wish to assign an individual security level to a specific remote system.
STATE = *PARAMETERS(...)
Controls the status of the partner system, i.e. the settings for file transfer requests issued locally (outbound) and file transfer requests issued remotely (inbound).
OUTBOUND =
Specifies the settings for file transfer requests issued locally to this partner system.
OUTBOUND = *ACTIVE (...)
File transfer requests issued locally to this partner system are processed.
AUTOMATIC-DEACT =
Defines whether cyclical attempts to establish a connection to this partner system are prohibited after a number of attempts by deactivating the partner system.
AUTOMATIC-DEACT = *NO
Failed attempts to establish a connection of this partner system do not result in its deactivation.
AUTOMATIC-DEACT = *YES
Failed attempts to establish a connection of this partner system result in its deactivation. In order to enable file transfer requests issued locally to this partner system to be executed again subsequently, it must be explicitly activated (with
OUTBOUND=*ACTIVE).
OUTBOUND = *DEACT
File transfer requests issued locally to this partner system are initially not processed (not started), but are only placed in the request queue. They are executed only after the partner system has been activated with
FTMODPTN ... , STATE=(OUTBOUND=*ACTIVE).
INBOUND =
Specifies the settings for file transfer requests issued remotely, i.e. requests which are issued by this partner system.
INBOUND = *ACTIVE
File transfer requests issued remotely by this partner system are processed.
INBOUND = *DEACT
Synchronous file transfer requests issued remotely by this partner system are rejected. Asynchronous file transfer requests issued remotely by this partner system are stored there and cannot be processed until this partner system is activated with INBOUND=*ACTIVE.
IDENTIFICATION =
Network-wide, unique identification of the openFT instance in the partner system.
IDENTIFICATION = *STD
For openFT and FTADM partners, the partner address or the hostname from the partner address is used as the identification. For FTP partners, no identification is set.
IDENTIFICATION = <composed-name 1..64> / <c-string 1..64 with-low>
The network-wide, unique instance ID of the openFT instance in the partner system. This ID is used for authentication of partner systems as of openFT V8.1. It is set by the FT administrator of the partner system (in BS2000 by using MODIFY-FT-OPTIONS IDENTIFICATION= and in Unix systems or Windows systems by using ftmodo -id).
For more details on allocating instance IDs, please refer to section “Instanceidentifications”.
No instance identification may be specified for FTP partners.
SESSION-ROUTING-INFO =
If the partner system is only accessible by a go-between instance, specify the address information that the gateway instance uses for re-routing here.
SESSION-ROUTING-INFO = *NONE
By default, no specification is required.
The session selector can be specified as a part of the partner address.
SESSION-ROUTING-INFO = *IDENTIFICATION
Connections to the partner are re-routed via a gateway that supports the instance ID as address information.
SESSION-ROUTING-INFO = <alphanum-name 1..8>
Connections to the partner are re-routed via a gateway that supports the specified character string as address information.
PARTNER-CHECK =
Modifies the global settings for the sender check in a partner-specific way. These settings are only valid for named openFT partners that do not work with authentication.
This setting has no meaning for FTP partners and dynamic partner entries.
PARTNER-CHECK = *BY-FT-OPTIONS
The global settings are valid for the partners.
PARTNER-CHECK = *STD
Disables the expanded sender checking. The transport address of the partner is not checked, even if the expanded sender checking is globally enabled (see the FTMODOPT command).
PARTNER-CHECK = *TRANSPORT-ADDRESS
Enables the expanded sender checking. The transport address is checked, even if the expanded sender checking is globally disabled (see the FTMODOPT command).
If the transport address under which the partner is reporting does not correspond to the entry in the partner list, the request is rejected.
TRACE =
Trace setting for openFT partner systems. Trace entries are generated only when the FT trace function is activated by an operating parameter (FTMODOPT TRACE=*ON).
TRACE = *BY-FT-OPTIONS
The global settings apply for the partner.
TRACE = *ON
The trace function is activated for this partner. However, the trace is only written if the global openFT trace function is also activated (see also the FTMODOPT command, TRACE option, SWITCH=*ON). The setting made here takes priority over the setting in the operating parameters for selecting partners for the monitoring function, see the option TRACE=(...,PARTNER-SELECTION=).
TRACE = *OFF
The trace function is deactivated for this partner.
AUTH-MANDATORY =
Allows you to force the authentication of a named partner.
AUTH-MANDATORY = *NO
Authentication is not forced, i.e. this partner is not restricted with regard to authentication.
AUTH-MANDATORY = *YES
Authentication is forced, i.e. connections to and from this partner are only permitted with authentication.
PRIORITY=
This operand allows you to specify the priority of a partner in respect of processing requests that have the same request priority. This means that the partner priority only applies in the case of requests that have the same request priority, but that are issued to partners with a different partner priority.
PRIORITY = *NORMAL
The partner has normal priority.
PRIORITY = *LOW
The partner has low priority.
PRIORITY = *HIGH
The partner has high priority.
REQUEST-PROCESSING =
You use this option to control whether asynchronous outbound requests to this partner are always run serially or whether parallel connections are permitted.
REQUEST-PROCESSING = *STD
Parallel connections to this partner are permitted.
REQUEST-PROCESSING = *SERIAL
Parallel connections to this partner are not permitted. If multiple file transfer requests to this partner are pending, then they are processed serially. A follow-up request is consequently not started until the preceding request has terminated.
RECOVERY-OUTBOUND=
This operand controls the restart function for asynchronous outbound requests for this partner system.
RECOVERY-OUTBOUND= *BY-FT-OPTIONS
The global setting for the restart function for outbound requests is valid.
RECOVERY-OUTBOUND= *ON
The restart function for outbound requests to this partner system is activated. This is only valid if the global setting for the restart function is activated, too.
RECOVERY-OUTBOUND= *OFF
The restart function for outbound requests to this partner system is deactivated.
If the FTADDPTN command is executed correctly then no message is output.