ScriptFiles Section of the Ascnnnn.sxp File

The Scripts section of the ascnnnn.sxp archive file describes scripts for modifying all other ASCII files (besides autoexec.bat and config.sys) that are specified when the reference system of the Packaging Computer was configured. For details about these specifications see the ASCII Files tab in the Configure Reference System dialog under File, Settings.

For a description of the Packager-specific scripting language see Packager Scripting Language.

For each ASCII file listed on the ASCII Files tab, the Packager creates the following:

• An ascnnnn.sxp file.
• A script ascnnnn.ins, for modifying the ASCII file during installation of the product.
• A script ascnnnn.dei, for modifying the ASCII file during uninstallation of the product.

The Packager automatically enters the names of these scripts in the ScriptFiles section. In the ascnnnn.ins and ascnnnn.dei scripts, you can use parameters.

The ScriptFiles section can have the following entries:

Install

Specifies a script to be executed when the SXP product is installed on the target computer.

Deinstall

Specifies a script to be executed when the SXP product is removed from the target computer.

Modifications to the ASCII files described in ascnnnn.ins and ascnnnn.dei must correspond precisely. For example, suppose you want to use an insert command to insert a line in an ASCII file after the installation of a packaged product and then use a delete command to delete the same line after uninstallation. The line to be deleted in ascnnnn.dei must be an exact match for the line that was inserted from ascnnnn.ins; otherwise, this line will not be deleted from the ASCII file when the product is uninstalled.

Paths and Parameters

You can create the ScriptFiles section manually, if necessary. You must specify the scripts with their absolute paths. You can use parameters in path specifications. Usually, the script is enclosed with the product, for example, in the version directory. When the script is enclosed with the product, you can specify the path using the internal $(SxpSrvRelDir) parameter.

You can use scripts to modify any ASCII files. The automatically generated scripts are very basic scripts that may need to be modified. Any recorded changes are appended to the ASCII file on the target computer.

Notes:

• When an uninstall routine is called, $(SxpSrvRelDir) is converted to the path name of the source of the installation files; however, these files are only available temporarily. Therefore, during installation of the product, the uninstall routine is copied to the target computer's $(SxpLocRelDir) and will be invoked later, during uninstallation of the product.
• If you want to use additional files (such as related.dll or response files) that reside in the directory $(SxpSrvRelDir) or its subdirectories, then you must create a post‑program batch file to copy these files to the directory $(SxpLocRelDir) or its appropriate subdirectories.
• When the program is defined using the internal parameter $(SxpSrvRelDir), the path must not contain a blank.