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 FTSHWENV to view admission profiles and sets which have been written in an export file using the command FTEXPENV. This function is particularly useful before the importing of the admission profiles and sets (see FTIMPENV).
Format
FTSHWENV |
FROM-FILE = <filename 1..46> ,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 = *STDERR (...) / *STDOUT(...) *STDERR (...) / *STDOUT(...) LAYOUT = *STD / *CSV |
Operands
FROM-FILE = <filename 1..46>
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 = *STDERR(...)
Output is performed to SYSTSPRT or to SYSERR if this DDNAME is defined. If the command is called with ftexec from a Unix or Windows system, ftexec sends the output to stderr.
OUTPUT = *STDOUT(...)
Output is performed to SYSPRINT. If the command is called with ftexec from a Unix or Windows system, ftexec sends the output to stdout.
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 “FTSHWENV”).
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.
FTEXPENV TO-FILE=STEVEN.FTAC.BKUP,USER-IDENTIFICATION=STEVEN
A possible short form of this command would be:
FTEXPENV STEVEN.FTAC.BKUP,STEVEN
As a conscientious FTAC administrator, Jack checks if the desired back-up is in the file STEVEN.FTAC.BKUP
FTSHWENV 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 FTSHWADS. An explanation of these entries can be found in the section for this command (see section Output of FTSHWADS).