Invoking Your Own Putback Validation Program

If a validation program is set for a workspace, then any putback operation to this workspace invokes the program that you indicate. If the program fails, then the putback is canceled.

Note - The validation program is not a part of Sun WorkShop^TM TeamWare. You must provide it if you want putback to perform validation. The validation program can be any executable file (shell script or program) that accepts arguments that are passed by putback and returns non-zero exit status to deny putback. See Sample Validation Program.

The user who wants to do a putback is prompted for a Integration Request ID and then the validation program is invoked with the following arguments:

User ID of the user doing the putback ($1)

"from" workspace full pathname ($2)

"to" workspace full pathname ($3)

Integration Request ID ($4)

Name of the file that contains the list of files to be modified ($5)

To invoke your validation program:

: 1. In the Configuring Window, load the workspace by choosing File Load Workspaces.

: 2. Select the workspace by clicking on it.
: 3. Choose Workspace Workspace Properties.
: 4. Select the Putback Validation Tab in the Workspace Properties Dialog Box.
: 5. Click Putback Validation: On.
: 6. Click Putback Approval: Approved by Validation Program.
: 7. Type the path to your validation program in the Validation Program text box.
: 8. Click OK.

Note - It is more secure to include the full path to your validation program, rather than just the program name. If you don't include the full path, a user could substitute their own program in place of your validation program.