FTSHWPTN

Note on usage

Function: Display partner systems

User group: FT user and FT administrator

Functional description

The FTSHWPTN command is used to obtain the following information on partner systems included in the partner list of the current openFT instance:

• the names of the remote systems in the partner list,

• the status of the remote systems (activated or deactivated),

• priority assigned to the partner system,

• the setting for the openFT trace function on the partner system,

• the security level assigned to the remote system. This security level applies only if FTAC functionality is used. The information can then also be obtained using the FTSHWRGE command.

• the number of not yet completed file transfer requests submitted in the local system,

• the number of file transfer requests submitted in the remote systems for the local system,

• the partner address,

• the type of sender checking,

• the recovery of outbound requests,

• in the case of output in CSV format: also the time of the last access and the authentication level.

FTSHWPTN with the PARTNER=*ALL operand (default value) displays all entered dynamic partners. These can be recognized from the fact that they have no name. If you only want to output detailed information on one entered dynamic partner, you must specify the partner’s address in the PARTNER operand. In the case of the FTSHWPTN command openFT does not check whether an address is valid. If, for example, you specify a random address of a free dynamic partner, this will be displayed with the default properties of a free dynamic partner.

Format

FTSHWPTN

PARTNER = *ALL / <text 1..200 with-low>

,OUTPUT = *STDERR (...) / *STDOUT(...)

*STDERR (...) / *STDOUT(...)

LAYOUT = *STD / *CSV / *BS2-PROC / *ZOS-PROC

,STATE = *ALL / *ACTIVE / *DEACT / *INSTALLATION-ERROR / *NO-CONNECTION / *NOT-ACTIVE /

*AUTOMATIC-DEACTIVATION / *INACTIVE-BY-AUTOMATIC-DEACT

,INFORMATION = *STD / *ALL

Operands

PARTNER =

Partner system or systems about which information is to be output.

PARTNER = *ALL
Information on all partner systems is output.

PARTNER = <text 1..200 with-low>
Name or address of the partner system or group of partner systems about which information is to be output.
If you enter a name then you have two options:
You can either enter a unique partner name (1 - 8 alphanumeric characters) or a group of partners identified by a 1 to 7-character specification followed by an asterisk (*).
For more information on partner addresses, see section “Specifying partner addresses”.

OUTPUT =
Output medium.

OUTPUT = *STDERR (...)
Output is performed to SYSTSPRT or SYSERR, if this DDNAME is defined.

OUTPUT = *STDOUT(...)
Output is performed to SYSPRINT.

LAYOUT = *STD
Output is formatted using a standard layout that can be easily read by the user.

LAYOUT = *CSV
Output is supplied in CSV (Character Separated Values) format. This is a widely used tabular format, especially in the PC environment, in which individual fields are separated by a delimiter, which is usually a semicolon “;“ (see section “FTSHWPTN”).

LAYOUT = *BS2-PROC

Output is supplied in the form of MODIFY-FT-PARTNER commands, which precisely define the partners involved. This enables the partner entries to be saved for a later reconstruction, to use them for an openFT operation on BS2000.

LAYOUT = *ZOS-PROC
Output is supplied in the form of FTMODPTN commands, which precisely define the partners involved. This enables the partner entries to be saved for a later reconstruction, to use them for an openFT operation on z/OS (see example 2 in section“Description of the output of FTSHWPTN”).

STATE =
The scope of the output can be limited by the optional selection criteria in STATE. For an explanation of the selection criteria see Description of the output of FTSHWPTN.

STATE = *ALL
The output is not limited by selection criteria.

STATE = *ACTIVE
All partner systems in the ACTIVE state are displayed.

STATE = *DEACT
All partner systems in the DEACT state are displayed.

STATE = *INSTALLATION-ERROR
All partner systems in the LUNK, RUNK, LAUTH, RAUTH, NOKEY and IDREJ state are displayed.

STATE = *NO-CONNECTION
All partner systems in the NOCON and DIERR state are displayed.

STATE = *NOT-ACTIVE
All partner systems not in the ACTIVE state are displayed.

STATE = *AUTOMATIC-DEACTIVATION
All partner systems are output which were assigned AUTOMATIC-DEACTIVATION.

STATE = *INACTIVE-BY-AUTOMATIC-DEACT
All partner systems are output which were actually deactivated using the option AUTOMATIC-DEACTIVATION.

INFORMATION = *STD / *ALL
Use this operand to control the scope of the information output. On *ALL, expanded address information is output, in addition to the standard information.