Macro Language Reference > Macros > Document > tsaveb
  
tsaveb
Description
Saves the current document with its filepath context (and, optionally, its associated files and command line arguments) as an Application Bundle.
 
This macro is an alias of the saveapp macro.
Syntax
tsaveb bundle path:s ( options:l )*
tsaveb
[no parameter]
Invoke the Save application dialog box.
bundle path
The destination path of the saved bundle, in double quotes.
options
Two types of option, those that are simple flags and those that include arguments:
flags
-c
Save PTC ALD .exe command line arguments
-e
Save all documents opened in the current PTC ALD session, not just that currently open
-f
Save font files
-l
Save PTC ALD libraries
-o
Create an auto open script such that when the bundle is loaded the document is opened at the page displayed when the saveapp action was run.
-P
Save Perl site / lib directory contents (note: flag is uppercase P)
-s
Save PTC ALD system (s*.3ad) files
-v
Save variables (note: variables are preserved as set when the document was opened, not when it was saved)
-*
Include all options in this list except "e": ie. save, and apply the options to, the current document only
These options can be specified separately (separated by a space) or grouped into a single argument, e.g. -fls.
Arguments
a-PATH
An additional file or directory to be included with the bundle, in addition to those that relate to the current document. Up to 32 additional files can be included in this way: any excess will be ignored.
* 
The option to specify a directory name in this parameter is useful if intending to include more than 32 files.
p-PASSWORD
A password to be applied to a zip file bundle (if specifying t-z as the bundle type (see below).
t-TYPE
The type of bundle to be saved:
z
Read only zip file
f/d
Folder/directory (default)
 
If the argument contains spaces, the whole option must be wrapped in double quotes, e.g. “a-C:/ My Documents/bundle.zip”
Options of both types can be combined in a single argument, provided they are separated by a space, eg. saveapp "C:/ My Documents/bundle.zip” p-fred -fls.
Additional Information
With this feature, implemented in version 9.1, saving a bundle means that a user can elect to load exactly the same set of files at a later date, either manually or during system startup, or share them with another user.
It is also useful for template troubleshooting since it allows a user to package all the files that make up the document and send them, in a zip file, to the relevant support or diagnostic resource.
This option is also available via the File > Save to bundle menu option.
To load Application Bundles saved in this way on startup, create a bundle list and associated .ini system file via the loadapp macro or the File > Load bundle menu option.
Related Links