Note on usage
Function: List partner systems
User group: FTAC user and FTAC administrator
Prerequisite for using this command is the use of openFT-AC.
Functional description
The command SHOW-FT-RANGE is used to list the partner systems with which you can communicate by file transfer. In addition to indicating the name of the partner system, the security level is output which the FT administrator assigned to this system in the partner list. To determine which basic functions you are permitted to use, you must use the command SHOW-FT-ADMISSION-SET to obtain information on your admission set.
The FTAC administrator can use SHOW-FT-RANGE to list all partner systems with which his/her FT system can communicate using file transfer. Furthermore, he/she can find out for any user in his/her system which partner systems can be accessed by this user.
Format
SHOW-FT-RANGE |
USER-IDENTIFICATION = *OWN / <name 1..8> ,SELECT-PARAMETER = *ALL / *PARAMETERS(...) *PARAMETERS(...) PARTNER = *ALL / <text 1..200 with-low> ,OUTPUT = *SYSOUT (...) / *SYSLST(...) *SYSOUT (...) / *SYSLST(...) LAYOUT = *STD / *CSV |
Operands
USER-IDENTIFICATION =
User ID for which you would like to have a list of accessible partner systems.
USER-IDENTIFICATION = *OWN
The FTAC user receives all the partner systems with which he/she can use at least one basic function.
The FTAC administrator receives all accessible partner systems.
USER-IDENTIFICATION = <name 1..8>
The FTAC user can only enter his/her own user ID here, the output corresponds to *OWN. The FTAC administrator can enter any user ID for which he/she would like to view the accessible partner systems.
SELECT-PARAMETER =
Specifies selection criteria for the partner systems.
SELECT-PARAMETER = *ALL
Obtains information on all partner systems which can be reached.
SELECT-PARAMETER = *PARAMETERS(PARTNER = <text 1..200 with-low>)
Obtains information on this partner system. You can specify the name from the partner list or the address of the partner system. The following information is supplied:
if you are permitted to communicate with this partner system.
the security level assigned to this partner system.
if no authorization exists for the partner system, FTC0170 is displayed.
For additional information to partner addresses, see section “Specifying partner addresses”.
OUTPUT =
Output medium for the partner system listing.
OUTPUT = *SYSOUT (...)
The list is output on SYSOUT.
OUTPUT = *SYSLST(...)
The list is output on SYSLST.
LAYOUT = *STD
Output is put into a user-friendly form for reading.
LAYOUT = *CSV
Output is in Character Separated Values format. This is a special tabular format, widely used in the PC world, where the individual fields are separated by a semicolon “;“ (see section “SHOW-FT-RANGE”).
Example
Steven Miller would like to find out about the security level of the computer BUYDACK. To do this, he uses the following command:
/SHOW-FT-RANGE SELECT-PARAMETER=(PARTNER=BUYDACK)
Short form:
/SHOW-FT-RANGE SEL=(BUYDACK)
He receives the following output:
|
|
The column SECLEV contains the security level of the partner system whose name appears in the PARTNER-NAME column.
If Steven had entered SELECT-PARAMETER=*ALL (or left out this parameter altogether), he would have received a similar but longer list of all accessible partner systems.
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | 64 | FTC0052 | The output of information was interrupted. |
0 | 0 | FTC0054 | There is no information which meets the specified criteria. |
0 | 64 | FTC0070 | The command cannot be executed on the basis of inadequate |
0 | 64 | FTC0152 | The user ID entered is not the user’s own ID. |
0 | 64 | FTC0170 | The partner entered is unknown within the partner systems |
0 | 64 | FTC0255 | A system error occurred. |
SC1/2 = Subcode 1/2 in decimal notation For additional information, see section “Command return codes”. | |||
OPS variables
Element | Type | Output |
SEC-LEV | Integer | Security level |
PARTNER-NAME | String | Partner name |