The command SHOW-FT-ADMISSION-SET is used to view admission sets. You can optionally have the following information output to SYSOUT or SYSLST:
whether the admission set is privileged (if it is, then you are the FTAC administrator).
whether a password is required to use FTAC commands on this user ID. The password itself is not displayed.
the limiting values that were set by the owner of this user ID for the accessible security levels.
the limiting values that were preset by the FTAC administrator for the accessible security levels.
If you call HELP for the SDF command syntax shown below, you may also see some operands that are not indicated here. This is because only the operands relevant for FTP are described in this section.
SHOW-FT-ADMISSION-SET - showing operands relevant for FTP |
USER-IDENTIFICATION = *OWN / *ALL / *STD / <alphanum-name 1...8> , OUTPUT = *SYSOUT (LAYOUT = *STD / *CSV ) / *SYSLST (LAYOUT = *STD / *CSV) |
Operands
USER-IDENTIFICATION=
The user ID for which you want to view the admission set. FTAC users can only obtaininformation on their own admission sets and the default admission set.
USER-IDENTIFICATION=*OWN
FTAC shows the admission set of your own user ID.
USER-IDENTIFICATION=*ALL
FTAC shows the default admission set and the admission set of your own user ID.
USER-IDENTIFICATION=*STD
FTAC only shows the default admission set.
USER-IDENTIFICATION=<alphanum-name 1..8>
FTAC shows the admission set for this user ID. The operand stands for the USER-ID of the specified user ID. FTAC users may only enter their own user IDs here.
OUTPUT=
Determines the output medium for the information requested.
OUTPUT=*SYSOUT(...)
The output is sent to SYSOUT.
OUTPUT=*SYSLST(...)
The output is sent to SYSLST.
LAYOUT=*STD
The output is formatted using a standard layout that can be easily read by the user.
LAYOUT=*CSV
The output is supplied in CSV (Comma Separated Value) 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 “;”.
Example
Dagobert Duck, the FTAC administrator of the Duck Bank, wants to obtain information on the admission sets in his system. He enters the command
/SHOW-FT-ADMISSION-SET USER-IDENTIFICATION=*ALL
Short form:
/SHOW-FT-AD *ALL
and receives the following output:
% MAX. USER LEVELS MAX. ADM LEVELS ATTR % USER-ID OBS OBR IBS IBR IBP IBF OBS OBR IBS IBR IBP IBF % *STD 10 10 100 100 0 0 10 10 100 100 0 0 % DAGOBERT 100 100 0 99 0* 0* 100 100 0 99 0* 0* PRIV % DAISY 50 50 99 100 50 50 50 50 100 100 50 50 PW % DANIEL 0 10 99 99 0 0 10 10 100 100 0 0 PW % DONALD 50 100 99 100* 0 0 50 100 100 100 0 0
These can be explained as follows:
The user ID of each admission set is in the column USER-ID. In this example, there is a default admission set as well as admission sets for the user IDs DAGOBERT, DAISY, DANIEL and DONALD.
The ATTR column shows the privileged admission set. We can see that DAGOBERT is the FTAC administrator.
The ATTR column also indicates whether an FTAC password has been defined (with PW). DAGOBERT, DAISY and DANIEL have done this to prevent others from issuing any FTAC commands on their user ID that could result in changes.
The six columns under MAX-USER-LEVELS show the limiting values which the FTAC users have set for their admission sets. The six columns under MAX-ADM-LEVELS show the
limiting values set by the FTAC administrator. The smaller of the two values indicates up to which security level the owner of the admission set may use each basic function. The basic functions are abbreviated in the output as follows:
IBS IBR IBP IBF | = INBOUND-SEND = INBOUND-RECEIVE = INBOUND-PROCESSING = INBOUND-FILEMANAGEMENT |
To begin with, it must be observed that FTP users (regardless of the security level assigned to their system) always receive a security level specified by the system administrator or the default security level of 100.
The default admission set has been set up to permit FTP users to send files to the FTP server and to retrieve files from the FTP server, but not to perform any file management actions.
DAGOBERT does not permit any file transfer accesses from outside under his user ID (IBS=0, IBR=99, IBP=0).
The files of the user ID DAISY may not be read using FTP (IBS=99), but files may betransferred to this user ID (IBR=100). The user ID DANIEL cannot be accessed with FTP (IBS, IBR and IBF are less than 100).
Command return codes
(SC2) | SC1 | Maincode | Meaning |
| 0 | 64 | FTC0052 | The information output was interrupted. |
| 0 | 64 | FTC0152 | The user ID entered is not the user's own ID. |
| 0 | 64 | FTC0181 | The entered FT profile name occurs several times. |
| 0 | 64 | FTC0255 | A system error occurred. |
SC1/2 = Subcode 1/2 in decimal form
More information can be found in the manual “openFT - Command Interface”.