Note on usage
Function: Import FTAC admission profiles and sets
User group: FTAC administrator
openFT-AC must be installed to use this command.
This command can be entered under TSO.
Functional description
The FTAC administrator can easily “move” admission profiles and sets when a user migrates from one computer to another. The commands FTEXPENV and FTIMPENV are intended for this purpose. These commands cannot be used by the FTAC user.
All imported admission profiles will be first locked.
This can be seen in the FTSHWPRF command in the specification *LOCKED (by_import). Privileged profiles lose their privileged status when imported. They will also be designated as private.
An admissions profile is otherwise only imported if its name does not exist on the destination ID.
If the target computer already has an admission profile with the same transfer admission and the admission profile is designated as private, both transfer admissions are locked. The transfer admission of the old profile is set to *DUPLICATED and the transfer admission of the imported profile is set to *NOT-SPECIFIED. If the already existing admission profile is designated as ”public”, then it is not locked.
Format
FTIMPENV |
FROM-FILE = <filename 1..46> ,USER-IDENTIFICATION = *ALL / list-poss(100): <name 1..8> ,SELECT-PARAMETER = *ALL / *PARAMETERS(...) *PARAMETERS(...) PROFILE-NAME = *ALL / *NONE / list-poss(100): <alphanum-name 1..8> ,ADMISSION-SET = *YES / *NO ,SECURITY = *STD / *HIGH |
Operands
FROM-FILE = <filename 1..46>
Name of the file from which the admission profiles and sets are to be imported. If the file contains invalid data or if there is an error while accessing the file, the command is rejected with the message FTC0103.
USER-IDENTIFICATION =
User ID whose admission profiles and sets are to be transferred from an export file.
USER-IDENTIFICATION = *ALL
The admission profiles and sets of all users are to be transferred.
USER-IDENTIFICATION = list-poss(100): <name 1..8>
The admission profiles and sets of the users specified (maximum 100) are to be transferred.
SELECT-PARAMETER =
Determines whether only admission profiles, only admission sets, or both are to be imported. For admission profiles, you can specify which are to be imported.
SELECT-PARAMETER = *ALL
All the admission profiles and sets associated with the user ID specified under USER-IDENTIFICATION are to be imported.
SELECT-PARAMETER = *PARAMETERS(...)
Specifies which of the admission profiles and sets associated with the USER-IDENTIFICATION are to be imported.
PROFILE-NAME = *ALL
All admission profiles are to be imported.
PROFILE-NAME = *NONE
No admission profiles are to be imported.
PROFILE-NAME = list-poss(100): <alphanum-name 1..8>
Only the profiles specified are to be imported (maximum 100).
ADMISSION-SET = *YES
All admission sets are to be imported.
ADMISSION-SET = *NO
No admission sets are to be imported.
SECURITY =
An FTAC administrator with system administrator privilege can use this operand to control security.
SECURITY = *STD
For FTAC administrators with SU privilege:
The profile attributes are not altered when imported.
For FTAC administrators not having the SU privilege:
This operand works like the specification *HIGH, i.e. the admissions profiles are locked (locked by import) and retain the attributes USAGE=PRIVATE and PRIVILEGED = NO.
SECURITY = *HIGH
The admissions profiles are locked (locked by import) and retain the attributes USAGE=PRIVATE and PRIVILEGED=NO.
Example
The FTAC administrator wants to import all admission profiles belonging to the user Billy from the external file BILLYPRF. The admission set is not to be imported.
FTIMPENV FROM-FILE=BILLYPRF,USER-ID=BILLY,
SEL=(PROF-NAME=*ALL,ADM-SET=*NO)
If the FTAC administrator possesses the SU privilege then the profiles can be used immediately. Otherwise, Billy must first unlock them with FTMODPRF:
FTMODPRF *ALL,TRANS-ADM=*OLD-ADM(VALID=*YES)