Previous Topic: Package Configuration Using ScriptsNext Topic: Add and Change Package Parameters


Add and Change Internal Procedures

Internal procedures are script files used to configure and interchange information with the package installation process. Internal procedures are part of the package; each of the script files must be defined in the file list of a component. Execute rights must have been specified for these script files.

If you want to add the internal procedure to a specific component, the procedure must be defined in that specific component. If you want to add the procedure to the package, the internal procedure can be defined for the package or any component.

To add an internal procedure to the PIF package or a component

  1. Select the package or component of the package.
  2. Select the Procedures tab in the work pane.
  3. Right-click in the procedures list and select Add internal procedure from the context menu.

    The Internal procedure dialog appears.

  4. Enter properties for the internal procedure, as follows:
    Execution Time

    Specifies the time that the script is executed.

    Possible values are as follows:

    • pre installation—The script is executed before the package installation.
    • post installation—The script is executed after the package installation.
    • pre remove—The script is executed before the package is removed. If the script exits with a nonzero exit value, the component is not removed from the system, but the uninstallation process continues.
    • post remove—The script is executed after the package has been removed.
    • pre start—The script is executed before the product installation and any installation dialog starts.
    • pre PIF install—A special script that is executed only the first time a product is installed on the target computer. Only this script is able to modify the product installation path.
    • post interview—The script is executed after the interview phase (of the installation dialogs) has completed.
    Procedure File

    Indicates the name of the script file, which you select from the drop-down list. Only executable files that are defined in the file list of one of the components are displayed in this list.

    Options

    If your script allows control by command switches to configure the script execution, allows you to enter these switches here. These switches are added to the script during script execution.

    Interpreter

    Describes the name of an interpreter for the shell script, if the default interpreter, the UNIX shell, is not used. Specify the fully qualified path name of the interpreter program.

  5. Click Add.

    The new procedure appears in the procedures list.

To change the properties of an internal procedure

  1. Select the package or component of the package.
  2. Select the procedure to change on the Procedures tab in the work area.
  3. Right-click the selected procedure and choose Properties from the context menu.

    The Internal procedure dialog appears.

  4. Change the execution time, the procedure file, the options, or the Interpreter.
  5. Click Change.

    The modified properties are applied to the internal procedure.