Using SCLM with Rational Team Concert for System z work items

The following verification steps indicate the results that occur under the conditions set in the SCLM user exit code.

The terms change code and work item are interchangeable in these steps because the SCLM change code is passed through to Rational Team Concert™ for System z® as a work item. The SCLM user exit checks the last change code saved against a member and uses that to check the status of a work item in Rational Team Concert for System z.

The SCLM user exit code uses an SCLM hierarchy of DEV > TEST > PROD.

Verification step 1: Ensure that edit is not allowed if a change code is not entered.
Instructions: Go to SCLM edit and select a member to edit, but do not enter a work item in the change code field.

Result: The user exit returns the following message: You must enter a valid workitem number. Only numerics and no leading blanks or zeros.

Verification step 2: Ensure that edit is not allowed if a change code is entered that is not valid.
Instructions: Go to SCLM edit, select a member to edit, but in the change code field, enter a work item that is not valid.
Result: The user exit returns the following message:
===> E: GWClient128E SOCKET(Read) rc=0 Error=Work Item 5555 does not exist. 
Search for a different work item number. HTTP status is : 404.                    
The status of the socket set is GWClient Connected Free 39 Used 1              
Workitem number 5555 does not exist in the RTC repository,
 or the gateway server is not running.
Verification step 3: Ensure that edit is not allowed if a work item in a state other than “In Progress” is entered.
Instructions: Go to SCLM edit, select a member to edit, then in the Change Code field, enter a valid work item that is in Resolved status.

Result: The user exit returns the following message: Workitem number 96 is in Resolved status. This is not a valid status for edit.

Verification step 4: Ensure that edit is allowed if the work item number entered in the change code is in “In Progress” status.
Instructions: Go to SCLM edit, select a member to edit, then in the Change Code field, enter a valid work item that is in In Progress status.

Result: Edit is allowed on the member.

Verification step 5: Try to promote a member that has a change code assigned to it that is not in resolved status.
Instructions: Go to SCLM promote, select a member to promote that has been previously edited and has been assigned a change code that is a work item that is still in In Progress status.

Result: Promotion fails with the following message: Workitem number 1 is in New status. This is not a valid status for promotion.

Verification step 6: Try to promote a member that has a change code assigned to it that is in resolved status.
Instructions: Go to SCLM promote, select a member to promote that has been previously edited and assigned a change code that is a work item that is in Resolved status.
Note: This involves going to Rational Team Concert for System z after the change in SCLM has been edited, built, and tested and is ready to be promoted. When the member is ready to be promoted, change the work item status to Resolved.

Result: Promotion is allowed to continue.

Verification step 7: Try to promote a member from TEST to PROD when the work item is in resolved status.
Instructions: In this step, the status of the work item must be Closed before promotion to PROD is allowed. Go to SCLM promote and select a member to promote that was previously promoted to TEST when the work item was in Resolved status. Try to promote that member to PROD while the work item is still in Resolved status.

Result: The promotion fails, and the following message is displayed: You can only promote higher than TEST when status has moved from Resolved. This is not a valid status for promotion to PROD.


Feedback