Note on usage
Function: Import profiles and admission sets
User group: FTAC administrator
Functional description
ftimpe stands for "import environment", i.e. importing the FTAC environment or importing FT profiles and admission sets. Using ftimpe, the FTAC administrator can import the FT profiles and admission sets of any login names from a file that was created using the ftexpe command.
Only those FT profiles whose profile names have not been specified for other FT profiles under the specified login name are imported.
If a profile with the same name is already present, the timestamp (LAST-MODIF with ftshwp -l) indicates which has the most recent status.
An FT profile whose transfer admission has already been defined for another FT profile in the system will be imported, but has an undefined transfer admission. It must therefore be assigned a new transfer admission using the ftmodp command before it is used. If the existing FT profile in the system is designated as private, it is immediately disabled. It must be assigned a new transfer admission using the ftmodp command, before it is used.
The imported FT profiles are automatically locked and must be unlocked before use with the command ftmodp and the parameter -v=y if the FTAC administrator does not have FT administrator privileges. Privileged FT profiles lose their privileged status when imported. The FTAC administrator can control this behavior with the -sec option provided that he has FT administrator privileges.
The standard admission set is not saved when it is exported. Therefore, the standard admission set on the computer at the time of importing remains valid. Variable values in the imported admission sets, that refer to the standard admission set and are therefore marked with an asterisk (*), are assigned the value of the standard admission set that is currently valid.
Format
ftimpe -h |
<file name>
[ -u=<user ID>[,...,<user ID(100)>] ]
[ -pr=<profile name 1..8>[,...,<profile name(100) 1..8>] | -pr=@n ]
[ -as=y | -as=n ]
[ -sec=s | -sec=h ]
[ -adm=y | -adm=n ]
Description
-h
Displays the command syntax on the screen. Entries after the -h are ignored.
file name
file name specifies the file from which the FT profiles and admission sets are to be imported.
-u=user ID1[,user ID2][,user ID3]...
specifies the login names whose FT profiles and admission sets are to be imported. You can specify up to 100 login names simultaneously.
-u not specified
all FT profiles and admission sets are imported.
-pr=profile name1[,profile name2][,profile name3]...| -pr=@n
specifies the FT profiles to be imported (up to 100).
@n for profile name
no FT profiles are imported.
-pr not specified
all FT profiles belonging to the login names specified in the -u parameter are imported. However, the profile is not imported if another FT profile of the same name already exists under this login name.
as=y | -as=n
specifies whether or not admission sets are to be imported. Possible values are:
y (default value)
all admission sets belonging to the login names specified in the -u parameter are imported.
n
no admission sets are imported.
-sec=s | -sec=h
-sec specifies the security level when importing FT profiles. It only makes sense to use the -sec option if you, the FTAC administrator, have FT administrator privileges.
s (standard)
If you have FT administrator privileges, the attributes of the FT profile are not changed when it is imported.
If you do not have FT administrator privileges, the effect is the same as -sec=h, i.e. the profiles are locked.
-sec=s is the default value.
h (high)
The FT profiles are locked (LOCKED (by import)) and are assigned the attributes private and not privileged.
-adm=y | -adm=n
specifies whether or not the ADM profiles (i.e. FT profiles with the property "access to remote administration server", corresponding to ftcrep -ff=c) are to be imported. Possible values are:
y (default value)
all ADM profiles are imported. This option is permissible only if an ADM administrator is configured on the target computer.
n
no ADM profiles are imported.
Example
The admission set and FT profiles of the login name donald were saved to the file ftacsave with ftexpe. They are to be imported to another system under the same login name.
ftimpe ftacsave -u=donald
As the FTAC administrator you may receive the following messages, for example:
OWNER NAME
donald secret1 FT profile already exists.
secret2
These messages indicate that donald has already created the FT profiles secret1 and secret2 on the new system, and these profiles were therefore not imported.
Note
If, after import, you wish to delete an admission set for a login name that does not exist on your computer, enter the command ftmoda login-name -ml=s. This situation can occur when you use ftexpe to incorporate into your system a file that has been created on a different host.