IBM FileNet P8, Version 5.2.1            

usralias

The usralias command lists the previous short name that was used for a user or group name. If a user or group name is changed during a workflow process, the previous short name is saved so that the workflow can associate the current short name with the original short name. This association ensures that the workflow is not interrupted or terminated because of a short name change.

You can delete an alias or all aliases, not short names. Deleting an alias would be necessary if a new user is added to the security back-end system and the short name matches an existing alias in the workflow system. In this case, the system administrator must check if the new user can be renamed in the security back-end system or if it is safe to delete the matching alias after resolving associated references.

Syntax

usralias option

Parameters

Table 1. Parameters and description for the usralias command
Parameter Description
option Type one of the following options at the vwtool command-line prompt:
l
Lists the previous short names (aliases) that were used in workflows and work items.
d short name
Deletes the specified aliases from all of the servers in a farm.

Example

The following example shows how to list the aliases for short names. In this example, the first record states that an old name intg_admin_new2 exists and was created on 05/04/2012. This old name is currently associated with a user identified by ID 2351.

<vwtool:1>usralias
Shortname change support
    l - List aliases
    d - Delete alias
Choice? ('l', 'd'): l
---------------------------Fri, 11 May 2012 10:04:20---------------------------
Old Name:      intg_admin_new2
Id:                   2351
CreateDate:    05/04/2012 18:54:42
LastAccess:    05/07/2012 09:54:31
---------------------------Fri, 11 May 2012 10:04:20---------------------------
Old Name:      testgroup2
Id:                   2550
CreateDate:    05/10/2012 14:01:16
LastAccess:    05/10/2012 14:02:17
---------------------------Fri, 11 May 2012 10:04:20---------------------------
Old Name:      testgroup_new2
Id:                   2452
CreateDate:    05/10/2012 13:40:21
LastAccess:    05/10/2012 13:40:21

Records total: 3.

You can delete an alias or all aliases. The following is an example of deleting an alias:

<vwtool:1>usralias
Shortname change support
    l - List aliases
    d - Delete alias
Choice? ('l', 'd'): d
Enter alias to delete (* to delete all): intg_admin_new2
This operation CANNOT be reverted.
Are you sure you want to delete user alias/history record(s)? (y/CR=n): y

    WARNING: If there are still work objects associated with a deleted alias,
             those work objects will be unresolved.
Are you SURE you want to continue? (Yes/No):Yes
User Alias record for intg_admin_new2 is deleted.

<vwtool:1>


<vwtool:1>usralias
Shortname change support
    l - List aliases
    d - Delete alias
Choice? ('l', 'd'): l
---------------------------Fri, 11 May 2012 10:06:01---------------------------
Old Name:      testgroup2
Id:                   2550
CreateDate:    05/10/2012 14:01:16
LastAccess:    05/10/2012 14:02:17
---------------------------Fri, 11 May 2012 10:06:01---------------------------
Old Name:      testgroup_new2
Id:                   2452
CreateDate:    05/10/2012 13:40:21
LastAccess:    05/10/2012 13:40:21

Records total: 2.


Last updated: October 2015
bpfvl058.htm

© Copyright IBM Corporation 2015.