FTSHWPRF

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 FTSHWPRF, 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 FTSHWPRF to access passwords or transfer admissions defined in the profile! If a transfer admission is forgotten, a new one must be specified using FTMODPRF.

Format

FTSHWPRF

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>

,OWNER-IDENTIFICATION = *OWN / *ALL / <name 1..8>

,INFORMATION = *ONLY -NAMES / *ALL

,OUTPUT = *STDERR (...) / *STDOUT(...)

*STDERR (...) / *STDOUT(...)

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.

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.

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.
In the case of a blocked admission profile (marked with an "!" when output with INFORMATION=*ONLY-NAMES), the following values can appear in TRANS-ADM:

TRANS-ADM=	Meaning
(NOT-SPECIFIED)	No TRANSFER-ADMISSION specified in the admission profile.
(DUPLICATED)	The admission profile was blocked because the TRANSFER- ADMISSION was "detected" by another user and the profile was to be blocked in that case (USAGE=*PRIVATE is specified in the command FTCREPRF or FTMODPRF). "Detected" means that another user ID tried to assign the same TRANS- FER-ADMISSION over again.
(LOCKED(by_user))	The admission profile was specifically blocked by the user (VAL- ID=*NO was specified in the command FTCREPRF or FTMOD- PRF).
(LOCKED(by_adm))	The admission profile was specifically blocked by the FTAC administrator (VALID=*NO was specified in the command FT- CREPRF or FTMODPRF).
(EXPIRED)	The validity of TRANSFER-ADMISSION has expired (EXPIRA- TION-DATE was specified in command FTCREPRF or FT- MODPRF).

OUTPUT =
Output medium for the information.

OUTPUT = *STDERR (...)
Output is performed to SYSTSPRT or to SYSERR if this DDNAME is defined.

OUTPUT = *STDOUT(...)
Output is performed to SYSPRINT.

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 “FTSHWPRF”).