Modify Instructions

Packaging, unloading, and analyzing code : Advanced packaging : Advanced packaging: The process : Summary of packaging steps : Modify Instructions

Modify Instructions

Select Modify Instructions to display the instruction modification window. To add applications to the packaged image, use the Applications and ICs tab.

Applications and ICs

$C:\Users\documentation\Documents\vastePublisher\stable\VAS Documentation Word\images\sg\pcp-mi-app2.png$

The tab has three panes: the left pane lists the available applications that can be packaged; the center pane lists the applications that have been selected to be packaged; the right pane lists the available applications that the packaged image can use. To add your application to the selected applications, select it from the list of applications in the left pane and then press the >> button to move your application to the center pane.

Startup Code

When you add an application, the packager adds the chosen application plus its prerequisite applications to the list of applications to be packaged.

$C:\Users\documentation\Documents\vastePublisher\stable\VAS Documentation Word\images\sg\pcp-mi-sc.png$

Supply your application launch code by selecting the Startup Code tab. The launch code is a Smalltalk expression that launches your application when the image starts. It is typically like the following:

MyMainWindow new open.

In the Startup Code window, enter the launch code into the Application Entry Point field. To rename the file name of the packaged image from its default, epappl, specify a new file name in the Output File field.

Note that when you complete the Modify Instructions step, the yellow flag is removed from the upper right corner of the procedure step at the bottom of the window.

Note:

The packager interprets the specified output file path as follows. If the path is a simple filename, then the output file will be written to the CFS #startUpDirectory. If the path is a relative path, including a relative specification for the output file parent directory, then the specified output file path is interpreted as relative to the value of the "ini" file property "packagingRootDirectory". If, otherwise, the path is an absolute path, it is used as is.

When running on UNIX, you may find it convenient to modify the default specification for "packagingRootDirectory" to indicate a writable subdirectory of your #startUpDirectory. For example by changing packagingRootDirectory is in the [Packaging] stanza of the.ini file to something like packagingRootDirectory=./pkging .

Policies

$C:\Users\documentation\Documents\vastePublisher\stable\VAS Documentation Word\images\sg\pcp-mi-pol.png$

You can modify the policies used in your packaging instruction by selecting the Policies tab. On this tab, you can change the reduction policy, statistics policy, dumper policy, problems policy, and the rule policy. Enter a class name or accept the default policies supplied. You can also alter the Options, which the system applies when reducing the image size. Note, however, that it is not usually necessary to modify these settings. You might change these, however, if you are creating a new packaging instruction that you want to save.

The default is for any policy changes you make to apply to packaged executable files. That is, Runtime Reduction Policy is the default. To specify policy changes for ICs (see Packaging with image components (ICs)), select Image Component Reduction Policy from the Available Policies drop-down list.