Note on usage
Function: Display partner properties
User group: FT user and FT administrator
Functional description
You use the ftshwptn command to call up the following information about the partner systems entered in the partner list:
The name of the partner system
The status of the partner system (activated, deactivated)
The security level that was assigned to the partner system
The priority that was assigned to the partner system
The setting for the openFT trace function for the partner system
The number of file transfer requests to the partner system issued in the local system that have not yet been completed
The number of file transfer requests for the local system that have been issued in the partner system
The mode for sender verification and authentication
The partner system's transport address, possibly with the port number if this is different from the default
The identification of the partner system
The routing information if the partner system can only be accessed via an intermediate instance
- The RSA-PROPOSAL key of the partner system
- The RSA-MINIMUM key of the partner system
You can also output the partners in the partner list as a platform-specific command sequence. In this way, it is possible to save the partner list and load it at another computer which may possibly be running a different operating system.
Format
ftshwptn -h |
[ <partner 1..200> | @a ]
[ -st=a | -st=na | -st=d | -st=ie | -st=nc | -st=ad | -st=da ]
[ -l | -csv | -px | -pw | -p2 | -pz | -pa ]
[ -kl= | -kl=FTOPT | -kl=0 | 768 | 1024 | 2048 | 3072 | 4096 ]
[ -klmin= | -klmin=FTOPT | -klmin=0 | 768 | 1024 | 2048 | 3072 | 4096 ]
Description
-h
Displays the command syntax on the screen. Entries after the -h are ignored.
partner | @a
Specifies the partner whose properties you want to display. You can specify the name of the partner in the partner list or the address of the partner system. For details in address specifications, see section “Specifying partner addresses”.
@a for partner
The properties of all the partners in the partner list are displayed.
partner not specified
The properties of all the partners in the partner list are displayed.
-st=a | -st=na | -st=d | -st=ie | -st=nc | -st=ad | -st=da
This operand enables you to display the properties of partner systems which have a specific status. You can specify the following values:
a (active)
All the partner systems with the status ACTIVE are displayed.
na (not active)
All the partner systems which do not have the status ACTIVE are displayed.
d (deactivated)
All the partner systems with the status DEACTIVE are displayed.
ie (installation error)
All the partner systems with the status LUNK, RUNK, LAUTH, RAUTH, NOKEY or IDREJ are displayed.
nc (not connected)
All the partner systems with the status NOCON or DIERR are displayed.
ad (active + automatic deactivation)
All the partner systems for which the option
AUTOMATIC-DEACTIVATION is set (see the option -ad in the ftaddptn and ftmodptn commands) but are still active are displayed.
da (deactivated + automatic deactivation)
All the partner systems which have actually been deactivated because of the AUTOMATIC-DEACTIVATION option are displayed.
-st not specified
The output is not restricted to partner systems with a specific status.
-l | -csv | -px | -pw | -p2 | -pz | -pa
These options determine the scope and format of the output.
-l
The properties of the partner systems are output in full as a table.
-csv
The properties of the partner systems are output in CSV format. The individual values are separated by semicolons.
-px
The properties of the partner systems are output as a command sequence. This can be called in Unix systems as a shell procedure in order to generate partner entries with identical properties.
-pw
The properties of the partner systems are output as a command sequence. This can be called in Windows systems as a batch procedure in order to generate partner entries with identical properties.
-p2
The properties of the partner systems are output as a command sequence. This can be called in BS2000 systems as an SDF procedure in order to generate partner entries with identical properties.
-pz
The properties of the partner systems are output as a command sequence. This can be called in z/OS systems as a CLIST procedure in order to generate partner entries with identical properties.
-pa
Additional address-specific properties of an X.25 partner are output on Linux and Windows systems.
-l, -csv, -px, -pw, -p2, -pz, -pa not specified
If you do not specify any of these options then the partners' properties are output in their abbreviated form.
-kl= | -kl=FTOPT | -kl=0 | 768 | 1024 | 2048 | 3072 | 4096
This operand enables you to display the properties of partner systems which have a specific RSA-PROPOSAL key (-kl). You can specify following values:.
-kl= | -kl=FTOPT
All partner systems with RSA-PROPOSAL set to global option "FTOPT" will be displayed.
-kl=0 | 768 | 1024 | 2048 | 3072 | 4096
All partner systems with RSA-PROPOSAL set to one of partner local RSA key value will be displayed.
If you want to display partners with any RSA-PROPOSAL, then do not set this value.
-klmin= | -klmin=FTOPT | -klmin=0 | 768 | 1024 | 2048 | 3072 | 4096
This operand enables you to display the properties of partner systems which have a specific RSA-MINIMUM key (-klmin). You can specify following values.
-klmin= | -klmin=FTOPT
All partner systems with RSA-MINIMUM set to global option "FTOPT" will be displayed.
-klmin=0 | 768 | 1024 | 2048 | 3072 | 4096
All partner systems with RSA-MINIMUM set to one of partner local RSA key value will be displayed.
If you want to display partners with any RSA-MINIMUM, then do not set this value.