The syntax for this command is as follows:

CAPTURE
CAPTURE - 
CAPTURE + <packname> [COMPRESS]

Use this command to enable or disable the automatic capture of diagnostic material in the event of a build failure.

Use the ‘+’ argument to enable CAPTURE or to change the <pack name> on which the CAPTURE file is saved. <Pack name> must be a valid disk pack, the capture file will be placed on this pack.

If specified, the COMPRESS option will cause the capture file to be wrapped with the COMPRESS option.

Use the ‘-’ argument to disable CAPTURE.

When CAPTURE command is used, it displays the current setting.

When CAPTURE is enabled, and a system or report build fails, certain error related source files will be wrapped into a container file. These can be sent to Engineering for analysis.

These are the names of the container files:

The report capture container name is suffixed by the Report Requestor ID.

The capture container name also appears in the client log. If the capture container name in the client log has a [C] suffix, the file is compressed.

Typically, CAPTURE is set on the production deployment MCP Host where a subsequent build is needed soon after a build failure. This feature allows diagnostic material from a failed build to be packaged quickly and automatically.

In the event of a build failure, a waiting job entry is created to provide details of the failure occurrence and the container file name. This waiting entry will self-terminate after 10 minutes.