Note on usage
Function: Display admission profile
User group: FTAC user and FTAC administrator
Prerequisite for using this command is the use of openFT-AC.
Functional description
With the command SHOW-FT-PROFILE, FTAC users can obtain information about their admission profiles. The FTAC administrator can obtain information about all the admission profiles in his/her system.
Either the contents of the selected admission profile or only its name can be output. It is not possible to use SHOW-FT-PROFILE to access passwords or transfer admissions defined in the profile! If a transfer admission is forgotten, a new one must be specified using MODIFY-FT-PROFILE.
Format
SHOW-FT-PROFILE |
NAME = *ALL / <alphanum-name 1..8> / *STD ,SELECT-PARAMETER = *OWN / *PARAMETERS(...) *PARAMETERS(...) TRANSFER-ADMISSION = *ALL / *NOT-SPECIFIED / <alphanum-name 8..32> / <c-string 8..32 with-low> / <x-string 15..64> / *SECRET ,OWNER-IDENTIFICATION = *OWN / *ALL / <name 1..8> ,INFORMATION = *ONLY -NAMES / *ALL ,OUTPUT = *SYSOUT (...) / *SYSLST(...) *SYSOUT (...) / *SYSLST(...) LAYOUT = *STD / *CSV |
Operands
NAME =
Name of the admission profile you wish to view.
NAME = *ALL
Views all admission profiles.
NAME = <alphanum-name 1..8>
Views the admission profile with the specified name.
NAME = *STD
Displays the standard admission profile for your own user ID.
SELECT-PARAMETER =
Selection criteria for the admission profiles you wish to view.
SELECT-PARAMETER = *OWN
Views all the admission profiles of which you are the owner. This means that you can view all the admission profiles which are assigned to your user ID.
SELECT-PARAMETER = *PARAMETERS(...)
Selection criteria with which you can access your admission profiles.
TRANSFER-ADMISSION =
Transfer admission defined in an admission profile as a selection criterion. Only the FTAC administrator can enter the transfer admission of other users.
TRANSFER-ADMISSION = *ALL
The transfer admission is not used as a selection criterion.
TRANSFER-ADMISSION = *NOT-SPECIFIED
Only admission profiles for which no transfer admission has been specified are displayed.
TRANSFER-ADMISSION = <alphanum-name 8..32> / <c-string 8..32 with-low> / <x-string 15..64>
Views the admission profile which can be addressed with this transfer admission.
TRANSFER-ADMISSION = *SECRET
The system prompts you to enter the transfer admission. However, this does not appear on the screen.
OWNER-IDENTIFICATION =
Specifies, whose admission profiles you wish to view.
OWNER-IDENTIFICATION = *OWN
Views only your own admission profile.
OWNER-IDENTIFICATION = *ALL
The FTAC administrator can view all admission profiles, regardless of who the owner is.
OWNER-IDENTIFICATION = <name 1..8>
The FTAC user can only access his/her own admission profiles; the output corresponds to *OWN. The FTAC administrator can view the admission profiles of any FTAC user with this parameter.
INFORMATION =
Scope of information desired.
INFORMATION = *ONLY-NAMES
FTAC only outputs the name of the admission profile and indicates whether it is privileged or locked. An “∗“ is output for privileged profiles and a “!“ for locked profiles.
INFORMATION = *ALL
FTAC outputs the contents of the admission profile, excluding any passwords and the transfer admission.
OUTPUT =
Output medium for the information.
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-PROFILE”).
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | 64 | FTC0052 | The information output was interrupted. |
0 | 64 | FTC0053 | No FT profile exists which meets the specified criteria. |
0 | 0 | FTC0054 | No information exists for the specified criteria. |
0 | 64 | FTC0153 | The owner identification entered is not the user’s own ID. |
0 | 64 | FTC0171 | The profile entered does not exist. |
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
The following table shows the OPS variables of the SHOW-FT-PROFILE command with the operand INF=*ALL. The underlined values apply to the output with INF=*ONLY-NAMES.
Element | Type | Output |
PROF-NAME | String | |
PRIV | String | *YES / *NO |
TRANS-ADM | String | *NSPEC / *SECRET |
DUPLICATED | String | *YES / *NO |
LOCKED-BY | Struct | |
.IMPORT | String | *YES / *NO |
.ADM | String | *YES / *NO |
.USER | String | *YES / *NO |
EXPIRED | String | *YES / *NO |
USER-ADM | Struct | |
.USER-ID | String | User-ID |
.ACC | String | Account number / *FIRST / *NSPEC / *NONE / |
.PASSWORD | String | *OWN / *NSPEC / *NONE / *YES |
EXP-DATE | String | yyyy-mm-dd / *NRES |
USAGE | String | *PUBLIC / *PRIVATE / *NSPEC |
IGNORE | Struct | |
.OBS | String | *YES / *NO |
.OBR | String | *YES / *NO |
.IBS | String | *YES / *NO |
.IBR | String | *YES / *NO |
.IBP | String | *YES / *NO |
.IBF | String | *YES / *NO |
INITIATOR | String | *LOC / *REM / *NRES |
TRANS-DIR | String | *FROM / *TO / *NRES |
MAX-PART-LEV | String | Maximum security level / *NRES |
PARTNERS | Array (1-50) | One or several partners / *NRES |
FILE-NAME | String | File name / *NRES |
LIBRARY | String | *YES / *NO / *NRES / Library |
FILE-NAME-PREFIX | String | *YES / *NO |
ELEM | Struct | |
.NAME | String | Name / *NRES / *NONE |
.PREFIX | String | *YES / *NO |
.VERSION | String | Version / *STD / *NONE / *NRES |
.TYPE | String | Type / *NRES / *NONE |
FILE-PASSWORD | String | *YES / *NRES / *NONE |
WRITE | String | *NEW / *EXT / *REPL / *NRES |
PROC-ADM | Struct | |
.USER-ID | String | User-ID / *NRES / *SAME |
.ACC | String | Account number / *NRES / *SAME / *NONE |
.PASSWORD | String | *NONE / *YES / *NRES / *SAME |
SUCC | Struct | |
.PROC | String | Commands / *NONE / *NRES / *EXPANSION |
.PREFIX | String | Prefix / *NONE |
.SUFFIX | String | Suffix / *NONE |
FAIL | Struct | |
.PROC | String | Commands / *NONE / *NRES / *EXPANSION |
.PREFIX | String | Prefix / *NONE |
.SUFFIX | String | Suffix / *NONE |
TRANS-FILE | String | *ALLOWED / *NOT-ALLOWED |
MOD-FILE-ATTR | String | *ALLOWED / *NOT-ALLOWED |
READ-DIR | String | *ALLOWED / *NOT-ALLOWED |
FILE-PRO^C | String | *ALLOWED / *NOT-ALLOWED |
ACC-ADM | String | *ALLOWED / *NOT-ALLOWED |
REM-ADM | String | *ALLOWED / *NOT-ALLOWED |
ADM-TRAP-LOG | String | *ALLOWED / *NOT-ALLOWED |
TEXT | String | Text / *NONE |
DATA-ENC | String | *YES / *NO / *NRES |
LAST-MOD | Struct | |
.DATE | String | yyyy-mm-dd / *NONE |
.TIME | String | hh:mm:ss / *NONE |