AddUserProfile

The AddUserProfile command action is used to add a server credential definition to the TIBCO MFT Command Center system.

No command line actions are provided to add definitions to banks.

The user profile definition contains user ID and password information that is used when communicating with the remote Platform Server system.

When a transfer is attempted to target TIBCO MFT Platform Server, TIBCO MFT Command Center searches the server credential database for a match on the user or group that is requesting the transfer and the target server definition. If a match can be found, TIBCO MFT Command Center extracts the remote user ID, remote password, and remote domain. This information is them sent to the remote Platform Server system.

The advantage of using server credential definitions is that you can define all logon information in a single place. Different users can be given different logon information.

The server credential overrides the default user and default password definitions defined on the transfer and server records.

To use the AddUserProfile action command, you must have UpdateServerCredentialRight. For more information on this right, see AddUserToRole.

In the following table, parameters for this command are provided in alphabetical order.
Note: The parameters provided in this table are also used for the UpdateUserProfile command.
Parameter Description Default Required
GroupId Specifies the 1 to 64 character TIBCO MFT Command Center group ID that has been defined in the group database.

If the defined group is not in the group database, the request will fail.

This parameter is exclusive with the UserId parameter.

When a transfer is done, TIBCO MFT Command Center will check all of the groups that a user is a member of to determine whether a match can be found in the user profile database.

The advantage of defining a group ID user profile is that you can use a single user profile record to define user IDs and passwords for many users.

Note: If user profiles are defined for both the GroupId and UserId parameters for a user performing a file transfer, the user ID definition will be used first.
None Either the GroupId or UserId parameter must be defined.
NodeName Specifies the 1 to 32 character TIBCO MFT Command Center server name that has been defined in the server database.

This parameter defines the target Platform Server definition for a file transfer.

If the defined server is not in the server database, the request will fail.

None Yes
RemotePassword Specifies the 1 to 32 character remote Platform Server password.

This parameter defines the password that will be sent to the target Platform Server system when the file transfer is performed. This password must be valid on the target Platform Server system, or the file transfer request will fail.

The target Platform Server system will validate the RemoteUserId parameter along with the RemotePassword parameter to make sure that it is valid.

On some systems, such as UNIX and Windows, this parameter is case sensitive. On some other systems, such as z/OS and AS/400, this parameter is not case sensitive.

None Yes
RemoteUserId Specifies the 1 to 32 character remote Platform Server user ID.

This parameter defines the user ID that will be sent to the target Platform Server system when the file transfer is performed. This user ID must be defined on the target Platform Server system, or the file transfer request will fail.

The target Platform Server system will validate the RemoteUserId parameter along with the RemotePassword parameter to insure that it is valid.

On some systems, such as UNIX, this parameter is case sensitive. On some other systems, such as z/OS, AS/400, and Windows, it is not case sensitive.

None Yes
RemoteUserWinDomain Specifies the 1 to 256 character remote Platform Server Windows domain.

This parameter is only used when the target Platform Server system runs on Windows platforms. This parameter is ignored for all other platforms.

This parameter defines the domain where the remote user ID is defined. If this parameter is not defined, or is defined incorrectly, the user ID and password validation on TIBCO MFT Platform Server for Windows will fail.

None No
UserId Specifies the 1 to 64 character ID to be assigned to this user.

The user ID cannot contain embedded spaces.

If the defined user is not in the user database, the request will fail.

This parameter is exclusive with the GroupId parameter.

This parameter references the client user ID that is performing the file transfer request.

None Either the GroupId or UserId parameter must be defined.

Sample AddUserProfile Command

This command adds a user profile. That user profile is used when the user mftuser1 is communicating with the NYNode1 node. When TIBCO MFT Command Center communicates with TIBCO MFT Platform Server, it will pass the defined RemoteUserId, RemotePassword, and RemoteUserWinDomain parameters to the target Platform Server system.

java cfcc.CFAdmin a:AddUserProfile UserId:mftuser1 NodeName:NYNode1 RemoteUserId:NYUser1 RemotePassword:NYPassword RemoteUserWinDomain:NYWinDomain