Application Service Guide > PowerCenter Repository Management > Managing User Connections and Locks
  

Managing User Connections and Locks

You can use the Administrator tool to manage user connections and locks and perform the following tasks:

Viewing Locks

You can view locks and identify residual locks in the Administrator tool.
    1. In the Administrator tool, click the Manage tab > Services and Nodes view.
    2. In the Domain Navigator, select the PowerCenter Repository Service with the locks that you want to view.
    3. In the contents panel, click the Connections & Locks view.
    4. In the details panel, click the Locks view.
    The following table describes the object lock information:
    Column Name
    Description
    Server Thread ID
    Identification number assigned to the repository connection.
    Folder
    Folder in which the locked object is saved.
    Object Type
    Type of object, such as folder, version, mapping, or source.
    Object Name
    Name of the locked object.
    Lock Type
    Type of lock: in-use, write-intent, or execute.
    Lock Name
    Name assigned to the lock.

Viewing User Connections

You can view user connection details in the Administrator tool. You might want to view user connections to verify all users are disconnected before you disable the PowerCenter Repository Service.
To view user connection details:
    1. In the Administrator tool, click the Manage tab > Services and Nodes view.
    2. In the Domain Navigator, select the PowerCenter Repository Service with the locks that you want to view.
    3. In the contents panel, click the Connections & Locks view.
    4. In the details panel, click the Properties view.
    The following table describes the user connection information:
    Property
    Description
    Connection ID
    Identification number assigned to the repository connection.
    Status
    Connection status.
    Username
    User name associated with the connection.
    Security Domain
    Security domain of the user.
    Application
    Repository client associated with the connection.
    Service
    Service that connects to the PowerCenter Repository Service.
    Host Name
    Name of the machine running the application.
    Host Address
    IP address for the host machine.
    Host Port
    Port number of the machine hosting the repository client used to communicate with the repository.
    Process ID
    Identifier assigned to the PowerCenter Repository Service process.
    Login Time
    Time when the user connected to the repository.
    Last Active Time
    Time of the last metadata transaction between the repository client and the repository.

Closing User Connections and Releasing Locks

Sometimes, the PowerCenter Repository Service does not immediately disconnect a user from the repository. The repository has a residual connection when the repository client or machine is shut down but the connection remains in the repository. This can happen in the following situations:
A residual repository connection also retains all repository locks associated with the connection. If an object or folder is locked when one of these events occurs, the repository does not release the lock. This lock is called a residual lock.
If a system or network problem causes a repository client to lose connectivity to the repository, the PowerCenter Repository Service detects and closes the residual connection. When the PowerCenter Repository Service closes the connection, it also releases all repository locks associated with the connection.
A PowerCenter Integration Service may have multiple connections open to the repository. If you close one PowerCenter Integration Service connection to the repository, you close all connections for that service.
Important: Closing an active connection can cause repository inconsistencies. Close residual connections only.
To close a connection and release locks:
    1. In the Administrator tool, click the Manage tab > Services and Nodes view.
    2. In the Domain Navigator, select the PowerCenter Repository Service with the connection you want to close.
    3. In the contents panel, click the Connections & Locks view.
    4. In the contents panel, select a connection.
    The details panel displays connection properties in the properties view and locks in the locks view.
    5. In the Manage tab Actions menu, select Delete User Connection.
    The Delete Selected Connection dialog box appears.
    6. Enter a user name, password, and security domain.
    You can enter the login information associated with a particular connection, or you can enter the login information for the user who manages the PowerCenter Repository Service.
    The Security Domain field appears when the Informatica domain contains an LAP security domain.
    7. Click OK.
The PowerCenter Repository Service closes connections and releases all locks associated with the connections.