Stat 6.3 - User Guide

Selecting Lock Options

After you select the object(s), you should decide which locking options to use. By default, the objects are set to be locked in all the environments on the migration path, but with proper security rights you can select a different lock option. For more information on object locking, see Object Locking and Reservations (Generic Applications) .

There are four different lock options:

IMPORTANT: When you add an object to a CSR without a lock, Stat does not create a base version for the objects or mark the objects as having been modified. The objects are therefore considered “Undocumented” by the Undocumented Object Wizard.

NOTE: It is recommended that you keep the default lock setting, All on Migration Path. Locking only in the current environment could lead to version inconsistencies if another developer modifies the same object in a different environment.

Adding Objects

After assigning a developer and selecting the object(s) and lock options you want, you are ready to add the objects to your CSR.

While the Stat Central Agent processes the locks, the Archive Sets tab goes into read-only mode and the following occurs:

NOTE: If the message does not go away after certain amount of time this may indicate that the agent encountered a problem or timed out.

For each object, Stat then:

When adding an object, Stat connects to all environments or source file locations on your migration path in order to check for existence. If it finds an object that exists in another environment, but not in the environment that you are working in, it displays a warning message.

Clicking Yes adds the object to the Object List table with a modification status of New. For more information on the Object List table and modification statuses, see CSR Object Documentation (Generic Applications) .

NOTE: You can update the lock status of objects displayed in the Object List table by clicking Refresh. This will show if you any of the reserved objects have since received a lock since the last time you saved the CSR.

When Stat adds the object to the CSR, a row for each environment on the migration path is added to the Object List table. Each row displays information concerning the development, archiving, and migration activity that takes place for that object in that environment.

When the CSR is saved, the Stat Central Agent processes the object locks and determines the modification status of the object.

While the Stat Central Agent processes your object locks, the Objects tab goes into Read Only mode. During this time, if you attempt to perform any actions such as adding more objects or removing existing ones, Stat displays a warning. Once the Stat Central Agent has completed the locking of your objects, the Objects tab returns to edit mode.

Viewing the Lock Status of an Object

From the Objects tab of the CSR window, you can identify which objects you have locked and which objects you have reserved. Stat denotes lock and reserve status in the Flags column of the CSR object list with a lock icon and a clock icon, respectively.

To view all the locks and reservations placed on an object, right-click the object in the Objects tab of the CSR window. In the right-click menu, select View Lock Status. Stat opens the Lock summary window for the object.

NOTE: You can view the status of the Stat Central Agent responsible for processing object locks by opening the Job Monitor window in Stat Web.

This window displays a list of all locks and reservations for the object across all environments. Any reservation or lock for the current CSR is highlighted in yellow. This allows you to see the position of your reservation in the queue.

The window lists locks first, followed by reservations, in chronological order. Each reservation icon is followed by a number indicating its position in the queue. If no locks or reservations exist for the object, Stat opens a window indicating this.

The name listed in the Lock summary window is the developer assigned to the object in the CSR, which may not be the person assigned to the CSR. This depends on your business practices.

Unlocking or Unreserving an Object

To unlock or release a reservation for an object, select it in the Object List, click Unlock, and save the CSR. Do not remove an object after you modify it. If you remove it, it is removed from all archive sets in the CSR and Stat cannot accurately report on changes to the object.

NOTE: All objects associated with a CSR are automatically unlocked when the CSR changes to a closed-type status.

You might unlock an object if you want to release the lock on a particular object but also keep the CSR open. This may occur when another developer needs that object immediately, or when you have many objects locked and have finished working on some of them.

Until the Stat Central Agent unlocks the object, the CSR still has the object locked. It appears in the window that you no longer have the lock, but if another user attempts to lock the object, that user will receive a reservation. The Lock summary window for the object will show that your CSR still has the lock.