logRetriever

The logRetriever task retrieves a log file from the build result.

The following table contains logRetriever task attributes.

Attribute	Description	Required
buildResultUUID	The UUID of the build result to update. The value of this attribute is typically ${buildResultUUID} because the property is built-in when using the Jazz® Build Engine.	Yes Note: You can use buildResultUUID or BuildDefinitionId.
buildDefinitionId	For the logRetriever task, the build definition id from which the log file will be retrieved from the build result of the last non-personal completed build.	Yes Note: You can use buildResultUUID or BuildDefinitionId.
fileName	The name of the log file that has been published to the build result that is to be retrieved.	Yes
destFileName	The destination file name to be used for the retrieved log file.	Yes
repositoryAddress	Address of the team repository to use. The value of this attribute is typically ${repositoryAddress} because that property is built-in when the Jazz Build Engine is used.	Yes
userId	User ID for authentication to the repository. Requires password or passwordFile to be set.	Yes
certificateFile	The path to the file that contains the user's login certificate for authentication. Requires password or passwordFile to be set. You can specify certificateFile or repositoriesFile, but not both.	No
failOnError	If `true` (default value), the task fails if it encounters an error. If `false`, some errors are ignored and the task is completed.	No
integratedWindows	Whether to use Integrated Windows Authentication	No
kerberos	Whether to use Windows user credentials using Kerberos/SPNeGO.	No
password	Password for the user ID for authentication to the repository. Either password or passwordFile can be provided, but not both.	No
passwordFile	The password file to use for authentication to the connection. You can create a suitable password file by invoking the Jazz Build Engine with the `-createPasswordFile` argument. Only one password file can be specified. Either password or passwordFile can be provided, but not both.	No
repositoriesFile	The repositories registry file that contains a list of repositories and their login credentials. You can specify repositoriesFile or certificateFile, but not both. If you specify repositoriesFile, do not specify either password or passwordFile. The repositories file is created and updated through the use of scm login and logout commands.	No
reuseLoginOption	The first time an Ant task logs in to a repository, a connection is not terminated at the end of this task. All subsequent tasks reuse this connection as long as they connect to same repository with same user ID. When a task logs in to a different repository or with a different user ID, the previous connection is terminated and a new connection is created and reused.	No
smartCard	Use of the connected smart card for authentication (`true` or `false`). Requires userId to be set. For more information about smart card authentication, see Connecting to repositories and project areas.	No
verbose	More message output. The default value is `false`.	No

Example

<logRetriever repositoryAddress="${repositoryAddress}"
		              userId="${userId}"
		              password="${password}"
		              buildResultUUID="${buildResultUUID}"
		              fileName="${fileName}"
		              destFileName="${destFileName}" />