Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-FT-PARTNERS

&pagelevel(3)&pagelevel

Note on usage

Function: Display partner systems

User group: FT user and FT administrator

Alias name: FTSHWPTN

Functional description

The SHOW-FT-PARTNERS command is used to obtain the following information on partner systems included in the partner list :

  • 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 SHOW-FT-RANGE 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,

  • The RSA-PROPOSAL key of the partner system,
  • The RSA-MINIMUM key of the partner system,

  • in the case of output in CSV format or to an OPS variable: also the time of the last access and the authentication level.

SHOW-FT-PARTNERS 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 SHOW-FT-PARTNERS 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

SHOW-FT-PARTNERS / FTSHWPTN

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

,OUTPUT = *SYSOUT (...) / *SYSLST(...)

*SYSOUT (...) / *SYSLST(...)

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

,KEY-LENGTH = *PARAMETERS (...)

*PARAMETERS(...)

RSA-PROPOSED = *ALL / *BY-FT-OPTIONS / 0 / 768 / 1024 / 2048 / 3072 / 4096

,RSA-MINIMUM = *ALL / *BY-FT-OPTIONS / 0 / 768 / 1024 / 2048 / 3072 / 4096

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 = *SYSOUT (...)
Output is sent to SYSOUT.

OUTPUT = *SYSLST(...)
Output is sent to SYSLST.

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 “SHOW-FT-PARTNERS”).

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.
If this output is redirected to a file by using the SYSFILE command, it should be noted that the BS2000 Sysfile Management inserts a blank (i.e., a linefeed character) before each line. The first column of the file must hence be stripped before the procedure generated by this method can be called. We therefore recommend that you use the START-OPENFTPART command, which performs this task for the user.

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.

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 SHOW-FT-PARTNERS.

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.

KEY-LENGTH = *PARAMETERS(...)
Configuration of the length of the display of RSA partner keys.

RSA-PROPOSED
This operand enables you to display the properties of partner systems which have a specific RSA-PROPOSAL key.

RSA-PROPOSED = *ALL

The output is not limited by selection criteria.

RSA-PROPOSED = *BY-FT-OPTIONS

All partner systems with RSA-PROPOSAL set to global option “FTOPT” will be displayed.

RSA-PROPOSED = 0 / 768 / 1024 / 2048 / 3072 / 4096
All partner systems with RSA-PROPOSAL set to one of partner local RSA key value will be displayed.

RSA-MINIMUM
This operand enables you to display the properties of partner systems which have a specific RSA-MINIMUM key.

RSA-MINIMUM = 'ALL
The output is not limited by selection criteria

RSA-MINIMUM = *BY-FT-OPTIONS
All partner systems with RSA-MINIMUM set to global option “FTOPT” will be displayed.

RSA-MINIMUM = 0 / 768 / 1024 / 2048 / 3072 / 4096
All partner systems with RSA-MINIMUM set to one of partner local RSA key value will be displayed.

Command return codes

(SC2)

SC1

Maincode

Meaning

0

0

CMD0001

No partner available for the selection criteria.

83

32

CMD0221

Internal error.

88

32

CMD0221

Error during OPS generation.

35

64

FTR1035

The user is not authorized to use this command.

45

64

FTR1045

No partner found in partner list.

2

0

FTR2225

Information output cancelled.

SC1/2 = Subcode 1/2 in decimal notation
For additional information, see section “Command return codes”.

OPS variables

The following table shows the OPS variables for the command SHOW-FT-PARTNERS.

Element

Type

Output

PARTNER-NAME

String


STA

String

*ACTIVE / *INACTIVE / *NO-CONN / *LOC-UNKNOWN
/*REM-UNKNOWN /*ACTIVE (AUTO-DEACTIVATE) /
*INACTIVE (BY- AUTOMATIC-DEACTIVATION) /
*LOC-AUTH-FAIL / *REM-AUTH-FAIL /
*DATA-INTEGRITY-ERROR / *NO-KEY / *ID-REJ

SEC-LEV

Integer/
String

VALUE / *B-P-ADDR

TRACE

String

*ON / *OFF / *BY-FT-OPT

LOC

Integer

Value

REM

Integer

Value

PARTNER-ADDR

String

Value

PRIO

String

*NORM / *HIGH / *LOW

AUTHENTICATION-LEVEL

Integer

1 / 2 / empty

LAST-ACCESS-DATE

String

Value / empty

ADDR-TYPE 1

String

*OPENFT / *PRESENTATION / *TCP-IP

OPENFT-ADDR 2

Struct


.PROCESSOR

String

Value

.ENTITY

String

Value

.NETWORK-ADDR

String

Value

.TRANS-SEL

String

Value

.PORT

String

port number

.PARTNER-CHECK

String

*FTOPT / *STD / *TRANSP-ADDR / *AUTH

.AUTH-MAND

String

*YES / *NO

.IDENTIFICATION

String

Value

.SESSION-ROUTING

String

*ID or empty

PRESENTATION-ADDR 3

Struct


.NETWORK-ADDR

String

Value

.TRANSPORT-SEL

String

Value

.SESSION-SEL

String

Value

.PRESENTATION-SEL

String

Value

.PORT

String

Value

TCP-IP-ADDR 4

Struct


.PORT

String

Value

ADM-ADDR 5

Struct


.PROCESSOR

String

Value

.ENTITY

String

Value

.NETWORK-ADDR

String

Value

.TRANS-SEL

String

Value

.PORT

String

Port number

.PARTNER-CHECK

String

*FTOPT / *STD / *TRANSP-ADDR /*AUTH

.AUTH-MAND

String

*YES / *NO

.IDENTIFICATION

String

Value

.SESSION-ROUTING

String

*ID / empty

INBOUND-STATE

String

*ACTIVE / *INACTIVE

REQ-PROC

String

*STD / *SERIAL

RECOVERY-OUTBOUND

String

*ON / *OFF / *BY-FT-OPT

RSA-PROPOSAL

String

*BY-FT-OPT/0/768/1024/2048/3072/4096

RSA-MINIMUM

String

*BY-FT-OPT/0/768/1024/2048/3072/4096

1Only the address structure corresponding to the ADDR-TYPE element is displayed.

2Only applies to openFT partners.

3Only applies to FTAM partners.

4Only applies to FTP partners.

5Only applies to ADM partners.

Powered by Atlassian Confluence and Scroll Viewport.