The plugin will create a view in the workspace with the specified view tag. The view tag is a server identifier which must be unique on a ClearCase server.

If you have several jobs that uses this ClearCase plugin you need to specify a unique view tag for each job. To help creating unique view tags, there are two macros that will be replaced in the view name.

  1. ${NODE_NAME} is replaced with the name of the node
  2. ${JOB_NAME} is replaced with the name of the job
  3. ${USER_NAME} is replaced with the name of the user that is running Jenkins
  4. ${DASH_WORKSPACE_NUMBER} is replaced by the number of the workspace if it isn't the primary workspace on the slave. This allows to execute several concurrent builds of the same job on the same slave.

The view tag is available as an environment variable named CLEARCASE_VIEWTAG.