This property page determines the .INI settings that Novell® Application LauncherTM/Explorer will create or delete when distributing the application to a workstation.
INI Settings
The INI Settings tree displays the .INI settings that will be modified when
the application is distributed to the workstation. If you used a .AOT, .AXT,
or .MSI file when creating the Application object, the tree automatically includes
all .INI settings defined in those templates.
If there are additional INI settings you want created or deleted during distribution, you need to add the settings to the INI Settings tree and then specify the appropriate action (create or delete) in the Item Will field.
The INI Settings tree can include multiple INI files and each file can include multiple sections. When you add a setting to the INI Settings tree, you must add it to a file and section. This means that you may need to add new files and new sections to the tree before you can add new settings.
For example, assume that you want to add a CLASSPATH= setting to the ENVIRONMENT section of the SAMPLE.INI file. You would 1) add a file entry to the INI Settings tree for the SAMPLE.INI file, 2) add an ENVIRONMENT section under the SAMPLE.INI file, 3) add the CLASSPATH= setting under the ENVIRONMENT section, and 4) select the CLASSPATH= setting and choose the appropriate Create action in the Item Will field.
If, instead of adding the CLASSPATH=setting, you wanted to delete it, you would follow the same process but then choose the appropriate Delete action in the Item Will field.
File
This option lets you search for files, sections, or values in the INI Settings tree, import settings into the tree, export settings from the tree, or view a file's .INI settings.
- Find: Click File > Find to search for specific files, sections, or values.
- Find Next: Click File > Find Next to find the next occurrence of the file, section, or value.
- Import: Click File > Import to import .INI settings from another Application object's .AOT or .AXT file, or from a .INI file.
- Export: Click File > Export to export the settings to a .INI file. To export the settings to a .AOT or .AXT file, you must export the entire Application object using the Export Application Object option located on the Tools > Application Launcher Tools menu.
- View File: Select a file in the list > click File > View File to see the INI settings that will be modified (added to or deleted from) when the application is distributed.
Add
This option lets you add .INI settings to the INI Settings tree. Only settings displayed in the INI Settings tree will be created or deleted when the application is distributed. You can add a file to the tree, a section to a file, or a value to a section.
- File: Click Add > File to add a file to the INI Settings tree. In addition to providing a file name, you can specify the target location for the file. By default, the %*WINDIR% macro is used, which represents the workstation's Windows directory (typically C:\WINDOWS or C:\WINNT). After you add a file, you can begin adding sections to it.
- Section: Select a file in the INI Settings tree, click Add > Section to add a section to the selected file. After you name the section, you can begin adding values to it.
- Value: Select a section in the INI Settings tree, click Add > Value to add a value (setting) to the selected section. You must specify the value name and value data.
Once you've added a value to the INI Settings tree, you can use the Distribution Options list to determine whether or not it is created or deleted from the workstation. If the value needs to be created but the file or section does not exist, Application Launcher/Explorer will create the file or section before adding the value.
You can use a macro for a section name, value name, or value data.
Modify
You can modify a file's name, a section's name, or a value's name and data. Select the file, section, or value you want to modify > click Modify.Delete
Select the file, section, or value you want to delete from the INI Settings tree > click Delete. When deleting a file or section, everything subordinate to it will also be deleted.
Distribution Options
The distribution options let you determine how individual .INI settings (included
in the INI Settings tree) are handled during distribution of the application.
Item Will
Use this option to determine whether a setting will be created or deleted when the application is distributed. Select a value in the INI Settings tree > select one of the following options from the Item Will list:
- Create Always (Default): Creates the value regardless of whether the value currently exists in the section. If necessary, will create the section and the file.
- Create If Does Not Exist: Creates the value only if the value does not currently exist in the section.
- Create If Exists: Creates the value only if the value currently exists in the section.
- Create or Add to Existing Section: Creates the value if the value does not currently exist in the section. If the value exists, it adds this value to the section in addition to the one that already exists. This is useful, for example, if you need multiple values of the same type, such as two "DEVICE=" values.
- Create or Append to Existing Value: Creates the value if the value does not currently exist in the section. If the value exists, it appends the data for the new value to the existing value. The first character in the value data needs to be the separator character, such as a space.
- Delete: Deletes the value from the section.
- Delete or Remove from Existing Value: Deletes the value from the section, or, if the value has multiple data entries, removes this value's data entry from the value. For example, suppose the following setting is in the WIN.INI file: Run = sol.exe calc.exe. Using this option, you can remove just calc.exe, leaving the following: Run = sol.exe. The first character in the value data needs to be a separator character, such as a space.
Track Distribution Per User
If you have implemented roaming user profiles, use this option to ensure that particular INI settings are distributed to each workstation a user logs in to. You should enable this option for all INI settings that are not saved as part of roaming user profiles.In the INI Settings list, select the desired INI modification > check Track Distribution Per User.
Distribute Always
By default, Application Launcher/Explorer will only distribute the .INI modifications defined in the INI Settings list at the following times:
- The first time the application is launched on a workstation.
- The first time the application is launched after the application's version number (Distribution Options tab > Options page) has been changed.
To force Application Launcher/Explorer to distribute an INI modification each time the application is launched, select the INI setting in the INI Settings list > check Distribute Always.
If the user has a NALCACHE directory on his or her local machine, Application Launcher/Explorer uses the information stored in the NALCACHE directory to make the INI modification. If the user does not have a NALCACHE directory (for example, the user is running Application Launcher/Explorer through a terminal server client session) or if writing to the cache has been disabled for the user (User object > Application Launcher tab > Launcher Config tab > Enable Writing to Cache option), Application Launcher/Explorer uses the information stored in Novell eDirectoryTM.
Move Up / Move Down
Use these options to position sections and values in the order in which you want them to be created, modified, or deleted.In the INI Settings tree, select the section or value to move > click Move Up or Move Down.
A trademark symbol (®, TM, etc.) denotes a Novell trademark. An asterisk denotes a third-party trademark. For information on trademarks, see Legal Notices.