set appsnapshot
set appsnapshot= { yes | no}
When set to yes, this command collects the transformed XML document that was submitted to PTC APP for printing or publishing to PDF into a zip archive for troubleshooting. The collection also includes the graphics it references and other supporting files. When you set this command to yes, the publishing process creates a zip for each subsequent publishing operation that uses PTC APP. The default setting is no.
The PTC APP snapshot file contains the following:
• manifest.xml — An XML document that contains information about the publishing parameters in effect when the publishing request was made.
• inputDoc.xml — The document sent to PTC APP that has been modified for troubleshooting. It will be flattened and its graphic references will point to the doc-graphics directory.
• doc-graphics — A directory containing a copy of the graphics referenced by inputDoc.xml.
• appsnap.log — A log of the events from generating the PTC APP snapshot. If the snapshot is not complete, the appsnap.log will contain information about it.
• dynamic.dtd or dynamic.xsd — An XML document type definition (DTD) file or an XML schema (XSD) file may be necessary to read inputDoc.xml. The snapshot may contain one of these files if the snapshot also contains an inputDoc.xml.
|
DITA documents will use a dynamic DTD rather than a schema.
|
The location where the PTC APP snapshot zip file is saved depends on how the publishing request is made.
• If you are sending publishing requests to
Arbortext Publishing Engine, the snapshot will be generated and the transaction will be archived on the
Arbortext PE server. If
set debugcomposition is set to
on, then the snapshot file will be included with the intermediate files returned to the
Arbortext Editor client.
• If you are publishing locally using
Arbortext Editor with
Arbortext Styler, the
PTC APP snapshot is placed in the
Cache Directory (.aptcache). If you use the
Editor menu choices for publishing PDF or printing, a dialog box will confirm the action and notify you where the snapshot has been saved. It will also open the target directory for you if you click
Browse to directory. See
set appsnapshotprompt for more information.
You can run set appsnapshot from an ACL script loaded from the Arbortext-path\custom\init directory or from the command line in Editor (available if Full Menus is checked in the > > dialog box).
Consult
Troubleshooting PTC APP Publishing for more information. Using snapshots for troubleshooting should be done with the help of Technical Support.