IMPORT-FTAC-ENVIRONMENT

Note on usage

Function: Import FTAC admission profiles and sets

User group: FTAC administrator

openFT-AC must be installed to use this command.

Functional description

The FTAC administrator can easily “move” admission profiles and sets when a user migrates from one computer to another. The commands EXPORT-FTAC-ENVIRONMENT and IMPORT-FTAC-ENVIRONMENT are intended for this purpose. These commands cannot be used by the FTAC user.
If the FTAC administrator does not possess TSOS privileges then all imported admission profiles will be locked.
This can be seen in the SHOW-FT-PROFILE command in the specification *LOCKED (by_import). Privileged profiles lose their privileged status when imported. They will also be designated as private.

These restrictions are not valid by default, if the FTAC administrator also has the TSOS privilege. In this case, profiles are imported unlocked and privileges are retained. If that is not desirable due to security concerns, the FTAC administrator can force locking by specifying the SECURITY=HIGH parameter.

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

IMPORT-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 / list-poss(100): <alphanum-name 1..8>

,ADMISSION-SET = *YES / *NO

,SECURITY = *STD / *HIGH

Operands

FROM-FILE = <filename 1..54>

Name of the file from which the admission profiles and sets are to be imported. Temporary files may not be used. 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 TSOS privilege can use this operand to control security.

SECURITY = *STD
For FTAC administrators with TSOS privilege:
The profile attributes are not altered when imported.

For FTAC administrators not having the TSOS 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.

Command return codes

(SC2)	SC1	Maincode	Meaning
0	64	FTC0052	The information output was interrupted.
0	0	FTC0054	No information matches the specified criteria.
0	0	FTC0056	The transfer admission is locked.
0	64	FTC0100	An FT profile with the specified name already exists.
0	64	FTC0101	An FT profile with the specified transfer admission already exists.
0	64	FTC0103	The file is not an FTAC export file or access is denied.
0	64	FTC0104	Access to the user ID denied or the ID does not exist.
0	64	FTC0105	Access to the file denied.
0	64	FTC0106	Access to the temporary file denied.
0	64	FTC0156	The command can only be executed by the FTAC administrator.
0	64	FTC0177	The filename entered is unknown.
0	64	FTC0180	The USER-ID entered occurs several times.
0	64	FTC0181	The FT profile name 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”.