═══ 1. Overview ═══ Progref is a PM utility to quickly and easily generate Program reference objects from executables (ie typically exe, com, cmd and bat type files). Progref uses one dialog panel for most of the commonly used program reference options. Aids are used to simplify field entries such as setting the default directory path, and the capitalization of the program reference object name. File dialogs are available to simplify the selection of program executables and icons. The program reference objects will be place on the desktop, where they can be dropped into the folders of your choice. o Starting Progref o Menu Options o Input Fields o Radio Buttons o Check Buttons o Push Buttons ═══ 2. Starting Progref ═══ Progref can be started by o Executing Progref from the command line with or without the fully qualified name of the program for which you wish to build the reference object. The program program accepts as input the fully defined program name (ie the path is included) separated by blanks. For example "progref d:\abcd\test.exe". If no argument is supplied a file dialog provides for the selection of the input file. o Selecting executables from the drives object and dropping them on a program reference of progref. o Double clicking on a shadow or program reference object of progref ═══ 3. Menu Options ═══ The menu options for file dialogs and defaults are described in the following section. o File Dialogs Program This option will present a standard file dialog to assist in selecting the executable for which you wish to build a program reference. Path This option presents a standard file dialog to assist in selection the path for the working directory. Since a standard file dialog is used a file has to selected before the dialog will return. Only the path information is used so it can be any file in the directory. If the directory chosen is an empty directory, simply put a dummy file name in the open file name field. Icon Dialog This options will present a standard file dialog to assist in selecting icons that you want to associate with the executable. Please Note You do not need to use this option if the executible already has an icon associated with it. You can however use it to override an icon already associated with a file with the icon of your choice. o Defaults Establishes the defaults for Progref. There are three submenu options that you can select. Save Present Saves Progref's settings as they exist when this option is selected. This option can be used even if it is already selected (checked). Save Last The options selected are not saved immediatly. Instead, they are saved the next time the Create button is pushed. This means that each time progref is invoked, it will have the options that were last used. Remove Defaults Removes either of the above two settings. Progref will take original defaults when it's next executed. Please Note: The remove defaults option also provides a means of removing all Progref data from the OS/2.ini file. ═══ 4. Input Fields ═══ Title Sets the object's title. Associate Filters Sets the filename filter for files associated to this program. Multiple filters are separated by commas. Associate Types Sets the type of files associated to this program. Multiple filters should be separated by commas. Program Parameters Sets the parameters list, which may include substitution characters. Working Directory Sets the working directory. The associated check button will set the working directory to the same directory the executable resides in. ═══ 5. Autoradio buttons ═══ Autoradio buttons o Minimize Behavior HIDE Views of this object will hide when their minimize button is selected. VIEWER Views of this object will minimize to the minimized window viewer when their minimize button is selected. DESKTOP Views of this object will minimize to the Desktop when their minimize button is selected. o Program Type PM Sets the session type to PM. OS/2 Windowed Sets the session type to OS/2 windowed. OS/2 Full Screen Sets the session type to OS/2 full screen Dos Windowed Sets the session type to DOS windowed. Dos Full Screen Sets the session type to DOS full screen. Win Window Sets the session type to WIN-OS2 window. Win Full Screen Sets the session type to WIN-OS2 full screen. Win Sep VDM Sets the session type to WIN-OS2 window running in a separate VDM. o Program Title Push Buttons First This options capitalizes the first character of the title name. The subsequent letters are lowercase. CAPS All characters in the title name are capitalized. Lower All characters in the title name are made lower case. ═══ 6. Check Buttons ═══ o Window Behavior Window Open Term? When Checked the window is left open upon program termination. When unchecked the window is closed upon program termination. Start Minimized? When checked the program is started minimized. New View On Open? When checked a new view of the object will be created whenever open is selected. When unchecked, if open is selected, previously started views will be resurfaced. o Working Directory The check button under the working directory input field will set the working directory field to the directory the executable is in. ═══ 7. Push Buttons ═══ Create Pushing create will create the program reference object with the settings that have been selected in the dialog. Repeat The repeat button will produce a program reference object and then restore the dialog box with the same settings. This is handy if you want to make multiple copies with minor changes. For example, one might make two copies of a file transfer program with different options so that one is set up for binary transfers and the other is set up for ascii transfers. Cancel Program is terminated without creating a program reference object