Stat 6.3 - User Guide

Associating Objects with CSRs (Generic Applications)

You access and work with objects in a CSR. The CSR becomes the logical grouping of all the affected objects.

Remember that objects are associated with CSRs as opposed to users. In order to lock, archive, or migrate an object, you must first associate it with a CSR. The modifications that you make to objects are still made in the application environment— Stat simply provides tools that manage and track those changes.

You can manually associate objects with a CSR, or you can use two wizards to associate objects en masse. These include:

•

The Read File Wizard, which associates the file objects in a folder

•

The CSR Read Wizard, which associates the objects associated with another CSR

Objects can also be associated with a CSR using the Impact Analysis Wizard and the Undocumented Object Wizard. For more information, see Object Tools and Wizards .

Selecting a Migration Path

In order to associate objects with a CSR, you must specify the environment you want to copy them from. This is done first by selecting a migration path. In Stat, migration paths are logical groupings of environments that serve as road maps for object migrations. They are set up by your system administrator.

Your system administrator creates migration paths based on your business needs. For different situations you have different paths.

To select a migration path:

Open a CSR window and select the Migration Path tab.

In the Select Migration Path field, select the appropriate migration path.

The displayed paths vary, depending on the service domain. You should select the path most suited to your current needs.


	NOTE: If a workflow that specifies a migration path is assigned to the CSR, that path is the default path displayed in the CSR window and cannot be changed. For more information on workflows, see Change/Service Requests . For more information on migration paths, see Running a Migration (Generic Applications) .

In the Select Default Developer field, select a developer.

You can assign different developers to different objects, but this is the person that most of the objects will be assigned to.

(Optional) If you want to associate the CSR with a version control management system (VCM) record, select the record you want in the VCM Repository field

This field is enabled only if your system administrator has defined at least one VCM record in the VCM Connection Maintenance table. It lists all the currently defined VCM records. After you add objects to the CSR, this field is disabled and you cannot select a different VCM record.

Note that if your selected Workflow has a default VCM Repository assigned to it, that VCM Repository will automatically be assigned on the migration path.

Click Generate Path.

Stat displays a graphical representation of the migration path. Also, the Objects and Archive Sets tabs appear.

Each drum represents a generic application environment. Your system administrator determines which environments are designated as Base (Production) and Development. The original, “pre-change” archive of the objects in the CSR is taken from the Base environment. The Development environment is where you change the objects.

After selecting a migration path, select the Objects tab.

Assigning Developers

Before adding the objects to the CSR, you need to decide which Stat user is going to be making the changes to the objects and therefore needs to be assigned the object lock. If the user is the default user in the Assigned To field, then you can just add the objects and the default user will obtain the lock. If another user needs the lock on the objects, select that user from the drop down list in the Assigned To field. When you add the objects, the user in this field is assigned the object locks. See Selecting Lock Options for more information.

Selecting Objects

You can select the objects you want to add to your CSR manually, or you can use the wizards to select groups of objects. The procedure for manually selecting the objects you want to associate with your CSR is slightly different depending on the class of objects.


	IMPORTANT: Workflows can contain status rules that do not allow users to add or lock objects while the CSR is in a restricted status. When this is the case, Stat prevents you from adding or locking objects until the CSR changes to an unrestricted status. Any object reservations that were in place before the CSR was transferred to a restricted status, however, are treated the same, meaning they are converted into locks when the objects become available.

Selecting Data and Schema Objects

To select a data or schema object, first select the generic application environment, then the object type and the object.

To select a data or schema object:

In the CSR window, select the Objects tab.

In the Environment field, select the environment that contains the objects.

Note that any environments on the migration path that have been inactivated are not listed. If you need to select objects from an inactive environment, see your system administrator.

The initial object snapshot, the base archive set, always comes from the Base environment. No matter which database you select in the Environment field, Stat copies the objects from the Base environment. Even if you add objects later, they still come from the Base environment.

Stat gives you this option of environments in order to reduce the number of hits made against your Base, or Production, environment. By selecting another environment, Stat connects to that environment and retrieves the list of objects. Once the objects are selected, the “pre-change” object snapshot is created from the Base environment.

When you select an environment, the Object Type field displays a “Loading...” message. During this time, Stat connects to the selected generic application environment and checks which object types are available.


	TIP: If Stat returns a large number of objects, you can quickly locate the particular object you want by typing the first few letters of the object name in the Quick Filter field. As you type, Stat filters the list of objects so that only objects with matching names are displayed.

In the Object Type field, select the type of object you want.


	NOTE: If you are adding a schema object type, Stat displays the Select Schema Owner window, which prompts you to specify the object’s schema owner. This reduces the amount of time it takes for Stat to return the list of matching objects. The window includes a Quick Filter field which lets you quickly parse the list to the schema owner you want (including Public). Select the owner and click OK.

Stat displays object types sorted by object class. When you select an object type, Stat displays a list showing all available objects of that type.

In the list of objects, select the object(s) you want.

To select multiple objects, hold down the <Shift> or <Ctrl> key as you make your selections.

Selecting File Objects

You can select file objects residing in a generic application environment, the assigned developer’s working directory, or (if configured) a version control management repository.

To select a file object:

In the Environment field, do one of the following:

•

Select an environment if you want Stat to look through that environment’s source file locations to get the list of file names for a particular file type. Source file locations are the file server directories where file objects reside. You or your system administrator can define multiple source file locations for each environment.

•

Select Working Directory if you want to add files that exist in the assigned developer’s working directory but not in any of environments to which Stat has access

•

Select VCM Repository if you have associated the CSR with a VCM record and you want to archive and migrate objects that reside in the VCM repository.

Note that any environments on the migration path that have been inactivated are not listed. If you need to select objects from an inactive environment, see your system administrator.

In the Object Type field, select the type of file you want.

Stat displays a list of all the files that have the matching file extension. No file names are returned if there are no source file locations defined for the selected file type and environment, if no working directory has been defined for the assigned user, or if no matching objects reside in the VCM repository.

(Optional) Select Copy to Working.

If checked, Stat copies the files from the Base environment to your working directory after adding them to the CSR.


	NOTE: This option is selected by default if Copy Files to Working is selected in the Stat User Options window. For information on user-defined working directories, see Defining Working Directories for File Objects .