Chat now with support
Chat with Support

Migrator for GroupWise 4.7 - Program Parameters Reference Guide

Introduction Parameters for Administrator Components Parameters for the SSDM

GUI-set and other "auto-set" parameters

Many parameters are automatically set by an application to record entries in the graphical user interface (GUI) of an application. That is, an application will write the parameter value to the Task Parameters upon an admin’s or user’s entry in the GUI. Many other parameters are auto-set by the Setup program that installs the Quest software, or are auto-set by a program for internal controls.

CAUTION: These auto-set parameters are particularly important to application performance, and changes to auto-set values can cause the associated applications to perform erratically. Quest strongly recommends these auto-set parameters not be manually edited except at the explicit direction of Quest Support staff, or if explicitly directed in the application notes in this document.

Many parameters are internal transient parameters, used by programs as temporary repositories for “scratch” data to pass information to another program, or from one subroutine to another. Any manual manipulation of these parameters is meaningless and will have no affect on the program or data, since any preexisting values are overwritten by the program as soon as it runs. All transient “scratch” parameters are clearly identified as such in this document.

The default value of a required parameter is the value that was set when the software was originally installed—before the associated program or anyone has had a chance to edit the file. The default value of an optional parameter is the value that prevails if the parameter does not appear within the INI file.

For any given parameter, the parameter value will be meaningful only if it conforms to the parameter’s particular data type. Every parameter is one of these five data types:

String: An alphanumeric string.
Integer: A non-decimal numeric value.
Boolean: A single-digit value, 1 or 0, to specify whether a particular feature or function is to be enabled or disabled, or whether a particular operating condition is true or false. These values are specified by a single-digit of 1 (on, yes, or true) or 0 (off, no, or false).
Date: A date, formed by eight digits with two slash characters, in the form: mm/dd/yyyy.
Keyword: An alphanumeric string that matches one of a finite set of valid keyword strings defined for the particular parameter.

How to specify or edit program parameters

The INI file associated with an MFG program resides in the same path as the program. Since an INI file is a simple text file, you can use Windows Notepad or any text editor to open, view, and edit the file.

To edit an INI file:

 

Parameters for Administrator Components

addproxy.ini (AddProxy)

addproxy.ini [AddProxy] FailureLog=<path>
Specifies the name and location of a csv file to which failed proxy-update attempts will be logged. The parameter must be specified as a full UNC path, including the file name, that is valid and writeable from every desktop where AddProxy will run, as in this example:
addproxy.ini [AddProxy] SuccessLog=<path>
Specifies the name and location of a csv file to which successful proxy updates will be logged. The value must be specified as a full UNC path, including the file name, that is valid and writeable from every desktop where Addproxy will run, as in this example:
addproxy.ini [AddProxy] User=<SMTPAddress>
addproxy.ini [AddProxy] UserGroupWiseAddr=<GWAddress>
The GroupWise address of the User specified above, a required parameter if AllowSearch=0 (see above). An example, with the proper address format:
Valid values are integers in the range 0–3 inclusive. A setting of 1, 2 or 3 tells the program to add new proxy rights as described below. AllowAdd=0 tells the program to modify existing proxy rights, to add the rights necessary for migration—useful when AddProxy cannot add new proxy rights for a new admin proxy because the prerequisites for adding new rights are not satisfied (see AddProxy Prerequisites, in chapter 2 of the MFG Administration Guide). The four valid AllowAdd parameter values are:
0: For each user, determine whether the designated proxy admin (defined by the User and UserGroupWiseAddr parameters below) is already defined among the user’s proxies and, if so, add all necessary migration rights to the previously granted rights. (If the designated admin is not already among the user’s proxies, the program will do nothing for that user.)
AllowSearch=1 (the default) tells the program to search the system address book for addresses. Disabling such searches (AllowSearch=0) can be useful in some circumstances where system address book searches do not work correctly. If AllowSearch=0, you must also specify values for the User and UserGroupWiseAddr parameters (see below).
Force=0 tells the program to update a user's proxy settings just once (not every time AddProxy runs). Force=1 tells the program to update a user’s proxy settings every time AddProxy runs. The default is appropriate in most cases.
... tells the program to prompt immediately for the userid and password if the user is not already logged into GroupWise. The default PiggyBack=1 tells the program to not prompt for userid and password, but rather to wait for the user to log into GroupWise, for a number of seconds specified by the PiggyBackTimeout parameter (see below).
addproxy.ini [AddProxy] PiggyBackRetry=<###>
This parameter is meaningful only if PiggyBack=1 (see above), and will be ignored if PiggyBack=0.
addproxy.ini [AddProxy] PiggyBackTimeout=<#####>
This parameter is meaningful only if PiggyBack=1 (see above), and will be ignored if PiggyBack=0. The default 7200 tells the program to wait two hours (2 hrs x 60 mins/hr x 60 secs/min = 7200). PiggyBackTimeout=0 tells the program to wait indefinitely.
addproxy.ini [AddProxy] Rights=<right1> <right2> <right3>
all: all rights.
none: no rights.
read: readAppointments, readMailAndPhone, readNotes, readTasks.
readAppointments: read access to appointments.
readMailAndPhone: read access to mail messages and phone messages.
readNotes: read access to reminder notes.
readTasks: read access to tasks.
write: writeAppointments, writeMailAndPhone, writeNotes, writeTasks.
writeAppointments: write access to appointments.
writeMailAndPhone: write access to mail and phone messages.
writeNotes: write access to reminder notes.
writeTasks: write access to tasks.
alarms: access to alarms.
archive: access to the archive.
notifs: access to notifications.
private: access to items marked as private.
settings: access to Preferences, Rules, and Groups.
Related Documents