Note on usage
Function: Display saved admission profiles and sets
User group: FTAC administrator
openFT-AC must be installed to use this command.
Functional description
The FTAC administrator can use the command SHOW-FTAC-ENVIRONMENT to view admission profiles and sets which have been written in an export file using the command EXPORT-FTAC-ENVIRONMENT. This function is particularly useful before the importing of the admission profiles and sets (see IMPORT-FTAC-ENVIRONMENT).
Format
SHOW-FTAC-ENVIRONMENT |
FROM-FILE = <filename 1..54> ,USER-IDENTIFICATION = *ALL / list-poss(100): <name 1..8> ,SELECT-PARAMETER = *ALL / *PARAMETERS(...) *PARAMETERS(...) PROFILE-NAME = *ALL / *NONE / *STD / list-poss(100): <alphanum-name 1..8> ,ADMISSION-SET = *YES / *NO ,INFORMATION = *ONLY -NAMES / *ALL ,OUTPUT = *SYSOUT (...) / *SYSLST(...) *SYSOUT (...) / *SYSLST(...) LAYOUT = *STD / *CSV |
Operands
FROM-FILE = <filename 1..54>
Name of the file (not a temporary file) from which the admission profiles and sets are to be displayed. If the file contains invalid data or access to the file is unsuccessful, the command is rejected with the message FTC0103.
USER-IDENTIFICATION =
User ID whose admission profiles and sets are to be displayed.
USER-IDENTIFICATION = *ALL
The admission profiles and sets of all users are to be displayed.
USER-IDENTIFICATION = list-poss(100): <name 1..8>
The admission profiles and sets of the user IDs specified (maximum 100) are to be displayed.
SELECT-PARAMETER =
Specifies whether only admission profiles, only admission sets or both are to be displayed. For the admission profiles, you can specify which ones are to be displayed.
SELECT-PARAMETER = *ALL
All admission profiles and sets associated with the user ID specified under USER-IDENTIFICATION are to be output on file.
SELECT-PARAMETER = *PARAMETERS(...)
Specifies which of the admission sets associated with the USER-IDENTIFICATION are to be specified.
PROFILE-NAME = *ALL
All admission profiles are displayed.
PROFILE-NAME = *NONE
No admission profiles are displayed.
PROFILE-NAME = *STD
Displays the standard admission profile.
PROFILE-NAME = list-poss(100): <alphanum-name 1..8>
Only the specified profiles are displayed (maximum 100).
ADMISSION-SET = *YES
All admission sets are displayed.
ADMISSION-SET = *NO
No admission sets are displayed.
INFORMATION =
Scope of the information to be displayed.
INFORMATION = *ONLY-NAMES
Only the names of the admission profiles are to be displayed.
INFORMATION = *ALL
The entire contents of the admission profiles, excluding any passwords and transfer admissions, are displayed.
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-FTAC-ENVIRONMENT”).
Example
The FTAC administrator Jack John backs up the admission set and the admission profiles of the user ID STEVEN in the file STEVEN.FTAC.BKUP.
/EXPORT-FTAC-ENVIRONMENT TO-FILE=STEVEN.FTAC.BKUP,
USER-IDENTIFICATION=STEVEN
A possible short form of this command would be:
/EXP-FTAC-ENV STEVEN.FTAC.BKUP,STEVEN
As a conscientious FTAC administrator, Jack checks if the desired back-up is in the file STEVEN.FTAC.BKUP
/SHOW-FTAC-ENVIRONMENT FROM-FILE=STEVEN.FTAC.BKUP
He receives the following output:
|
USER-ID and OWNER can be used to determine the user ID with which the admission sets and profiles defined under NAME are associated.
In addition, the maximum security levels set for each user are displayed, as in the command SHOW-FT-ADMISSION-SET. An explanation of these entries can be found in the section for this command (see section Output of SHOW-FT-ADMISSION-SET).
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | 0 | FTC0054 | No information exists which meets the specified criteria. |
0 | 64 | FTC0103 | The file is not an FTAC export file or access is not permitted. |
0 | 64 | FTC0104 | Access to the user ID denied or the user ID doesn’t exist. |
0 | 64 | FTC0105 | Access to the file denied. |
0 | 64 | FTC0106 | Access to the temporary file denied. |
0 | 64 | FTC0156 | The command may only be issued by the FTAC administrator. |
0 | 64 | FTC0177 | The filename entered is unknown. |
0 | 64 | FTC0180 | The USER-ID entered occurs several times. |
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 OPS variables of the displayed objects correspond to the variables of the commands SHOW-FT-ADMISSION-SET and SHOW-FT-PROFILE.