IBM SC34-4499-03 Getting parts from TeamConnection, Your workstations current working directory

Getting parts from TeamConnection

Checking out a part implies that you intend to modify it; extracting a part merely gives you a copy of the part. Normally, when you extract a part, you do not plan to change the current version in TeamConnection.

You must have the necessary authority to a component before you can check out or extract parts from that component. You need PartExtract authority to extract a part from TeamConnection; you need PartCheckOut authority to check a part out. See ªAppendix I. Authority and noti®cation for TeamConnection actionsº on page 277 for a listing of all the TeamConnection actions and their authority requirements.

Parts are checked out to work areas. The work area is where you store updated parts and do builds without affecting the version of the parts in the release. When a part is checked out of the release to the speci®ed work area, TeamConnection locks the part in the release if you are working in serial development. If you are working in concurrent development, the part is never locked. TeamConnection also puts a copy of the part on your workstation. It is here where you update the part. If a read-only copy of the part exists on your workstation, the ®rst character of its ®le extension changes as follows: It becomes a ²$² (dollar sign) for OS/2 and Windows platforms. It becomes a ².² (period) for AIX, HP-UX, and Solaris platforms. This copy is a backup copy. If a backup copy already exists, it is deleted. When you are ®nished updating the part, you check it back in to the work area. A work area is optional when extracting a part.

The environment variables TC_BACKUP and TC_MODPERM may be set to change the the backup and read-only options. TC_BACKUP controls whether or not backup ®les are created. If this environment variable is set to off, backup ®les are not created. TC_MODPERM controls whether or not the read-only attribute is set. The default for this environment variable sets the read-only attribute on.

When you extract a part, TeamConnection copies the part to your workstation, and the part is not locked. In other words, other users can still check out the same version of the part and make changes to it, even in serial development mode. By default, TeamConnection sets the extracted part to read-only access. This is done to keep you from inadvertently changing the part on your workstation when the part in TeamConnection is not locked. You can, however, change this in the Settings window or when you are extracting the part. When you do this, be aware that someone else can change the official part in TeamConnection, making your workstation copy back level.

Where TeamConnection places a checked-out or extracted part on your workstation depends on the following:

vYour workstation's current working directory

vWhether you use the -relative ¯ag on the command line or theDestination directory ®eld on the GUI

vWhether the TC_TOP environment variable is set

For more information about how these interact, refer to the part command examples in the Commands Reference

Chapter 3. The basics of using TeamConnection 33