1. Manuals
  2. Brands
  3. Symantec Manuals
  4. Software
  5. WISESCRIPT PACKAGE EDITOR 8.0 - REFERENCE FOR WISE PACKAGE STUDIO...
  6. Reference

Symantec WISESCRIPT PACKAGE EDITOR 8.0 - REFERENCE FOR WISE PACKAGE STUDIO V1.0 Reference

Hide thumbs
Table of Contents

Advertisement

Quick Links

WiseScript Package Editor Reference

Advertisement

Table of Contents
loading

Related Manuals for Symantec WISESCRIPT PACKAGE EDITOR 8.0 - REFERENCE FOR WISE PACKAGE STUDIO V1.0

Summary of Contents for Symantec WISESCRIPT PACKAGE EDITOR 8.0 - REFERENCE FOR WISE PACKAGE STUDIO V1.0

  • Page 1 WiseScript Package Editor Reference...
  • Page 2 Copyright © 2009 Symantec Corporation. All rights reserved. Symantec, the Symantec Logo, and Altiris are trademarks or registered trademarks of Symantec Corporation or its affiliates in the U.S. and other countries. Other names may be trademarks of their respective owners.

  • Page 3: Technical Support

    The Technical Support group also creates content for our online Knowledge Base. The Technical Support group works collaboratively with the other functional areas within Symantec to answer your questions in a timely fashion. For example, the Technical Support group works with Product Engineering and Symantec Security Response to provide alerting services and virus definition updates.
  • Page 4 Licensing and registration If your Symantec product requires registration or a license key, access our technical support Web page at the following URL: www.symantec.com/techsupp/ Customer service Customer service information is available at the following URL: www.symantec.com/techsupp/ Customer Service is available to assist with the following types of issues:...
  • Page 5 Consulting Symantec Consulting Services provide on-site technical Services expertise from Symantec and its trusted partners. Symantec Consulting Services offer a variety of prepackaged and customizable options that include assessment, design, implementation, monitoring, and management capabilities. Each is focused on establishing and maintaining the integrity and availability of your IT resources.

  • Page 6: Table Of Contents

    Contents Technical Support ............3 Chapter 1: Introduction .
  • Page 7 Adding Contents of Directories ..........52 Specifying Installation File Settings .
  • Page 8 Customizing the List of Actions..........97 Types of Scripts .
  • Page 9 Delete File(s) ............146 Delete SVS Layer .
  • Page 10 Read INI Value ............186 Read/Update Text File .
  • Page 11 Disabling the Directory Already Exists Message ....... . . 225 Keeping Disabled Controls From Reactivating.

  • Page 12: Chapter 1: Introduction

    Chapter 1 Introduction This chapter includes the following topics: About WiseScript on page 12 WiseScript Benefits on page 13 Getting Started on page 14 Starting the Software on page 15 The Product Interface on page 16 Using WiseScripts in a Windows Installer Installation on page 17 Compiling, Testing, and Running a WiseScript on page 18...

  • Page 13: Wisescript Benefits

    Introduction tools. Therefore, some of the information in this document does not apply to WiseScript Editor. WiseScript Benefits WiseScript is a high-level scripting language that consolidates dozens or hundreds of lines of code into predefined script actions. What Makes WiseScript Unique Easy to learn WiseScript supports a point-and-click method of scripting.

  • Page 14: Getting Started

    Introduction Modify a machine resource (example: registry key or .INI file). Locate and delete a file and its directory (example: to remove a spyware program). Free disk space by clearing the Temp directory, the Recycle Bin, or the Internet cache. Find the current Windows version.

  • Page 15: Starting The Software

    Introduction Starting the Software WiseScript Editor The WiseScript Editor interface is embedded within MSI Script in Windows Installer Editor. This lets you create WiseScripts for Windows Installer custom actions. In MSI Script, add or double-click a custom action that runs a WiseScript. On the Details tab of the Run WiseScript dialog box, click Options.

  • Page 16: Opening A Microsoft Sms Installation

    Introduction Getting Started About Installation Expert on page 36 About Script Editor on page 94 Opening a Microsoft SMS Installation WiseScript Package Editor only You can open Microsoft SMS files (.IPF) and edit them just as you edit .WSE files. For information about SMS, search for “SMS”...

  • Page 17: Using Wisescripts In A Windows Installer Installation

    Introduction Switching Between Installation Expert and Script Editor When you switch between the Installation Expert and Script Editor views, you might see the following messages: This installation has custom script code, which is incompatible with Installation Expert. Click Yes to delete your custom code, or No to preserve it. If you click No, you have access to a limited set of pages in Installation Expert.

  • Page 18: Compiling, Testing, And Running A Wisescript

    Introduction See Uninstalling Changes Made by a WiseScript in the Windows Installer Editor Help. If you use a WiseScript .EXE in a Windows Installer installation that will run on Windows Vista or later operating system, you must specify a manifest file that indicates the run level for the .EXE.

  • Page 19: Product Documentation

    Introduction Project Name Enter a name for the portable project. When the portable project .EXE is run, it extracts the project’s files and puts them in a directory with this name. Add default scripts that are included in this WiseScript Mark this to add any default WiseScripts or VBScripts that are included in the WiseScript.
  • Page 20 The product release notes cover new features, enhancements, bug fixes, and known issues for the current version of this product. To access the release notes, select Release Notes from the Symantec program group on the Windows Start menu. WiseScript Package Editor Reference...

  • Page 21: Chapter 2: Setting Up

    Chapter 2 Setting Up This chapter includes the following topics: How to Customize Your Development Environment on page 21 Creating and Editing Installation Templates on page 22 Customizing Installation Expert Page Groups on page 23 Editing Installation Messages on page 24 Setting Preferences on page 25 Downloading Application Runtimes...

  • Page 22: Creating And Editing Installation Templates

    Setting Up Creating and Editing Installation Templates WiseScript Package Editor only When you create a new installation, it gets its configuration from a template file. Templates contain logical defaults and commonly used settings. Some template files are predefined and appear when you create a new installation. You also can create your own templates.

  • Page 23: Customizing Installation Expert Page Groups

    Setting Up Customizing Installation Expert Page Groups WiseScript Package Editor only By default, Installation Expert displays all page groups and all pages within each group. From the Pages menu, you can select one of the following page groups: Displays all page groups and all pages associated with each group. Properties Displays only the pages that do not add or change script lines in the script.

  • Page 24: Editing Installation Messages

    Setting Up Select the page or pages and click OK. Add more page groups and pages as appropriate. Click OK. Your new set of page groups appears under the Pages menu. Editing Installation Messages WiseScript Package Editor only You can edit the prompts and error messages that are displayed by an installation. Installation messages are stored in wise.ini, which is in the WiseScript Editor subdirectory of this product’s installation directory.

  • Page 25: Setting Preferences

    Setting Up Dialog Title The title of the Select Language dialog box. Dialog Text This text appears on the Select Language dialog box. If the installation supports multiple languages, enter instructions in all supported languages. Setting Preferences WiseScript Package Editor only In Preferences, customize options for script development and compiling.

  • Page 26: Downloading Application Runtimes

    Setting Up Show Tabs for Wise Include Scripts Mark this to show tabs for include scripts in Script Editor. Color Selection Select the colors for the types of script actions recognized by Script Editor. Select the type of script action and then click Set Color to select the color. Suppress Version Error Mark this to suppress errors that normally occur when version checking is performed on files that do not have version resources.
  • Page 27 Setting Up If you need to go through a firewall or proxy server to get to the Internet, the Download Runtimes wizard uses your browser’s proxy settings. To change your Internet connection settings, refer to your browser’s documentation. To download application runtimes Connect to the Internet.

  • Page 28: Chapter 3: Installation Management

    Chapter 3 Installation Management This chapter includes the following topics: Changing Source Directories on page 28 Converting to UNC-Based Source File Paths on page 29 Converting to Relative Source File Paths on page 29 Using Self-Repair on page 30 Language Support on page 31 Distributing an Installation on page 34...

  • Page 29: Converting To Unc-Based Source File Paths

    Installation Management As you edit, the new path appears to the right of the original path in the list box. If you have moved the entire directory tree that contains the installation files, you might only need to edit the root directory to change all the references. Mark Change Sub-Directories to update the paths of the subdirectories of the selected directory.

  • Page 30: Using Self-Repair

    Installation Management Example: If the path to the .WSI is C:\Development\Application.wsi, and you add the file C:\Program Files\Application.ini, the relative path of Application.ini is ..\Program Files\Application.ini. Select Edit menu > Source Directories. The Change Source Directories dialog box appears and lists all the directories referenced in the script.

  • Page 31: Language Support

    Installation Management These files and registry keys are checked when the application starts, so limit the number of items to prevent the start time from increasing. Designate each of these files and registry entries for self-repair as follows: File: Double-click the file on the Files page or double-click the Install File(s) script line that references the file.

  • Page 32: Processes For Adding Language Support

    Installation Management pre-translated languages, you can add it to the Languages page and add translated text for that language. Then you can add support for the new language to the installation. Example: You want to translate an installation into Swiss French. However, that language is not one of the pre-translated languages.
  • Page 33 Installation Management In the script, double-click the Custom Dialog action that references the dialog box you are changing. (Use Edit menu > Find to find the action quickly.) Edit the dialog box text and controls, replacing the existing text with the text in the selected language.

  • Page 34: Distributing An Installation

    Installation Management Distributing an Installation WiseScript Package Editor only When you complete and compile an installation, you can use Package Distribution to share or deploy it by: Copying a Package to the Share Point Directory Copying a Package to a Network Directory Copying a Compiled Installation to an FTP Server See these topics in the Wise Package Studio Help.

  • Page 35: Chapter 4: Creating Wisescript Installations

    Chapter 4 Creating WiseScript Installations This chapter includes the following topics: About Installation Expert on page 36 Active Directory on page 38 Add/Remove Programs on page 39 Billboards on page 40 Build Settings on page 41 CAB Files on page 44 Compiler Variables on page 44 Components...

  • Page 36: About Installation Expert

    Creating WiseScript Installations System Requirements on page 75 System Search on page 77 Uninstall on page 80 WebDeploy on page 81 WiseUpdate on page 84 About Installation Expert The Installation Expert view in WiseScript Package Editor lets you create and edit basic installations and provides an easy-to-use, task-oriented user interface to perform the most common installation tasks.
  • Page 37 Creating WiseScript Installations Page Groups Page Area View Navigation Compile, Test, and Run Page Groups Pages are organized into page groups. When you select a page view, its pages are organized into page groups. Click the group name to expand or collapse its pages. Click a page name to display that page.

  • Page 38: About The Project Settings View

    Creating WiseScript Installations Compiling and Testing Compile, Test, Debug, and Run buttons test and compile the WiseScript. See also: About Installation Expert on page 36 About the Project Settings View WiseScript Editor only The Project Settings view contains several pages that provide information that is required by certain script actions.

  • Page 39: Add/Remove Programs

    Creating WiseScript Installations Display Version (Optional) This field obtains its value from the Software Version field on the Add/Remove programs page. Publisher (Optional) This field obtains its value from the Publisher field on the Add/ Remove Programs page. To distribute the .ZAP file with the installation using Package Distribution in Workbench, select Network and Compiled package on the Distribution Method page.

  • Page 40: Billboards

    Creating WiseScript Installations Help URL Enter the path to a help file that will be installed on the destination computer. Comments Enter any additional comments for the end users. Billboards WiseScript Package Editor only Use the Billboards page to add billboard graphics to display during installation. The page lists the billboards in the order they appear during the installation.

  • Page 41: Build Settings

    Creating WiseScript Installations Center Horizontal Place at Right Scale to Screen Mark this for the graphic to cover the same percentage of the screen regardless of screen size. Hide Progress Bar Mark this to hide the progress bar during graphic display. Center Vertical Place at Bottom Tile Background...
  • Page 42 Creating WiseScript Installations Maximum Compression Mark this to make the compiled installation file as small as possible. Because it takes longer to compile with maximum compression, disable this during development. Slow Installation Speed Mark this to slow down the installation on the destination computer. Do this when you have a short installation to ensure that your billboard graphics are displayed.
  • Page 43 Creating WiseScript Installations Installation .EXE Name Specify a name and location for storing the executable file after it is compiled. Leave this blank to have the name of the installation executable default to the name of the installation file (*.WSE). Language .INI Name To use a language that is not built into WiseScript Package Editor, specify the path to an .INI file that contains translation resources.

  • Page 44: Cab Files

    Creating WiseScript Installations requireAdministrator Select this option for a WiseScript installation only. When the WiseScript installation is run, the UAC prompt appears. Do not select this option for a WiseScript custom action. If you do, the .MSI installation will fail due to UAC prompting on the custom action execution. Specify a manifest file To embed a specified manifest file in the .EXE instead of the default manifest, select this option and specify a manifest file that is in XML format.
  • Page 45 Creating WiseScript Installations The Compiler Variable Settings dialog box appears. Complete the dialog box: Variable Name Enter the name of the compiler variable. By convention, compiler variables begin and end with an underscore character (_). Although this convention is not enforced, it helps distinguish compiler variables from regular variables in scripts.

  • Page 46: Components

    Creating WiseScript Installations Components WiseScript Package Editor only Use the Components page to add components, which are optional pieces, such as a spell checker, a tutorial, sample files, and other add-ons. When the WiseScript runs, end users can select the components to install. Components that you create appear elsewhere in Installation Expert to let you assign specific resources to components.

  • Page 47: Digital Signature

    Creating WiseScript Installations Branding/Registration Prompts for the end user’s name, company name, and, optionally, a serial number. Destination Directory Lets the end user choose a destination directory for the installation. The directory the end user chooses is stored in the variable %MAINDIR%. Backup Replaced Files Lets the end user choose whether to back up files that are replaced during the installation and where to store the backups.
  • Page 48 Creating WiseScript Installations signtool.exe tool. For details, search for “Signtool” in the MSDN Library (msdn.microsoft.com/library/). Requirements You must have a valid code signing certificate, which you can obtain from a commercial certificate authority such as Verisign. For a list of certificate authorities, search for “Microsoft Root Certificate Program Members”...

  • Page 49: File Associations

    Creating WiseScript Installations Signcode.exe with public/private key pair files Mark this to use signcode.exe and then specify the credentials file (.SPC or .CER) that contains your Digital ID, and your private key file (.PVK). File Associations WiseScript Package Editor only Use the File Associations page to associate file extensions with executables to determine which application to start when the end user double-clicks a file with a certain extension.

  • Page 50: Files

    Creating WiseScript Installations Source Pathname (Read-only) This is the path to the .EXE program associated with the specified document extension. Click OK. See also: File Associations on page 49 Files WiseScript Package Editor only Use the Files page to specify the files and directories to be installed on the destination computer.

  • Page 51: Adding Files

    Creating WiseScript Installations Details Edit file settings. Specifying Installation File Settings on page 53. Adding Files WiseScript Package Editor only Select Installation Expert > Files page. If the directory where the file is to be added is not listed in the lower-left list box: Select the directory under which the new directory should be created.

  • Page 52: Adding Contents Of Directories

    Creating WiseScript Installations Specifying Installation File Settings on page 53. If you assign files to a directory that is part of an optional installation component, those files are installed only if that component is installed. Adding Contents of Directories WiseScript Package Editor only You can add the entire contents of a directory to an installation or use wildcard filters to add only specified files in the directory.

  • Page 53: Specifying Installation File Settings

    Creating WiseScript Installations Specifying Installation File Settings WiseScript Package Editor only Select Installation Expert > Files page. In the lower-right list box, select a file or files and click Details. If you selected a single file, the Install File Settings dialog box appears. If you selected multiple files, the Multiple File Settings dialog box appears.
  • Page 54 Creating WiseScript Installations Using Self-Repair on page 30. Replace Existing File Specify when to replace existing files on the destination computer. Always The new file always replaces the old file. Never The file never overwrites an existing file. Select this for files that should be installed if they are not present, but which might be customized by the end user and should therefore not be replaced on re-installation (example: configuration files).

  • Page 55: Fonts

    Creating WiseScript Installations SmartPatch on page 74. Click OK. See also: Adding Contents of Directories on page 52 Files on page 50 Fonts WiseScript Package Editor only Use the Fonts page to add fonts to an installation. You only need to add fonts when they are required by the application being installed.

  • Page 56: Ini Files

    Creating WiseScript Installations Company Name INI Files WiseScript Package Editor only The INI Files page lets you create a new .INI file or update an .INI file on the destination computer during installation. Select Installation Expert > INI Files page. Select the destination directory from the left list.

  • Page 57: Updating An Existing .Ini File On The Destination Computer

    Creating WiseScript Installations To add to a section, type the section name in brackets, then type new lines for that section. If the .INI file already contains a name-value pair that you type, the existing line is replaced by the new one. Example: [SECTIONNAME] Color=Blue To delete a section and its contents, type a section name with no lines after...

  • Page 58: Installation Log

    Creating WiseScript Installations Installation Log WiseScript Package Editor only Use the Installation Log page to create an installation log and to specify its location and name. As an alternative, set the compiler variable _LOGFILE_PATH_ to the path of the log file. The installation log is a text file that lists the events that occur while the installation runs.
  • Page 59 Creating WiseScript Installations Note If you add support for a double-byte language, do not include any other languages in the installation. Including double-byte and single-byte languages in the same installation can cause distortion of the fonts for the single-byte languages. If you need both single and double-byte installations, make a copy of the installation and include the double-byte languages in the copy.

  • Page 60: Media

    Creating WiseScript Installations Media WiseScript Package Editor only Use the Media page to configure the installation for the type of media on which it will be stored and distributed. Select Installation Expert > Media page and complete the page: Single File Installation Mark this to pack all the files into a single installation file.

  • Page 61: Odbc

    Creating WiseScript Installations Package Definition File To create a package definition file when the installation is compiled, mark one of the following and enter the correct SMS version: Create Package Definition File (SMS 1.2 or earlier) Mark this to create a package definition file of file type .PDF. Create SMS File (SMS 2.0 or later) Mark this to create a package definition file of file type .SMS.

  • Page 62: Online Registration

    Creating WiseScript Installations Online Registration WiseScript Package Editor only Use the Online Registration page to configure the online registration feature. This lets the end user register the program after the installation has been completed successfully. Product registration is supported through a CGI program or Active Server Page that accepts the data through the HTTP POST operation.

  • Page 63: Product Details

    Creating WiseScript Installations Starting Serial Number, Ending Serial Number Define the range of serial numbers by entering a starting and ending number. Approx. Serial Numbers Enter the approximate quantity of serial numbers. Output File Specify a text file name, then click Export. This writes the serial numbers to the specified file.

  • Page 64: Registry

    Creating WiseScript Installations Progress Bar Based On Select how progress should be calculated. Custom Progress Bar .DLL By default, this path points to an operating system-specific .DLL that displays a custom progress bar. If you have a custom .DLL that displays a progress bar, specify its path here.

  • Page 65: Creating Or Editing Registry Key Settings

    Creating WiseScript Installations Add Values Copy values from your computer to the installation. Create a new key or import a registry file into the installation. The presence of a key in this list does not necessarily mean that the key is added to the registry on the destination computer.

  • Page 66: Configuring Registry Key Settings

    Creating WiseScript Installations The registry value is added and appears in the lower-right list box. To edit it, double- click its name. To delete it, use the right-click menu. To import a registry file Select Installation Expert > Registry page. Click New and select Import.
  • Page 67 Creating WiseScript Installations Value Name Enter the name of a new named value. Data Value Enter the data for the value. To insert multiple lines of data here, press Ctrl+Enter to begin a new line. If the Data Type (below) is Double word (DWORD), enter the data in decimal notation.

  • Page 68: Runtimes

    Creating WiseScript Installations option is unavailable unless Multiple Strings is selected in the Data Type drop-down list. Click OK. See also: Creating or Editing Registry Key Settings on page 65 Registry on page 64 Edit Registry on page 151 Runtimes WiseScript Package Editor only Use the Runtimes page to select various runtimes to include with the installation.

  • Page 69: Screen

    Creating WiseScript Installations Windows Runtime The Windows Runtime section of the Runtimes page lists common Windows runtimes. Add these runtimes when the runtime is critical to the application you are deploying, and when you expect that the end users do not have the runtime installed. Crystal Reports Runtime ™...

  • Page 70: Services

    Creating WiseScript Installations Background Gradient Select the background gradient. Title Bar Mark this to cause the installation’s title to be displayed at the top of the screen in a title bar. Hide Program Manager Mark this to hide the Program Manager during installation (Windows 3.x only). No Background Gradient Mark this to display no gradient behind the installation dialog boxes.

  • Page 71: Configuring Service Settings

    Creating WiseScript Installations The service appears in the list on the Services page. To change the .EXE file for a service, select it from the list and click Details. Configuring Service Settings. To remove an existing service from the installation, select it from the list and click Delete.

  • Page 72: Shortcuts

    Creating WiseScript Installations Group Enter the name of the load ordering group to which this service belongs. Leave this empty if the service does not belong to a group. Dependencies Enter a list of semicolon-separated names of services or load ordering groups that must start before this service.

  • Page 73: Editing Shortcut Details

    Creating WiseScript Installations Editing Shortcut Details on page 73. The new shortcut appears on the Shortcuts page. To edit an existing shortcut, select it and click Details. To remove a shortcut from the installation, select it and click Delete. If you create a shortcut to a file that is in an optional component of the installation, the shortcut is created only if that component is installed.

  • Page 74: Smartpatch

    Creating WiseScript Installations Check self-repair items when this shortcut is opened Mark this to turn on self-repair functionality for this shortcut if you have configured the installation for self-repair. Typically, use this for a shortcut that starts the application. Using Self-Repair on page 30.

  • Page 75: System Requirements

    Creating WiseScript Installations all versions to be updated by SmartPatch) is at least 85% of the size of the complete file, the complete file is included rather than the patch. However, even though the entire file is included in the installation, it is not installed unless the end user has a valid copy of an older version of the file.
  • Page 76 Creating WiseScript Installations Required Select this if this configuration item is critical to the installation and the program cannot run without it. The message you enter in the Message Text field appears on the destination computer if it does not meet the specified requirement, and the installation is aborted.

  • Page 77: System Search

    Creating WiseScript Installations System Search WiseScript Package Editor only The System Search page specifies methods by which the installation can search for and detect a previous version of the application. If you know certain files, registry values, or .INI file changes that would be present if the application was installed previously, you can use this page to search for a previous version of the application.

  • Page 78: Searching For Ini Values

    Creating WiseScript Installations Click Add at the right of the page and select Search for File. The Search for File dialog box appears. Complete the dialog box: File Name Enter the name of the file. Description Enter the message to display on the progress dialog box while searching. Drives to Search Select local hard drives only, network drives only, or both.

  • Page 79: Searching For Registry Values

    Creating WiseScript Installations Select the directory that contains the .INI file from the directory tree. If the directory is not displayed, select its parent directory and click New Folder to add INI File Name, INI Section Name, INI Item Name Enter the file name of the .INI file to be read, the section that contains the entry to be read (without the square brackets), and the item name of the entry.

  • Page 80: Uninstall

    Creating WiseScript Installations Uninstall WiseScript Package Editor only Use the Uninstall page to specify whether the installation supports the uninstall capability and to set options for controlling which files are removed by the uninstall program. The uninstall program is named unwise.exe. Note Installations contain the Repair option when you choose the application name in the Add/Remove Control Panel.

  • Page 81: Webdeploy

    Creating WiseScript Installations Use this command to delete additional files, such as those created by your program on first run. Select the directory containing the files to be deleted. If the directory is not displayed, select its parent directory and click New Folder to add it. Enter the file name in Filename.

  • Page 82: The Webdeploy Process

    Creating WiseScript Installations See: The WebDeploy Process on page 82 Creating a WebDeploy Installation on page 82 Uploading a WebDeploy Installation to the Web on page 84 The WebDeploy Process Phase 1: Your Computer Your Internet Host (FTP/HTTP) Server Contains the installation The installation is copied to the host but is not used yet Upload files through FTP...
  • Page 83 Creating WiseScript Installations Note Installations that are deployed through WebDeploy contain a Repair option in the uninstall wizard, but the Repair option does not function. To create a WebDeploy installation Select Installation Expert > WebDeploy page. Select one of the following: Add support for Internet-based Copy Local Files script action Mark this if you add a Copy Local Files script action that will download or upload to a Web site.

  • Page 84: Uploading A Webdeploy Installation To The Web

    Creating WiseScript Installations Cluster Size Enter a number in kilobytes. Files smaller than the cluster size are packed into data files up to the cluster size. Files larger than the cluster size make up their own data file. A smaller cluster size increases the transfer rate of data. It also minimizes the amount of files that a given installation must download because only the necessary files are downloaded.

  • Page 85: Chapter 5: Using Wiseupdate

    Chapter 5 Using WiseUpdate This chapter includes the following topics: About WiseUpdate on page 85 The WiseUpdate Process on page 86 Using WiseUpdate in an Installation on page 87 Options for Running WiseUpdate Client on page 91 WiseUpdate Tips on page 92 Troubleshooting WiseUpdate on page 93 About WiseUpdate...

  • Page 86: The Wiseupdate Process

    Using WiseUpdate The WiseUpdate Process WiseScript Package Editor only Phase 1: Your Computer Your Web Server (FTP/HTTP): Contains the WiseUpdate When you first use WiseUpdate, you: update file that stores: 1. Develop the installation The current version number 2. Configure WiseUpdate and URLs to the installation files (FTP) specify:...

  • Page 87: Using Wiseupdate In An Installation

    Using WiseUpdate Using WiseUpdate in an Installation WiseScript Package Editor only To use WiseUpdate® effectively, you must use it in two or more successive versions of your application. Using it in one version of your application only enables that version to check for later versions over the Internet.
  • Page 88 Using WiseUpdate the fields on this page specify information to be embedded inside WiseUpdate Client. This information tells the client when, how, and where to check the Web location for new versions. The first time you configure WiseUpdate, you enable that version to check for later versions over the Internet.

  • Page 89: About The Wiseupdate Update File

    Using WiseUpdate the end user logs on to Windows. If the check interval has been reached, WiseUpdate Client runs normally, prompting the end user to check for updates. If the check interval has not been reached, WiseUpdate Client runs silently and quits.

  • Page 90: Uploading Wiseupdate Files With An Ftp Client

    Using WiseUpdate Uploading WiseUpdate Files With an FTP Client WiseScript Package Editor only Use an FTP client to upload the following items to the Host Address and Host Directory you specified on the WiseUpdate page: The compiled installation file or files. An optional Readme file.

  • Page 91: Options For Running Wiseupdate Client

    Using WiseUpdate To test how WiseUpdate works when an update is needed To make the application on the server appear to be a later version: On your development computer, on the WiseUpdate page, enter a later product version. (Example: If the original version was 1.0.0, enter 1.0.2) Compile the installation to create a new update file.

  • Page 92: Wiseupdate Tips

    Using WiseUpdate Run WiseUpdate Client when the application is run. To use the check interval value from the WiseUpdate page, run WiseUpdate Client with the /c command-line option. Then WiseUpdate Client silently checks the time elapsed since it last ran. If the number of days elapsed is greater than the check interval value, WiseUpdate Client prompts the end user to check for updates.

  • Page 93: Troubleshooting Wiseupdate

    Using WiseUpdate Why are there two different fields that accept the product version? During the WiseUpdate process, you encounter two different fields that require a product version. How are these fields related? The Version field on the Product Details page sets the version for the application, and is used by Windows Installer to determine whether updates and patches are valid upgrades for the installed version.

  • Page 94: Chapter 6: Using Script Editor

    Chapter 6 Using Script Editor This chapter includes the following topics: About Script Editor on page 94 The Script Editor Window on page 95 Types of Scripts on page 97 Adding an Action to a Script on page 99 Editing Scripts on page 99 About User-Defined Actions on page 101...

  • Page 95: The Script Editor Window

    Using Script Editor Product Details page, you enter InstallationName in the Installation Title field. The following line is generated in the script: Set Variable APPTITLE to InstallationName.) The Script Editor Window The Script Editor window contains all the tools necessary to develop and edit WiseScripts.
  • Page 96 Using Script Editor Language From this drop-down list, you select a language for the WiseScript. This drop-down list includes all the languages that are supported in the installation. You specify the supported languages on the Languages page. Languages on page 58. When you add a script line or custom dialog box that presents text to the end user, select each language in the Language drop-down list, and edit that script line so it contains the translated text.

  • Page 97: Customizing The List Of Actions

    Using Script Editor Connection lines connect the beginning and end of an If block or a loop. To show or hide connection lines, select View menu > Connection Lines. Customizing the List of Actions Script Editor contains four default action groups: All Items, SVS Items, Favorites, and Custom.
  • Page 98 Using Script Editor Exit The script that’s executed when the installation is complete, or when an Exit Installation script command is executed. If you create a user-defined action, you store its custom dialog box here. Creating a User-Defined Action on page 102. Cancel The script that’s executed when the end user cancels the installation.

  • Page 99: Adding An Action To A Script

    Using Script Editor Adding an Action to a Script in Script Editor, do any of the following: From the Actions list in the left pane, drag an action onto a line in the Installation Script list in the right pane. The new action appears above the line that is highlighted when you drop the action.

  • Page 100: Finding And Replacing Text In A Script

    Using Script Editor You cannot open multiple scripts in the same instance of WiseScript Package Editor unless it is an include script or VBScript. However, you can open multiple instances of WiseScript Package Editor, and open different scripts in each. Customizing the List of Actions on page 97.

  • Page 101: Checking For Duplicate Files In Include Scripts

    Using Script Editor Checking for Duplicate Files in Include Scripts WiseScript Package Editor only In Script Editor, you can check WiseScripts for the existence of duplicate files. Files are considered duplicates if their source paths are identical. You might have duplicate files if your main script contains Install File(s) script lines, and the same file is referenced in both the main script and the include script.

  • Page 102: Creating A User-Defined Action

    Using Script Editor Dialog Box Include a dialog box only if your action has parameters that you must change each time you use the action. This dialog box appears when your action is double-clicked. Example: For an action that opens a URL in the in the destination computer’s browser, you might include a dialog box that asks for the URL.

  • Page 103: Creating A User-Defined Action: Tutorial

    Using Script Editor Add script lines that perform the function of your user-defined script action. This might be something as simple as a single line that calls a .DLL, or it could be a complex set of script lines that perform an advanced function. In Title, enter a combination of text and variables to define the format of the script line.
  • Page 104 Using Script Editor To create a dialog box for the action From Event, select Exit. To write a script action that interacts with the developer who uses it, you must add a Custom Dialog script line, which you must store in the Exit script. A user-defined action requires a dialog box only if it has parameters that you need to change when you use the action.
  • Page 105 Using Script Editor 13. When you finish editing the dialog box, select File menu > Save Changes and exit. To create a script for the action For the Wait action, you write a very simple script. The script calls kernel32.dll, a Windows system .DLL that contains a function that stops execution of the current application for the specified number of milliseconds.

  • Page 106: Using The Debug Commands

    Using Script Editor Wait 9000 Milliseconds 9000 milliseconds equals nine seconds. Save the script. Click Test to test your script. After the blue screen appears, there should be a nine-second delay before the Welcome dialog box appears. If the action does not work, check the options you entered for the Call DLL statement. If it still doesn’t work, open the Pause.wse file located in the Actions directory and view its parameters.

  • Page 107: Building A Debug Version

    Using Script Editor Edit the script errors as they occur rather than waiting for the installation to finish. Do this by double-clicking the script action or by using any of the other methods for changing a script that are available in Script Editor. About Script Editor on page 94.
  • Page 108 Using Script Editor Variable Name Enter _DEBUG_ Default Value Enter NO Description Enter “Compile debug version of this installation?” Value List Enter YES on the first line and NO on the second line. Data Entry Type Select List of values (single-select). Do Not Prompt for Value Make sure this is cleared.

  • Page 109: Basic Scripting Concepts

    Using Script Editor Using the Debug Commands on page 106 Basic Scripting Concepts If you do not have a basic understanding of scripting concepts, you should become familiar with them before trying to write a WiseScript. See: About Script Editor on page 94 Conditions and Loops on page 109...

  • Page 110: Variables And Expressions

    Using Script Editor action that does not already have an End action. You can nest conditions and loops to many levels, but in most circumstances it won’t be necessary to nest more than three or four levels deep. The indentation, which increases for each nested structure, helps you interpret deep nestings.

  • Page 111: Compiler Variables And Run-Time Variables

    Using Script Editor Variable, or a Wizard Loop action to evaluate an expression, do not surround the variables you reference in the expression with %.) Do surround compiler variables with % characters no matter where you enter them. Some actions (If, While, Set Variable, and some others) can use a more flexible scheme that lets you use arithmetic expressions and other options.

  • Page 112: Anatomy Of An Installation Script

    Using Script Editor Using Compiler Variables If an Install File(s) action is included inside a Compiler Variable If block, the file it installs is not added to the installation .EXE if the condition is false. Compiler Variables on page 44. Example: You can create a script that compiles an installation .EXE for either a 16-bit or 32-bit version of your application based on the value of a compiler variable and includes only the files needed by each version of the application.

  • Page 113: About Components

    Using Script Editor System Configuration After files are installed, the destination computer’s configuration files (.INI files, registry, Start menu, etc.) are updated so that the new application works correctly. The end user might then be prompted to restart their computer. About Components WiseScript Package Editor only When an end user selects to install one or more optional components, a letter...

  • Page 114: Chapter 7: Wisescript Actions

    Chapter 7 WiseScript Actions This chapter includes the following topics: About WiseScript Actions on page 117 About SVS Script Actions on page 117 Activate SVS Layer on page 119 Add Directory to PATH on page 119 Add File to SVS Layer on page 119 Add Text to INSTALL.LOG on page 120...
  • Page 115 WiseScript Actions Custom Dialog on page 145 Deactivate SVS Layer on page 145 Delete File from SVS Layer on page 146 Delete File(s) on page 146 Delete SVS Layer on page 147 Display Billboard on page 147 Display Message on page 148 Display Progress Message on page 149 Display Text File...
  • Page 116 WiseScript Actions Insert Line Into Text File on page 173 Install File(s) on page 174 Install SVS Package on page 176 Install Windows Mobile Application on page 179 Install WiseUpdate Client on page 177 Modify Component Size on page 180 Open/Close Install.log on page 181 Parse String...

  • Page 117: About Wisescript Actions

    SVS Items title bar. For more information about Software Virtualization Solution (SVS), search for Workspace Virtualization on the symantec.com Web site. Note If you create or edit a Virtual Software Package (VSP) in Virtual Package Editor, you would normally not use the SVS script actions when you add WiseScripts on the Events page.
  • Page 118 WiseScript Actions Deactivate SVS Layer Delete SVS Layer Export SVS Layer Get SVS Layer Info Import SVS Layer Install SVS Package Set Activate SVS Layer on Start Script Actions for Editing a Layer Use these script actions to edit the files, registry keys, directories, name, or GUID of a layer.

  • Page 119: Activate Svs Layer

    WiseScript Actions Script Action for Initializing SVS The Initialize SVS script action initializes the SVS Driver (Software Virtualization Agent) so that you can communicate with it. It is part of all of the SVS specific actions. If you create a user-defined, SVS-specific action, begin the action with this action. Also see the article Using WiseScripts to Manage and Update Virtual Software Packages in the Altiris Knowledgebase (article 27373).

  • Page 120: Add Text To Install.log

    WiseScript Actions To complete the dialog box Layer GUID Enter the layer’s GUID (globally unique identifier) or a variable that represents the layer’s GUID. If you enter the layer’s GUID, do not include the { } brackets. For information on creating a variable for a layer’s GUID, see Create SVS Layer page 144 and Find SVS Layer GUID...

  • Page 121: Add To Autoexec.bat

    WiseScript Actions To complete the dialog box Log Text Enter the text to be added to the log file. You can enter variables surrounded by %. To see the format of lines, open existing log files. Examples By default, uninstall does not remove files that were installed to Windows, Windows\System, or Windows\System32.

  • Page 122: Add To Config.sys

    WiseScript Actions To complete the dialog box Text to Insert Enter the line to add to Autoexec.bat. If the line refers to an application file, use a path (example: %MAINDIR%\Application\Application.exe). The PATH variable might not be set when the command is executed, so always use a path. Line Number Enter the line number at which the new line should be inserted.

  • Page 123: Add To System.ini

    WiseScript Actions Search for Text Enter the text to search for here. The installation scans Config.sys looking for a line that begins with, ends with, or contains the text, depending on the setting of the Match Criteria field. The line is inserted at the first found match. Comment Text Enter text to insert at the beginning of the line that is found.

  • Page 124: Call Dll Function

    WiseScript Actions To complete the dialog box Window Name Enter the title for the dialog box. Description Enter text to explain the dialog box to the end user. Prompt Name Enter explanatory text to be displayed above the directory field. Default Value Enter the default location of the new directory.
  • Page 125 WiseScript Actions Each .DLL function takes a single parameter (lpDllParams) that points to a structure containing information that can be passed back and forth between the .DLL function and the running installation script. Variables Added Because WiseScript-specific .DLL functions have access to the variable list of the running installation, you can add new variables.

  • Page 126: Dll Parameter Settings

    WiseScript Actions Hide progress bar before calling function If the .DLL has UI, you can us this to hide the progress bar. If you write a .DLL, use CALLBACK or WINAPI in the declaration of the .DLL. For help with .DLL development, review sample source code, such as GETCPU32.C, in the DLL subdirectory of this product’s installation directory.
  • Page 127 WiseScript Actions WiseScript Corresponds to Win32 Corresponds to Description SDK type Visual Basic type dword pointer Pointer to DWORD or Long 32-bit pointer to a DWORD data type DWORD* (use for LPDWORD (see DWORD for the reference to this or PDWORD) data type) string buffer char [size]...

  • Page 128: Passing Complex Structures To A .Dll: An Example

    WiseScript Actions Passing Complex Structures to a .DLL: An Example You can use a Call DLL Function to call a .DLL. In addition to passing simple parameters, such as integers and strings, to a .DLL, you can also pass complex structures (sometimes called records in Pascal or Visual Basic).

  • Page 129: Capture Application To Svs Layer

    WiseScript Actions Parameter in the C function Parameter type in Passing Type in WiseScript WiseScript title (third element of string buffer Contained within EMPLOYEE structure) structure (buffer length of 50) long Normal deptname (first element of string pointer First element of a DEPARTMENT structure) structure deptnum (second element of...

  • Page 130: Change Svs Layer Guid

    WiseScript Actions Change SVS Layer GUID This SVS script action changes a layer’s GUID. Example: You can use this action to create a copy of a layer that is seen by SVS as a different layer. This is similar to changing the ProductCode and PackageCode of an .MSI file.

  • Page 131: Check Disk Space

    WiseScript Actions Display Message Only Abort Installation Start Block Begins a conditional block. All actions between this action and the next Else or End action are executed. Title Enter the title for the dialog box. Message Text Appears in the body of the message dialog box. Leave this blank to prevent a message from appearing.
  • Page 132 WiseScript Actions Status Variable Select or enter the variable to store the result of the disk space check. If there is not enough disk space, an error message is displayed, and the end user can halt installation, ignore the error, or retry the disk space check. Status Variable is set to R if the end user chooses to retry, which lets you define what retrying means.

  • Page 133: Check Http Connection

    WiseScript Actions Insert a Check Disk Space action and, in the Check Disk Space Settings dialog box, enter COMPONENTS in the Component Variable field. Add an If Statement action that determines if the variable COMPONENTS equals Plus.exe, and then use an Install File(s) action to install the license file. The script would look like this: Evaluate Windows Installer Condition "$Plus.exe=3"...

  • Page 134: Check If File/Dir Exists

    WiseScript Actions Win32 Error Text Variable Select or enter a variable to store the error text returned by the 32-bit winsock.dll. Win32 Error Number Variable Select or enter a variable to store the error code returned by the 32-bit winsock.dll. Win16 Error Text Variable Select or enter a variable to store the error text returned by the 16-bit winsock.dll.

  • Page 135: Check In-Use File

    WiseScript Actions Perform loop at least once If you chose Start While Loop, mark this to force the loop to execute once before the test is performed. If the check box is cleared, the loop is executed if the condition is true, but is not executed if the condition is false. The sample script Newdisk.wse uses this action.

  • Page 136: Config Odbc Data Source

    WiseScript Actions Example: On the Compiler Variable page, create a compiler variable named _DEBUG_ with a default value of “N”. Mark the Compiling From Within Wise option. In the installation script, add a Compiler Variable If action that checks if _DEBUG_ equals “Y”.

  • Page 137: Copy Local File(S)

    WiseScript Actions To complete the dialog box Data Source Name This name will be displayed in the ODBC data sources list on the destination computer. The Import button adds an ODBC data source from your computer and populates the fields. Driver Name Enter the name of the ODBC driver used by this data source.
  • Page 138 WiseScript Actions Path. Specifying a wildcard in both the Source field and the Local Path field results in a compile error. If you don’t need the progress bar to update correctly, use wildcards in Source (example: %INST%\Pictures\*.jpg), specify a directory in Destination, and leave Local Path blank.

  • Page 139: Create Directory

    WiseScript Actions Replace Existing File Select when to replace existing files on the destination computer. Always The new file always replaces the old file. Never The file never overwrites an existing file. Select this for files that should be installed if they are not present, but that might be customized by the end user and should therefore not be replaced on re-installation (example: configuration files).

  • Page 140: Create Directory In Svs Layer

    WiseScript Actions To complete the dialog box Pathname Enter the directory path to create. Start the path with a variable (example: %MAINDIR%). Create Directory in SVS Layer This SVS script action creates a directory in a virtual software layer. You can create a directory in an existing layer or in the layer that the WiseScript creates.
  • Page 141 WiseScript Actions Display Name Enter the name to appear in the Services control panel. Executable Path Specify the complete path to the executable file as it will be on the destination computer. Start the path with a variable (example: %MAINDIR%). Login Username, Login Password Enter the user name and password under which the service should run.

  • Page 142: Create Shortcut

    WiseScript Actions Create Shortcut This action creates a shortcut. Common locations include the Start menu (%STARTMENUDIR%), the Startup directory (%STARTUPDIR%), the installation directory (%MAINDIR%), and the desktop (%DESKTOPDIR%). When a WiseScript is called by a Windows Installer installation, you also can create a shortcut on the Features or Components tabs of Setup Editor in Windows Installer Editor.

  • Page 143: Create Shortcut In Svs Layer

    WiseScript Actions Support OSD software update checking Open Software Description (OSD) is a Microsoft technology for describing and distributing software. Mark this for the shortcut to work with OSD. Check self-repair items when this shortcut is opened (WiseScript Package Editor only) If you configured the installation for self-repair., mark this to turn on self-repair functionality for this shortcut.

  • Page 144: Create Svs Layer

    WiseScript Actions Description Enter text to appear in the Comment field of the shortcut’s properties dialog box. Icon Path (Optional) Specify the file that contains the icon to be used for the shortcut. Otherwise, the target file’s icon is used. Icon Number Enter the number of the icon to use from the file specified in Icon Pathname above.

  • Page 145: Custom Billboard

    WiseScript Actions To complete the dialog box Computer name Enter the name of the computer where the virtual directory is to be created. Web site name Enter the name of a new or existing Web site. Virtual directory name Enter a name for the new virtual directory. Virtual directory path Enter the path for the virtual directory on the destination computer.

  • Page 146: Delete File From Svs Layer

    WiseScript Actions Delete File from SVS Layer This SVS script action deletes a file from a virtual software layer. This adds the file to the delete entries list so that it doesn’t appear when the layer is activated. If you reset the layer, the file is restored because the deletion entry is in the writeable sublayer of the delete entries.

  • Page 147: Delete Svs Layer

    WiseScript Actions Remove Directory Containing Files If this is marked, and if the deletion leaves the directory empty, then the directory is deleted also. If you mark this check box and Include Sub-Directories, and you do not include a file in the path, then all other empty subdirectories are deleted also. To prevent deletion of the other subdirectories, add a trailing backslash to the path.

  • Page 148: Display Message

    WiseScript Actions Erase Num Enter how many previously displayed graphics are erased before this graphic is displayed. To display one graphic at a time, set this to 1. To display all graphics simultaneously, set this to 0. The oldest graphic is removed first. Build Effect Select a transition effect.

  • Page 149: Display Progress Message

    WiseScript Actions Message Text This is displayed in the dialog box. Press Ctrl+Enter to add line breaks in the displayed text. You can use variables in this text. Message Icon Select an icon for the dialog box. Start If Block Mark this to display Yes, No, and Cancel buttons instead of OK and Cancel.

  • Page 150: Display Text File

    WiseScript Actions Display Text File This action displays a 30 K or smaller text file in a dialog box. It is included to provide backward compatibility for older WiseScripts. In WiseScript Package Editor, use the ReadMe dialog box on the Dialogs page to display the ReadMe file in new scripts.

  • Page 151: Edit Registry

    WiseScript Actions Comments (lines starting with ;) are not supported. See also: INI Files on page 56 Edit Registry This action adds, edits, or deletes registry keys or values. You can create registry entries manually or import a registry file (.REG). In WiseScript Package Editor, use the Registry page to copy registry settings from your computer’s registry.

  • Page 152: Registry Key Settings Dialog Box

    WiseScript Actions Delete Value Removes the selected value from the current installation. This does not remove it from the destination computer. To do that, you must change the Operation field in the value’s details dialog box. Data Settings These fields in this section of the dialog box correspond to fields you set when creating the value.
  • Page 153 WiseScript Actions Value Name Enter the name of a new named value. Data Value The data for the value. If the Data Type (below) is Double Word (DWORD), the data should be in decimal notation. To insert multiple lines of data here, press Ctrl+Enter to begin a new line.

  • Page 154: Edit Registry For Svs Layer

    WiseScript Actions Edit Registry for SVS Layer This action adds, edits, or deletes registry keys or values in an SVS Layer. You can create registry entries manually or import a registry file (.REG). Note Use this action on a deactivated SVS layer only. To complete the dialog box Registry Keys This field shows root registry keys and the keys added by this action.

  • Page 155: Else Statement

    WiseScript Actions See also: About SVS Script Actions on page 117 Else Statement This action marks the beginning of a section of instructions to be executed when the condition specified in the matching If action is false. It takes no parameters, and selecting it from the Actions list inserts it directly into the script with no further dialog boxes or prompts.

  • Page 156: Evaluate Windows Installer Condition

    WiseScript Actions Note This is different from the End Statement action that is in MSI Script in a Windows Installer installation. See also: If Statement on page 170 Evaluate Windows Installer Condition This action evaluates a condition in the currently-running Windows Installer installation. You enter a Windows Installer condition and select a WiseScript variable to store the result.

  • Page 157: Execute Vbscript

    WiseScript Actions Default Directory Specify the directory that should be current when the .EXE file is executed. The installation performs the equivalent of a Change Directory command (cd) before running the .EXE. Click Browse and select a directory from your installation. You can select from directories that you created using the Create Directory action.

  • Page 158: Editing A Vbscript

    WiseScript Actions To complete the dialog box VB Script Path Specify the full path to a .VBS file including the file name. To create a new .VBS file, specify its full path including the file name and click Yes when prompted to create a new file.

  • Page 159: Debugging A Vbscript

    WiseScript Actions Right-Click Menu Options List Objects Displays a drop-down list of predefined objects and, when possible, objects that are called in the script. For details on when called objects appear in this drop-down list, see VBScript Actions on page 159. List Properties/Methods Displays, when possible, a drop-down list of the properties and methods of an object when the cursor is on that object’s property or method.
  • Page 160 WiseScript Actions Adding an Action to a Script on page 99. Call COM Object Use this action to create a script to call a COM object in the VBScript. You can manually enter the script to call a COM object, but the Call COM Object action facilitates this process by providing information about the COM objects.

  • Page 161: Calling A Com Object In A Vbscript

    WiseScript Actions Calling a COM Object in a VBScript When you use the Execute VBScript action in a WiseScript, a new tab appears at the bottom of the Installation Script pane. When you click this tab, the VBScript window appears. In the VBScript, you can call a COM object and then use the functions and properties that are exposed by this object.

  • Page 162: Exit Installation

    A status for the installation is added to the Status MIF file. Export SVS Layer This SVS script action exports a virtual software layer from the Symantec SVS applet as a virtual software archive (.VSA) file. The .VSA file is portable file that you can deploy to other computers.

  • Page 163: Find File In Path

    WiseScript Actions Return variable (Optional.) Enter a name for the return variable. When this script action runs successfully, either 0 or 1 is placed in this variable. Overwrite archive file if it already exists Mark this to overwrite the archive file if it already exists. See also: About the Altiris SVS Applet in the Virtual Package Editor Help About SVS Script Actions...

  • Page 164: Find Next Svs Layer

    WiseScript Actions To complete the dialog box Layer GUID Variable Enter a name for a variable in which to place the layer’s GUID. Return variable (Optional.) Enter a name for the return variable. When this script action runs successfully, either 0 or 1 is placed in this variable. See also: About SVS Script Actions on page 117...

  • Page 165: Get Environment Variable

    WiseScript Actions Get Environment Variable This action puts the value of a Windows environment variable into a WiseScript variable. To complete the dialog box Env. Variable Enter a Windows environment variable. Variable Name Enter a variable to store the value of the environment variable. Default Value (Optional) Enter the value to store in the variable if the environment variable is not found.

  • Page 166: Get Registry Key Value

    WiseScript Actions See also: Dialogs on page 46 Get Registry Key Value This action puts the value of a registry key into a variable. Multi-line (MULTI_SZ) registry values are read into a list format. To complete the dialog box Variable Name Select or enter a variable to store the value.

  • Page 167: Get System Information

    If the layer is deactivated when the computer starts, 1 is placed in this variable. If the layer is activated when the computer starts, 2 is placed in this variable. Layer Name Variable The name of the layer as it appears in the Symantec SVS applet is placed in this variable. Layer Type Variable If the layer is read-only, 0 is placed in the variable.
  • Page 168 WiseScript Actions DOS Version Example: 6.22 K Bytes Physical Memory The amount of physical RAM. File Date/Time Modified The time and date on which the file that is specified in Pathname was modified. File Version Number The version of the file that is specified in Pathname. Example: 2.5.4.0 If the file does not have a version resource, the response is blank.

  • Page 169: Get Temporary Filename

    WiseScript Actions File Date/Time Modified (four-digit year) Same as File Date/Time Modified above except a different format. Example: 07/14/2005 11:18:10 Disk Free Space (KBytes) Free disk space of the drive that is specified in Pathname. In Pathname, enter a drive (C:\) or a path (%MAINDIR%\Readme.txt). If you enter a path, it returns the free space on the drive that the path refers to.

  • Page 170: Halt Compilation

    WiseScript Actions To complete the dialog box Dest. Variable Select or enter a variable to store the value of a Windows Installer property. Property Name Enter the name of the Windows Installer property in the currently running Windows Installer installation. See also: Set Windows Installer Property on page 197...

  • Page 171: Import Svs Layer

    WiseScript Actions variable is ignored and can be left blank. The result is considered true if it evaluates to a non-zero result. (The password comparisons are applicable in WiseScript Package Editor only.) The Value Enter the value to be used in the comparison, or an expression if the comparison is set to Expression True.

  • Page 172: Include Script

    WiseScript Actions Include Script This action adds an additional script to the current installation script. During compile, the include script is copied into the calling script at the location of the Include Script action, resulting in a combination of the scripts. Include scripts can save time because you can develop a library of WiseScripts that perform specific functions, like subroutines.

  • Page 173: Insert Line Into Text File

    WiseScript Actions Insert Line Into Text File This action edits a text file on the destination computer. Use it to edit configuration files that cannot be edited by Edit INI File, Add Device to System.ini, Add Command to Config.sys, or Add Command to Autoexec.bat. You can insert a new line at a particular line number, or you can search for text and insert a new line before, after, or in place of the line where the text was found.

  • Page 174: Install File(S)

    WiseScript Actions Install File(s) This action installs files on the destination computer. Each file or directory to be installed must have a separate Install File(s) action. In WiseScript Package Editor, it is easiest to use Installation Expert to add most files, and to use Script Editor to add or edit a few Install File(s) lines.
  • Page 175 WiseScript Actions No Progress Bar To hide the progress bar, mark this for every file in the installation. If you mark it for some files, but not others, the progress bar seems to display continuously because the screen does not refresh between files. Self-Register OCX/DLL/EXE/TLB All .OCXs and .TLBs and some .DLLs and .EXEs support self-registration.

  • Page 176: Install Svs Package

    WiseScript Actions Older For File Version, this replaces the existing file if it has a version resource that is older than the new file. If the existing file lacks a version resource, it is not replaced. For File Date/Time, this replaces the existing file if its modification date and time are older than the new file.

  • Page 177: Install Wiseupdate Client

    WiseScript Actions Activate Layer Check this to activate the layer after it is imported on the end user’s computer. We recommend that you check this unless you have a specific reason to not activate the layer when it is imported on the end user’s computer. Bind this WiseScript to the .WVP release When you check this, the name of the current WiseScript file appears by default in Release Name, and this WiseScript is added as a release to the .WVP file’s...

  • Page 178: About Windows Mobile Installations

    WiseScript Actions About the WiseUpdate Update File on page 89. Product Version Enter the version of the current installation. This version will be stored in the configuration file specified in Update Filename. Check Interval (days) This works in conjunction with the Add client to Startup Group check box (see below).

  • Page 179: Process For Adding Mobile Device Support To A Wisescript

    WiseScript Actions The end user copies the .CAB file to the mobile device and opens it. The .CAB file extracts its contents to the directories that were specified in the .INF file. Uninstall of the mobile device application is controlled by the mobile device and ActiveSync.

  • Page 180: Modify Component Size

    WiseScript Actions Description This appears on the Add/Remove Programs dialog box on the desktop computer. Installation Files section Specify up to three .CAB files to install. Desktop Shortcut section If installation onto the mobile device will not take place immediately following the desktop installation, then use the following fields to create a shortcut on the desktop computer.

  • Page 181: Open/Close Install.log

    WiseScript Actions Open/Close Install.log Use this action to create an installation log. Normally, every file that is installed is recorded in the install.log. The uninstall works by reading Install.log from bottom to top and reversing each recorded action. The Open/Close Install.log action lets you customize the uninstall, by turning logging off and on at key points to prevent some actions from being recorded in the log.

  • Page 182: Pause

    WiseScript Actions left, then “ONE,” is put into the destination variable 1 and “TWO” is put into the destination variable 2. To complete the dialog box Source Value Enter the text to be parsed. You enter text and variables (examples: %MAINDIR% or %MAINDIR%\%PICTDIR%).

  • Page 183: Post To Http Server

    WiseScript Actions To complete the dialog box File Type Select either .WAV or .AVI. Pathname Specify the path to the .WAV or .AVI file. Start this field with a variable (example: %MAINDIR%\Movie.avi). If the multimedia file is used only during installation, you can use the Get Temporary Filename action to obtain a random file name, then install the file to %TEMP%\%TEMPFILENAME%.

  • Page 184: Prompt For Filename

    WiseScript Actions Start Block The Post to HTTP Server action begins a conditional block. The statements between this action and the next End statement are executed only in the event of an error. Prompt for Filename This action prompts the end user to select a file using a standard Open or Save dialog box.

  • Page 185: Prompt For Text

    WiseScript Actions Display prompt if overwriting existing file Mark this to display a message if a file selected by the end user already exists. Prompt for Text This action displays a dialog box that lets an end user enter a line of text. Optionally, you can treat the entered text as a path and do verification on it.

  • Page 186: Read Ini Value

    WiseScript Actions Description Enter explanatory text to be displayed above the radio buttons. Press Shift+Enter for a carriage return. Component List Enter the choices, one on each line, pressing Enter after each. Read INI Value This action reads an entry from an existing .INI file into a variable. Example: Obtain a path to a file.

  • Page 187: Read/Write Binary File

    WiseScript Actions Variable Specify the variable in which to store each line of the text file (example: TEXTLINE). Action Select an action: Read lines of file into variable Reads a line into the variable, but does not write it back to the original file. Update file with new contents of variable Reads a line into the variable, and at the end of the loop, writes the contents of the variable back to the line in the text file.

  • Page 188: Reboot System

    WiseScript Actions Transfer Direction Select whether to write to or read from the file. Null Terminated If this check box is marked, a zero byte is written to the binary file after the string. Reboot System This action restarts the destination computer. To complete the dialog box Reboot Operating System This option logs the end user out of Windows.

  • Page 189: Remove Svs Exclude Entry

    WiseScript Actions Remove SVS Exclude Entry This SVS script action removes an SVS exclude entry on the destination computer. You can remove a layer exclude entry or a global exclude entry. A layer exclude entry applies to a specific layer on a computer, while a global exclude entry applies to every layer on a computer.

  • Page 190: Rename File Or Directory In Svs Layer

    WiseScript Actions New File Name Enter the new file name or directory name (examples: picture2.jpg or Photos). Rename File or Directory in SVS Layer This SVS script action renames a file or directory a virtual software layer. This can be an existing file or directory, or a file or directory that the WiseScript installs.

  • Page 191: Search For File

    WiseScript Actions New name Enter the new name for the virtual software layer. Return variable (Optional.) Enter a name for the return variable. When this script action runs successfully, either 0 or 1 is placed in this variable. See also: About SVS Script Actions on page 117 Search for File...

  • Page 192: Self-Register Ocxs/Dlls

    WiseScript Actions The sample script Search.wse uses this action. For details on sample scripts, see ScriptHelp.htm in the Samples subdirectory of this product’s installation directory. Self-Register OCXs/DLLs Use this action to self-register all queued .OCX, .DLL, and .EXE files or to add an existing file to the queue.

  • Page 193: Set Control Text

    WiseScript Actions To access this action Double-click a Custom Dialog script line. The dialog box appears in the Custom Dialog Editor. Select View > Dialog Script Editor. A smaller list of actions appears in the Actions list, including this action. Double-click Set Control Attributes.

  • Page 194: Set Current Control

    WiseScript Actions Set Current Control This action appears only when you are in a dialog box script. This action sets a control to be the current control in a dialog box. The current control is the one to which keyboard operations apply. (Example: If the OK button is the current control, and you press Enter, the OK button is activated.) Controls without names cannot be manipulated with this action.

  • Page 195: Set Svs Exclude Entry

    WiseScript Actions To complete the dialog box Minimum Files The minimum number of files to be specified by FILES= in Config.sys. Set this to zero or leave blank to leave FILES= unchanged. Minimum Buffers The minimum number of buffers to be specified by BUFFERS= in Config.sys. Set this to zero or leave blank to leave BUFFERS= unchanged.
  • Page 196 WiseScript Actions To complete the dialog box Variable Specify a variable. A variable name must begin with a letter, must contain only numbers, letters, and underscore characters, and must be 28 characters or less. It should not be enclosed in % signs. New Value Enter the new value of the variable.

  • Page 197: Set Web Permissions

    WiseScript Actions Set Web Permissions This script action sets permissions for an existing virtual directory of a Web site or a virtual directory that you create with the Create Virtual Directory script action. Create Virtual Directory on page 144. To complete the dialog box Computer Enter the name of the computer where the Web site resides.

  • Page 198: While Statement

    WiseScript Actions When a WiseScript is called by a Windows Installer installation, you can also start and stop services by using the Services page in Windows Installer Editor. After you try to stop a service, the script pauses to give the service time to stop. The currently logged-in end user must have the appropriate privileges to start and stop services.

  • Page 199: Win32 System Directory

    WiseScript Actions Below the While Statement, add one or more actions to perform if the variable has the specified value. Add an End Statement. The sample scripts Division.wse and Application kill.wse use this action. For details on sample scripts, see ScriptHelp.htm in the Samples subdirectory of this product’s installation directory.
  • Page 200 WiseScript Actions Expression True means the expression in the Value field below is evaluated according to the rules outlined in Variables and Expressions on page 110. The variable is ignored and can be left blank. The result is considered true if it evaluates to a non-zero result.

  • Page 201: Chapter 8: Creating Custom Dialog Boxes

    Chapter 8 Creating Custom Dialog Boxes This chapter includes the following topics: About Dialog Boxes on page 201 About the Custom Dialog Editor on page 201 About Dialog Box Controls on page 205 Solutions for Dialog Box Problems on page 224 About Custom Dialog Box Sets on page 226 Creating a Custom Dialog Box Script...

  • Page 202: Adding A Dialog Box To The Installation

    Creating Custom Dialog Boxes Set dialog box properties Setting Dialog Box Properties on page 204. Create a dialog box set About Custom Dialog Box Sets page 226. Add interactivity to dialog boxes Creating a Custom Dialog Box Script page 227 Access the Custom Dialog Editor from: Installation Expert Click the Edit or Add button on the Dialogs page.

  • Page 203: Editing Dialog Boxes

    Creating Custom Dialog Boxes About Dialog Box Controls on page 205 Adding and Editing Dialog Box Controls on page 206 Select File menu > Save Changes and exit. Note To use this dialog box in other installation scripts, select File menu > Save As and save the dialog box as a .DLG file in the \Dialogs\Template subdirectory of this product’s installation directory.

  • Page 204: Setting Dialog Box Properties

    Creating Custom Dialog Boxes The dialog box opens in the Custom Dialog Editor. Make changes to the dialog box by adding, editing, or removing controls. Adding and Editing Dialog Box Controls on page 206 Aligning and Spacing Dialog Box Controls on page 222 Select File menu >...

  • Page 205: About Dialog Box Controls

    Creating Custom Dialog Boxes About Dialog Box Controls Installation dialog boxes contain standard controls, which you can add and edit. Most controls are configured by completing their Settings dialog box. Adding and Editing Dialog Box Controls on page 206. You can add the following types of controls to dialog boxes: Check box A single check box for on/off, true/false settings.

  • Page 206: Adding And Editing Dialog Box Controls

    Creating Custom Dialog Boxes Text Control Static text field for displaying messages. The end user cannot change text in this type of field. Adding Text Controls on page 220. The sample scripts that use custom dialog boxes all use dialog box controls. For details on sample scripts, see ScriptHelp.htm in the Samples subdirectory of this product’s installation directory.

  • Page 207: Adding Combo Box Controls

    Creating Custom Dialog Boxes Variable Specify the name of the script variable that stores the return value of this dialog box control. Note If you set the variable to a string containing one or more lowercase letters, the corresponding options are unavailable in the radio button control when it appears on the dialog box.
  • Page 208 Creating Custom Dialog Boxes Note When you place a combo box, you must resize the bounding box so that it is taller than the visible combo box. Otherwise, the drop-down list fails to drop down when the installation runs. Open the dialog box in the Custom Dialog Editor. Editing Dialog Boxes on page 203.

  • Page 209: Adding Edit Text Controls

    Creating Custom Dialog Boxes Drop List. Drop-down list that only allows selection from the list. Control Name Enter the name by which you will refer to this control in the dialog box script. Leave this blank if you will not manipulate this control with a script. X-Position / Y-Position Specify the exact location of the control on the dialog box.
  • Page 210 Creating Custom Dialog Boxes Auto HScroll Mark this to scroll the text if it extends past the right edge of the edit field. Auto VScroll Mark this to scroll the text if it extends past the bottom of the edit field. Multi-line Mark this to allow multiple lines of text to be entered into the edit field.

  • Page 211: Adding Graphic Controls

    Creating Custom Dialog Boxes Note A dialog unit is based on the size of the dialog font, usually 8-point MS Sans Serif. A horizontal dialog unit is 1/4 the average width of the font and a vertical dialog unit is 1/8 the average height of the font. Width / Height Specify the exact dimensions of the control in dialog units.

  • Page 212: Adding Group Box Controls

    Creating Custom Dialog Boxes Adding Group Box Controls A group box encloses a group of related controls with a rectangle. Example: The Placement section on the Group Box Control Settings dialog box is a group box. Open the dialog box in the Custom Dialog Editor. Editing Dialog Boxes on page 203.
  • Page 213 Creating Custom Dialog Boxes Variable Specify the name of the script variable that stores the return value of this dialog box control. Value Enter the value that gets assigned to the variable if this button is clicked. This can be useful in a script when you need to know which hot text the end user clicked.

  • Page 214: Adding List Box Controls

    Creating Custom Dialog Boxes Underline Enabled Text Mark this to underline the hot text when the end user moves the mouse pointer over the text. X-Position / Y-Position Specify the exact location of the control on the dialog box. You can also use the alignment commands to precisely arrange controls on the dialog box.
  • Page 215 Creating Custom Dialog Boxes Directory Tree Browse. A directory tree browser including an edit field, directory tree, and disk drive list. List Box with Checkboxes. A list containing a check box for each item, allowing multiple items to be selected simultaneously. Components If this list box control is being used to specify the components to be installed, and if the components have sub-components, enter the names of sub-...

  • Page 216: Adding Play Avi Controls

    Creating Custom Dialog Boxes Width / Height Specify the exact dimensions of the control in dialog units. You can also resize controls by dragging their handles, though this is not as precise. Click OK. Adding Play AVI Controls You can play an animation on any of the installation dialog boxes by adding a Play AVI dialog box control.
  • Page 217 Creating Custom Dialog Boxes The Push Button Control Settings dialog box appears. Complete the dialog box: Label Enter the name of the push button. To create a keyboard shortcut for the button, enter an ampersand (&) immediately before a letter. For example, “< &Back”...

  • Page 218: Adding Radio Button Controls

    Creating Custom Dialog Boxes Note A dialog unit is based on the size of the dialog font, usually 8-point MS Sans Serif. A horizontal dialog unit is 1/4 the average width of the font and a vertical dialog unit is 1/8 the average height of the font. Width / Height Specify the exact dimensions of the control in dialog units.

  • Page 219: Adding Rectangle Controls

    Creating Custom Dialog Boxes Note If you set the variable to a string containing one or more lowercase letters, the corresponding options are disabled in the radio button control when it appears on the dialog box. Example: A radio button with four options and a variable of “ABcd”...

  • Page 220: Adding Text Controls

    Creating Custom Dialog Boxes Control Name Enter the name by which you will refer to this control in the dialog box script. Leave this blank if you will not manipulate this control with a script. X-Position / Y-Position Specify the exact location of the control on the dialog box. You can also use the alignment commands to precisely arrange controls on the dialog box.

  • Page 221: Specifying Execute Program Settings

    Creating Custom Dialog Boxes mark this check box, the & is displayed literally and no underlining is performed. Set Font Normally, all controls use the default font, which you set on the Dialog Box Properties dialog box. Click this to override the default font for this control. If the font you select is not available on this computer, the system font is used.

  • Page 222: Aligning And Spacing Dialog Box Controls

    Creating Custom Dialog Boxes Complete the dialog box: EXE Path Specify the path to the application to be executed, including the application executable. Use variable substitution (example: %MAINDIR% to refer to the application directory) to ensure a valid path regardless the installation location. Enter only the file name if you set the path in the Default Directory field below.

  • Page 223: Setting Tab Order Of Dialog Box Controls

    Creating Custom Dialog Boxes Align Controls Bottom Aligns the bottom edge of the selected controls with the bottom edge of the bottommost control. Space Evenly Down Distributes the selected controls vertically between the topmost and bottommost controls. Their horizontal position is not changed. Use an Align Controls Left or Align Controls Right command to move them into a column.

  • Page 224: Solutions For Dialog Box Problems

    Creating Custom Dialog Boxes To exit the tab order view, press Esc. Note Although static controls (example: graphics, text messages, divider lines, and so on) are included in the tab order, they are ignored when the end user presses the Tab key.

  • Page 225: Disabling The Appending Of The Program Files Directory

    Creating Custom Dialog Boxes Click OK. Disabling the Appending of the Program Files Directory If you do not populate the Default Directory field on the Product Details page, and the end user changes the default directory using the Browse button on the Select Destination Directory dialog box, a Program Files directory is appended to the selected directory.

  • Page 226: Keeping Disabled Controls From Reactivating

    Creating Custom Dialog Boxes Keeping Disabled Controls From Reactivating This problem affects radio buttons and check boxes. Example: A dialog box in a wizard loop has a radio button with four options. You disable several options by setting the variable associated with the radio button to “ABcd.” The lowercase “c”...

  • Page 227: Configuring Dialog Box Set Properties

    Creating Custom Dialog Boxes page 216. You can link to another dialog box, link back to the master dialog box, or return to the installation script. To switch between dialog boxes in the set, select the dialog boxes from the Window menu.

  • Page 228: Dialog Box Script Actions

    Creating Custom Dialog Boxes Events are generated as the end user works with the dialog box on the destination computer. Built-in dialog box events include first-time display of the dialog box (INIT), updating of information displayed on the dialog box (UPDATE), and verification of the validity of the contents of the dialog box (VERIFY).

  • Page 229: Dialog Box Script Examples

    Creating Custom Dialog Boxes Set Control Attributes on page 192 Set Control Text on page 193 Set Current Control on page 194 Set Variable on page 195 While Statement on page 198 Dialog Box Script Examples To see an example of a dialog box script Open the sample script Event Handler.wse in the Samples subdirectory of this product’s installation directory.

  • Page 230: Chapter 9: Creating Custom Billboards

    Chapter 9 Creating Custom Billboards This chapter includes the following topics: About Billboards on page 230 Accessing the Custom Billboard Editor on page 230 About the Custom Billboard Editor on page 231 Opening and Saving Custom Billboards on page 232 Adding Objects to a Billboard on page 232 About Billboards...

  • Page 231: About The Custom Billboard Editor

    Creating Custom Billboards The tools you need to work in the Custom Billboard Editor are accessible from its menu bar or the icons on the toolbar. Note (WiseScript Package Editor only) Although the Custom Billboard Editor is only accessible through the Script Editor, you can add the graphics that you create with the editor on the Billboards page.

  • Page 232: Opening And Saving Custom Billboards

    Creating Custom Billboards (WiseScript Package Editor only) You can use the Screen page to specify the background that displays during the installation. When you save a billboard from the Custom Billboard Editor, you are saving the entire blue screen area, including the text, lines, shapes, and graphics that are on the screen. When you save a billboard as a separate file, it is assigned the extension .GRF.

  • Page 233: Editing Billboard Text Objects

    Creating Custom Billboards Click OK. Position the object on the billboard. Resizing, Moving, and Aligning Billboard Objects on page 236. Editing Billboard Text Objects Text you place on a billboard using the Text tool is editable. Each text object can use only one font, size, and style.

  • Page 234: Editing Billboard Rectangles And Ellipses

    Creating Custom Billboards Complete the dialog box: Line Style Choose the texture for the line. Line Arrows Determines which ends of the line will have arrowheads. Line Direction Determines whether the line should connect the lower-left corner of the bounding rectangle to the upper-right corner, or the upper left to the lower right.

  • Page 235: Editing Billboard Polygon Objects

    Creating Custom Billboards Editing Billboard Polygon Objects The polygon object consists of a series of points that are connected by lines. Access the Custom Billboard Editor. Accessing the Custom Billboard Editor on page 230. Select Add menu > Polygon, click where the points should be located, and close the polygon’s path by double-clicking on the starting point.

  • Page 236: Resizing, Moving, And Aligning Billboard Objects

    Creating Custom Billboards Accessing the Custom Billboard Editor on page 230. Select Add menu > Bitmap and drag the dimensions of the bitmap frame in the billboard editor. The Bitmap Settings dialog box opens. Complete the dialog box: Pathname Specify the path to a bitmap. Transparent Mark this to make the color in Transparent Color transparent.

  • Page 237: Setting Billboard Properties

    Creating Custom Billboards Space Evenly Across Distributes the selected objects horizontally between the topmost and bottommost objects. Their vertical position is not changed. Use Align Top or Align Bottom to move them into a row. Setting Billboard Properties When you are done creating a billboard, use the Billboard Settings dialog box to set the behavior of the billboard as a whole.
  • Page 238 Creating Custom Billboards (WiseScript Package Editor only) To slow the installation speed so that each billboard displays long enough to be read, select Installation Expert > Build Settings page and mark Slow Installation Speed. Click OK. WiseScript Package Editor Reference...

  • Page 239: Chapter 10: Tools

    Chapter 10 Tools This chapter includes the following topics: About WiseScript Package Editor Tools on page 239 ApplicationWatch on page 239 About WiseScript Package Editor Tools WiseScript Package Editor only The WiseScript Package Editor contains powerful tools that perform specialized functions.

  • Page 240: Import Visual Basic Project

    Tools Application Path Specify the full path of the application executable to run. Command Options Enter any command-line options to apply to the executable. Refer to the source application’s documentation for applicable command-line options. Click Execute, which starts the source application. In the source application, use all possible features except printing.
  • Page 241 Tools Specify the directory on your computer where Visual Basic 5 or 6 is installed. This directory contains the support files that must be included in the installation because they are needed by the Visual Basic program. Click Next. The Scanning Project Files page appears. During or after the scan, additional prompts and pages might appear: If the project is out of date or missing, a prompt appears.
  • Page 242 Tools Install Directory Enter the default installation directory where files from this import should be placed. This determines the folder on the Files page in which all added files are placed. Icon Name Enter the name you want to assign to the .EXE file’s icon in the program folder. Start Menu Name Enter a name for the folder that will appear in the Programs folder in the Windows Start menu.

  • Page 243: Chapter 11: Troubleshooting Wisescripts

    Chapter 11 Troubleshooting WiseScripts This chapter includes the following topics: About Troubleshooting a WiseScript on page 243 Using the Installation Log on page 243 File Replacement Problems in System32 on page 244 About Troubleshooting a WiseScript Use the following features to troubleshoot a WiseScript: Installation log Lets you determine what happens during the installation, including what fails.

  • Page 244: File Replacement Problems In System32

    Troubleshooting WiseScripts Use the installation log to determine where problems occur and why. Quality assurance can use it to check the accuracy of the installation. It also helps technical support because end users who have problems installing can email the installation log. Use the Add Text to Install.log script action to add your own commands to the log.

  • Page 245: Chapter 12: Quick Reference

    Chapter 12 Quick Reference This chapter includes the following topics: Automatic Compiler Variables on page 245 Automatic Run-time Variables on page 246 Run-time Variables on page 248 SVS Variables on page 250 Expression Operators on page 253 Windows Language Codes on page 254 Command-Line Options on page 256...

  • Page 246: Automatic Run-Time Variables

    Quick Reference Variable Description _ODBC32_ ODBC directory for 32-bit systems _SYS_ The Windows system directory on the build computer _VAR_LIST_ Contains all the variables defined in this installation file, but not compiler variables _VB4WIN16DIR_ Visual Basic directory for 16-bit systems _VB4WIN16OPT_ Visual Basic options for 16-bit systems _VB4WIN32DAO_...
  • Page 247 Quick Reference Variable Description DLG_EVENT_TYPE Used for custom dialog box scripts. Built-in dialog box events are INIT, UPDATE, VERIFY. Creating a Custom Dialog Box Script on page 227. FONTS Path to the directory where fonts should be installed. HELPFILE Used by custom dialog boxes to display a help context. Set this to the full path of the help file.

  • Page 248: Run-Time Variables

    Quick Reference Variable Description RESTART At the end of the script, set this variable to: If the current end user does not have administrator privileges, logs the user off. If the current end user has administrator privileges, performs a full system restart at completion of the script.
  • Page 249 Quick Reference Variable Description CDESKTOPDIR Common desktop directory for adding shortcuts to desktop. CGROUPDIR Path to the directory where shortcuts for all end users are stored on Windows operating systems. COMMON Common files directory. COMPONENTS A list of the components the end user selects for installation on the destination computer (A for the first component, B for the second, etc.).

  • Page 250: Svs Variables

    Quick Reference Variable Description PROCEXITCODE Lets you add error codes to the built-in error codes that are returned from an installation. Check for an error condition and, if the error condition is true, put your own error text into PROCEXITCODE. At the end of the installation, if PROCEXITCODE is not blank, the return code from the installation is set to the contents of PROCEXITCODE.
  • Page 251 Quick Reference Variable Description Example Value SYSTEMDRIVE The drive letter that contains the Windows directory that the system started. WINDIR The Windows directory C:\Windows that was started. PROFILESDIRECTORY The directory that contains C:\Documents and Settings local user profile information. ALLUSERSPROFILE The directory that contains C:\Documents and Settings\All Users the All Users profile.
  • Page 252 Quick Reference Variable Description Example Value ADMINTOOLS C:\Documents and Settings\User\Start Menu\Programs\Administrative Tools APPDATA C:\Documents and Settings\User\Application Data CACHE C:\Documents and Settings\User\Local Settings\Temporary Internet Files CDBURNING C:\Documents and Settings\User\Local Settings\Application Data\Microsoft\CD Burning COOKIES C:\Documents and Settings\User\Cookies DESKTOP C:\Documents and Settings\User\Desktop FAVORITES C:\Documents and Settings\User\Favorites FONTS C:\WINDOWS\Fonts...

  • Page 253: Expression Operators

    Quick Reference Variable Description Example Value USERPROFILE Location of the current C:\Documents and Settings\User user’s profile. Expression Operators In conditionals, loops, and Set Variable commands, you can use the following operators: symbols, functions, or logical operators. Operators can operate on a variable or a constant. There are two types of constants: numeric and string.

  • Page 254: Windows Language Codes

    Quick Reference Before$(str1,str2) Returns the portion of a string (str1) before the indicated substring (str2). Example: Before$(“windows”,“d”) returns “win.” After$(str1,str2) Returns the portion of a string (str1) after the indicated substring (str2). Example: After$(“windows”,“d”) returns “ows.” Len(str) Returns the length of a given string. Do not include the $ character because this operator does not return a string.
  • Page 255 Quick Reference Language Code Script Dutch (Standard) Latin 1 English (American) Latin 1 English (Australian) Latin 1 English (British) Latin 1 English (Canadian) Latin 1 English (Ireland) Latin 1 English (New Zealand) Latin 1 Finnish Latin 1 French (Belgian) Latin 1 French (Canadian) Latin 1 French (Standard)

  • Page 256: Command-Line Options

    Quick Reference Command-Line Options You can set command-line options when you run WiseScript Package Editor, the installation executable, and the uninstaller executable. These are especially useful for running an installation as part of a batch file or other automated installation system. If you compile from the command line, compile errors generate return codes.

  • Page 257: Wisescript Installations Command-Line Options

    Quick Reference Note To test the options without the scheduling program, select Windows Start menu > Run, type cmd, click OK, and type a command-line statement in the command-line window. WiseScript Installations Command-Line Options You can apply the following command-line options to .EXE files that you compile from WiseScript Package Editor projects.
  • Page 258 Quick Reference Silent mode. The uninstall proceeds silently with no splash screen, no dialog boxes, and no end user choices. Rollback mode. Removes the Select Uninstall Method dialog box, which means the end user does not see options for a custom, automatic, or repair uninstall.

  • Page 259: Index

    Index Symbols Add to Config.sys 122 arranging object 236 bitmap, adding 235 Add to System.ini 123 % sign with compiler variable 111 editing text 233 Add/Remove Programs page 39 _ALIASNAME_ 245 ellipse, adding 234 administrator rights, checking 130 _ALIASPATH_ 245 exporting 232 After$ 254 importing 232...
  • Page 260 CabWiz installation 18 drop-down 207 about 178 options 41 edit text 209 silently 256 editing 206 Call COM Object 161 speeding 26 frame 219 Call DLL Function stopping 170 graphic 211 example using structure 128 group box 212 compiler variable script action 124 hot text 212 about 44, 111...
  • Page 261 data source, ODBC 61, 136 script, custom 227 checking if loaded 134 scripting 192, 194 excluding with date/time file modified settings 204 ApplicationWatch 26 getting 168 size 204 excluding with Import VB getting four-digit year 169 stop appending to path 225 Project 26 date/time, current stop dir exists message 225...
  • Page 262 Also see installer .EXE renaming 189 Get Registry Key Value 166 compiling 18 renaming in layer 190 Get SVS Layer Info 166 getting path 168 replacing in System32 244 Get System Information 167 location after compile 43 replacing on destination Get Temporary Filename 169 naming 43 computer 54, 139, 175...
  • Page 263 setting permissions 197 import VB project 240 installer message Internet-based 53 See installation message image, displaying in background 147, language 24, 43 Instr$ 253 log file 58 Import SVS Layer 171 international installation 58 manual mode 26 Import Visual Basic Project 240 Internet media 60 check 133...
  • Page 264 localization path See language changing directories 28 NAME 249 relative paths 29 log file name script 95 UNC paths 29 See installation log navigating between views 16 PATH variable 119, 163 logging 58, 80, 243 network Pause 182 logon name, getting 168 drive, getting 168 PDF (Package Definition File) 60 long 126...
  • Page 265 PVK file 47 Rename File/Directory 189 adding action 99 blank 103 Rename SVS Layer 190 colors 26 repair commenting out lines 100 radio button control about 30 comments 188 adding to dialog box 218 Also see self-repair conditional loop 109 problem with disabling 226 application 67, 74, 143, 153, 175 conditional statement for...
  • Page 266 group 72, 141 source directory about 77 settings 71, 140 relative 29 file or directory 77 starting 72, 141, 197 UNC-based 29 registry 79 stopping 197 source file System.ini, adding device 123 service pack number, getting 168 location, changing 28 System32 relative paths 29 Services page 70...
  • Page 267 undo editing 158 ending 155 Installation Expert page 37 executing from WiseScript 157 wildcard functions, viewing 159 uninstal.wse 98 adding files with 52 getting WiseScript variable 160 filtering directories 52 uninstall objects, viewing 159 Also see uninstaller WIN 248 setting WiseScript variable 160 initiating repair 30 Win16 SDK 127 tab 96...
  • Page 268 starting 15 WiseUpdate about 85 adding with script 177 client 85, 91 configuring 87 INI file 89 process 86 running from application 91 running silently 91 testing 90 tips 92 troubleshooting 93 update file, about 89 updating file 88 uploading, FTP client 90 using 87 using with SmartPatch 92 using with WebDeploy 92...

This manual is also suitable for:

Wisescript package editor 8.0

Table of Contents