OS/2 Professional/OS2PRO194.ISO/os2/prgramer/dip/dipwrite.hlp

OS/2 Help File | 1993-03-14 | 31KB | 989 lines

ΓòÉΓòÉΓòÉ 1. DeskTop Install Procedure Writer ΓòÉΓòÉΓòÉ

The DeskTop Install Procedure Writer allows a power user or software developer
to quickly and easily develop a custom install procedure for an OS/2, Dos or
windows application onto the OS/2 desktop (Work place Shell).  DIP Writer
creates a script file containing the actions to be executed by DIP Runner.  DIP
Runner and the script file can be packaged with any application the user wish's
to have a custom installation program for.  There are no runtime licence fees
for DIP Runner.


ΓòÉΓòÉΓòÉ 2. MainWindow ΓòÉΓòÉΓòÉ

MainWindow:

The main window of the Desktop Installation Procedure (DIP) writer allows the
user to create and describe the installation file.  it is the control hub
around which the creation and display/ordering of a procedure files actions
takes place.


ΓòÉΓòÉΓòÉ 2.1. Install Title Text. ΓòÉΓòÉΓòÉ

This is the Title text that will appear at the top of the DIPRUN program when
the install procedure file is loaded by diprun.  This text should identify the
application being installed. Enter this text in the field on the main window.


ΓòÉΓòÉΓòÉ 2.2. ActionBar File ΓòÉΓòÉΓòÉ

ActionBar File menu contains all the actions associated with opening or saving
a procedure file.  The exit option is also on this menu.


ΓòÉΓòÉΓòÉ 2.2.1. PullDown New ΓòÉΓòÉΓòÉ

PullDown New will discard the current file and open a new blank script file. To
save this file you must use the Save As option. Any existing file will be
discarded.


ΓòÉΓòÉΓòÉ 2.2.2. PullDown Open ΓòÉΓòÉΓòÉ

PullDown Open calls the Open File dialog which allows you to select a
previously created DIP script file to load. Any existing file will be
discarded.


ΓòÉΓòÉΓòÉ 2.2.3. PullDown Save ΓòÉΓòÉΓòÉ

PullDown Save will save the open procedure file.  This option is only valid if
you have already assigned it a file name ( with SAVE AS) or recalled the
procedure from an existing file with the OPEN option.


ΓòÉΓòÉΓòÉ 2.2.4. PullDown Save_As ΓòÉΓòÉΓòÉ

PullDown Save_As calls the Save As dialog that allows the user to specify a new
name for the open File.  The procedure is then saved into this file.


ΓòÉΓòÉΓòÉ 2.2.5. PullDown Exit ΓòÉΓòÉΓòÉ

PullDown Exit will leave the application.


ΓòÉΓòÉΓòÉ 2.3. Default Main Install Directory ΓòÉΓòÉΓòÉ

This is the name of the directory into which all install actions will be
directed.  The user can change the name of this directory at install time when
DIPRUN loads the install procedure.  This main procedure will form the default
path for all other file and directory action unless otherwise specified.


ΓòÉΓòÉΓòÉ 2.4. Action List Box ΓòÉΓòÉΓòÉ

The list of install actions in their order of execution.  Double click on one
of actions to View/modify the action or select an item and select on of the
buttons.


ΓòÉΓòÉΓòÉ 2.5. View/Modify Button ΓòÉΓòÉΓòÉ

Select an item from the list box, and then hit the View/Modify button to review
the action items contents and modify them if you wish.


ΓòÉΓòÉΓòÉ 2.6. Order of Actions ΓòÉΓòÉΓòÉ

The initial Order actions are executed is determined by the time of creation.
If this order is not satisfactory the the MoveDown/MoveUp buttons on the main
window can be used to reorder the actions.


ΓòÉΓòÉΓòÉ 2.7. Action Bar Test ΓòÉΓòÉΓòÉ

Try a test run of the Install procedure currently open. This is not just an
animator.  The action you have specified in the install procedure (copy files
ect.) will actually be executed.


ΓòÉΓòÉΓòÉ 2.8. Move Up button ΓòÉΓòÉΓòÉ

Move up the selected item on entry on the list box order.


ΓòÉΓòÉΓòÉ 2.9. Delete Button ΓòÉΓòÉΓòÉ

Delete the selected Item from the Action List.


ΓòÉΓòÉΓòÉ 2.10. Action Bar Help ΓòÉΓòÉΓòÉ

Built in help system.


ΓòÉΓòÉΓòÉ 3. Dlg Open ΓòÉΓòÉΓòÉ

Dlg Open allows you to select a previously created procedure file to open.


ΓòÉΓòÉΓòÉ 3.1. Dlg Open EntryFilter ΓòÉΓòÉΓòÉ

The Dlg Open EntryFilter allows you to specify a full or partial file name that
will then be used as a search criteria for listing valid procedure files to
open.


ΓòÉΓòÉΓòÉ 3.2. Dlg Open ListBoxFile ΓòÉΓòÉΓòÉ

Dlg Open ListBoxFile contains a list of valid procedure files that can be
opened by DIPWRITER.  Select one of these file and press OK or double click on
the file name to open the file.


ΓòÉΓòÉΓòÉ 3.3. Dlg Open ListBoxDir ΓòÉΓòÉΓòÉ

Dlg Open ListBoxDir contains a list of directories that can be opened in your
search for a procedure file to open.


ΓòÉΓòÉΓòÉ 3.4. Dlg Open Button OK ΓòÉΓòÉΓòÉ

The Dlg Open Button Ok will open the selected procedure file if a file is
selected or do nothing if no file is selected.


ΓòÉΓòÉΓòÉ 3.5. Dlg Open Button Cancel ΓòÉΓòÉΓòÉ

Dlg Open Button Cancel exits the open dialogue without selecting a procedure
file to open.  The previous procedure file will still be present when you
return to the main screen.


ΓòÉΓòÉΓòÉ 3.6. Dlg Open Button Help ΓòÉΓòÉΓòÉ

Dlg Open Button Help opens the on line help for the dialogue.


ΓòÉΓòÉΓòÉ 4. Dlg save As ΓòÉΓòÉΓòÉ

The SaveAs dialog allows you to specify a new name for the file currently open.
This is the only way to name a new script file.


ΓòÉΓòÉΓòÉ 4.1. Entry field for new file name. ΓòÉΓòÉΓòÉ

Enter the New file name without the DIP extension.  This file extension will be
added.


ΓòÉΓòÉΓòÉ 4.2. Directory List Box ΓòÉΓòÉΓòÉ

Select the directory to store the File in.


ΓòÉΓòÉΓòÉ 4.3. SaveAs OK button ΓòÉΓòÉΓòÉ

If a valid file name has been specified, the current install file is saved in
this file.


ΓòÉΓòÉΓòÉ 4.4. Cancel the Save AS dialogue ΓòÉΓòÉΓòÉ

Dlg Button Cancel exits the Save AS dialogue without selecting a procedure file
name to save to.


ΓòÉΓòÉΓòÉ 5. Create Folder Screen ΓòÉΓòÉΓòÉ

Use this window to view or change the properties of a folder create action. Use
the fields in Icon view to select how you want icons to be displayed. Use the
Icon display field to select the size of the icons, or to make them invisible.
Use the Display Format fields to select the positioning of icons on the desktop
or in the open folder window.

Once a folder is created its internal name is added to the list of objects that
can be owners of program, data, or other folder objects.  Make sure That you do
not change the ordering or creation of this folder so that an object owned by
the folder is created before the folder.  If you do the create will fail.


ΓòÉΓòÉΓòÉ 5.1. Folder Title entry field ΓòÉΓòÉΓòÉ

Name of the folder as presented to the user.  This name can be changed by the
user after the install.

The Title field displays the name of the object This name is displayed with the
icon. Type in this field to change the title. You can use any characters,
including spaces, except the backslash (\).


ΓòÉΓòÉΓòÉ 5.2. Folder Object Name ΓòÉΓòÉΓòÉ

Internal name of the folder used to identify the folder from all other folders.
This name can not be changed by the user.


ΓòÉΓòÉΓòÉ 5.3. Folders Owner entry field ΓòÉΓòÉΓòÉ

This combo box contains a list of default system folders and folders you have
created that can be used to hold (or own) a new program or data or folder
object.

Once a folder is created its internal name is added to the list of objects that
can be owners of program, data, or other folder objects.  Make sure That you do
not change the ordering or creation of this folder so that an object owned by
the folder is created before the folder.  If you do the create will fail.


ΓòÉΓòÉΓòÉ 5.4. Default Folder Icon Button ΓòÉΓòÉΓòÉ

Use the default icon for the folder when it is created on the work place shell.


ΓòÉΓòÉΓòÉ 5.5. Specify an icon for folder ΓòÉΓòÉΓòÉ

Specify an icon file to replace the normal folder icon when the folder is
created on the workplace shell.


ΓòÉΓòÉΓòÉ 5.6. Folders Icon file name. ΓòÉΓòÉΓòÉ

Name of the icon file to replace the normal folder icon. If a disk and path are
not specified then the default main directory and disk specified by the user at
install time is used.  The Icon file should have already been copied to the
location before the folder is created.


ΓòÉΓòÉΓòÉ 5.7. Default Icon Position ΓòÉΓòÉΓòÉ

Accept the default icon position when it is created on the workplace shell.


ΓòÉΓòÉΓòÉ 5.8. Specify Folder Position Button ΓòÉΓòÉΓòÉ

Specify the position/location of the folder inside the owning folder or on the
desktop.  If you choose this option you must enter values in the X/Y position
fields that appear.


ΓòÉΓòÉΓòÉ 5.9. X position of folder ΓòÉΓòÉΓòÉ

The X or horizontal position of the folder inside the owning folder or on the
desktop.  The value is a percentage location with 0 being in the left hand side
and possible values being 0 to 99.


ΓòÉΓòÉΓòÉ 5.10. Folders Y position ΓòÉΓòÉΓòÉ

Position/location of the folder inside its owning folder or desktop.  This is
the vertical location as expressed in a percentage from 0 to 99 starting at the
bottom of the screen.


ΓòÉΓòÉΓòÉ 5.11. Default view button ΓòÉΓòÉΓòÉ

Accept the default view position.  This is the position where the folders lower
left corner is placed when the folder is opened for the first time.


ΓòÉΓòÉΓòÉ 5.12. Specify the open folders position ΓòÉΓòÉΓòÉ

Select this radio button if the open folders position is to be specified. Two
entry fields will appear, one each for the x and y coordinates to uses as a
starting position for the folders lower left hand corner.


ΓòÉΓòÉΓòÉ 5.13. Folders X position ΓòÉΓòÉΓòÉ

Enter a number 0 to 99 for the percentage offset of on the desktop screen that
the folders horizontal location.


ΓòÉΓòÉΓòÉ 5.14. Folders Y position ΓòÉΓòÉΓòÉ

Enter a number 0 to 99 for the percentage offset of on the desktop screen that
the folders vertical location.  0 is bottom of the screen, 99 is top.


ΓòÉΓòÉΓòÉ 5.15. X Size of folder ΓòÉΓòÉΓòÉ

The width of the folder expressed as a percentage of the length of the total
screen it will occupy when open. (0-99 percent)


ΓòÉΓòÉΓòÉ 5.16. Y size of folder when opened ΓòÉΓòÉΓòÉ

Height of folder when it is first opened.  Figure is based on a percentage of
the total height of the screen. Possible values are 0 to 99.


ΓòÉΓòÉΓòÉ 5.17. Folder flowed style radio button ΓòÉΓòÉΓòÉ

this style specifies that the contents of the folders icon view will be
presented in a horizontal columns across the screen.  This type of presentation
is a neat orderly way of presenting the folder contents and is my personal
favorite.


ΓòÉΓòÉΓòÉ 5.18. Folder style non-flowed ΓòÉΓòÉΓòÉ

Select Non-flowed if you want the icons arranged in a column from the top of
the screen to the bottom. If you select Flowed or Non-flowed, a single
horizontal line is displayed after each icon if you drag an icon along a
column.  The line indicates where you can place the icon that you are dragging.
The icon will be displayed there when you drop it by releasing mouse button 2.


ΓòÉΓòÉΓòÉ 5.19. Folder style Non-Grid ΓòÉΓòÉΓòÉ

Select Non-grid if you want the icons located randomly about the screen without
any ordered arrangement.  This is the default setting.


ΓòÉΓòÉΓòÉ 5.20. Normal Folder Icon view ΓòÉΓòÉΓòÉ

Select Normal size if you want the icons to appear as the default size.


ΓòÉΓòÉΓòÉ 5.21. Folder View with small Icons ΓòÉΓòÉΓòÉ

Select Small size if you want the icons to be smaller than the default size.


ΓòÉΓòÉΓòÉ 5.22. Folder contents without Icons ΓòÉΓòÉΓòÉ

Select Invisible if you do not want icons to be displayed on the screen.


ΓòÉΓòÉΓòÉ 5.23. Folder as a template ΓòÉΓòÉΓòÉ

You can create a template of the Folder object.  Then each time you drag a copy
from the template, you create a new folder that has the same settings as the
original object.

 Whenever you create a template object, the name of the object is added to the
pop-up menu for all objects that have a Create another choice on their pop-up
menu. To view the names of the templates you have created, display a pop-up
menu and select the arrow to the right of Create another.


ΓòÉΓòÉΓòÉ 5.24. Save Folder action button ΓòÉΓòÉΓòÉ

Save the changes made to the create folder action and returns to the main
screen.


ΓòÉΓòÉΓòÉ 5.25. Destroy Folder Action Button ΓòÉΓòÉΓòÉ

Pressing this button will destroy the create folder action and return to the
main screen.


ΓòÉΓòÉΓòÉ 5.26. Cancel Folder action Button ΓòÉΓòÉΓòÉ

Cancel any changes to the create folder action and return to the main screen.


ΓòÉΓòÉΓòÉ 6. Creating a Program Object ΓòÉΓòÉΓòÉ

The Create a Program Action installs a program Object on the OS/2 2.0 desktop
and associates it with a executable file when the install script is run.  In
this way you can also create data objects. For example, to represent a help
file that can be processed by the OS/2 view program, simply specify the
executable file as the C:\OS2\VIEW.EXE program with the parameter set to the
name of the help file and the working directory the path to the help file.  The
title and icon of the object can also be altered to give the object the look of
a text file.

Unless directly specified, the executable file path and the working directory
will default to the target disk and directory as specified by the user.


ΓòÉΓòÉΓòÉ 6.1. Program title ΓòÉΓòÉΓòÉ

Name of the program as presented to the user.  This name can be changed by the
user after the install.

The Title field displays the name of the object This name is displayed with the
icon. Type in this field to change the title. You can use any characters,
including spaces, except the backslash (\).


ΓòÉΓòÉΓòÉ 6.2. Programs owning Folder ΓòÉΓòÉΓòÉ

 This combo box contains a list of default system folders and folders you have
created that can be used to hold (or own) a new program or data or folder
object.

Once a folder is created its internal name is added to the list of objects that
can be owners of program, data, or other folder objects.  Make sure That you do
not change the ordering or creation of this folder so that an object owned by
the folder is created before the folder.  If you do the create will fail.


ΓòÉΓòÉΓòÉ 6.3. Programs file name ΓòÉΓòÉΓòÉ

The Path and file name field indicates the location of the program-file object
that starts the selected program object.  If this program object was created
from a template , the field is empty.  If the information is not correct or the
field is empty, type the correct path and file name, for example:
\income\tax\sales.exe

If this program object is for a command-prompt session, you can type an
asterisk (*) in this field.  That enables you to choose whether you want the
command-prompt session to be DOS window, DOS full screen, OS/2 window, or OS/2
full screen.  You also can type an * in this field if you want to choose
WIN-OS/2 full screen as a session.

If you do not specify a full disk/path name, the disk and main install
directory, as specified by the user during the install, will be used.


ΓòÉΓòÉΓòÉ 6.4. Help for Programs Working Directory ΓòÉΓòÉΓòÉ

Note:   Specifying a path to the working directory is optional unless you are
directed to do so in the documentation that came with the program and this
working directory must be something else other than the main directory
specified by the user at install time.

Type a path to the working directory if you want to store files created with
this program in a directory different from the one in which the program-file
object resides.  The path consists of all directories that must be opened to
get to the working directory.

For example, assume you have an editor ABC in the EDIT directory on drive and
main install directory specified by the user at install time. When you use ABC,
you save your created data files in the DOCUMENT subdirectory . Each time the
operating system starts ABC from the program object, the working directory is
the EDIT sub-directory.  Therefore, every time you want to work with one of
your files, you have to type the path to the DOCUMENT subdirectory.

 Instead, you can type the path to the DOCUMENT sub-directory in the Working
directory field.  Then each time you open the program object for the editor,
the operating system changes the working directory from the EDIT directory to
the DOCUMENT subdirectory, where your data files are stored.

Using the previous example, you would type the following in the Working
directory field:

  edit\document

 Note:   If the path in the Working directory field is not valid, you might
receive a warning message from the operating system when you try to open the
program object. To recover from that error, return to this action of the
install procedure and either correct or delete the path in the Working
directory field.


ΓòÉΓòÉΓòÉ 6.5. Help for Programs Parameters ΓòÉΓòÉΓòÉ

Type any parameters that the selected program object needs when it starts or
that you want the program object to use when it is opened.

Not all program objects need parameters when they are opened.  The
documentation for the program should tell you if the program object needs any
parameters and how to use them.

If you want to type parameters each time you start the program object, type a
left bracket character, a space, and a right bracket character in the
Parameters field, as follows: [ ]

When you start the program object, you are then prompted to type the parameters
you want to use.

If you want a special set of characters to be displayed or want to be prompted
by a special set of characters each time you start the program object, type a
left bracket, followed by the characters, followed by a right bracket.  For
example, if you want to be prompted by the words "This is my text editor," type
[This is my text editor ].

The %* parameter is provided by the operating system. It sends the drive letter
and path and file name of a program to the program when it is opened.  The %*
parameter enables you to open a data-file object at the same time you open a
program object, in one of two ways.  You can drag the icon of a data-file
object to the icon of the program object and drop it on the icon.  Or, you can
select a data-file object that you associated to a program. When you type
parameters in the Parameters field, the operating system sends those parameters
to the program object when it is opened and then sends the %* parameter.

Note: Some programs require that a program-specific parameter be the last
parameter sent to the program object when it starts.  In that case, you must
type %* some where before the program-specific parameter.

For example, assume you have an editor that has a program object named My
Favorite Editor.  You always want to open the program object with the program
parameter NOTABS.  The program requires that the NOTABS parameter be the last
one sent to the program object.  Therefore, you would type the following in the
Parameters field:

  %* /notabs

 Assume that you have created a data-file object named ABC.TXT.  If you drag
the icon for ABC.TXT and drop it on the icon for My Favorite Editor, the
program object for the editor is opened with the NOTABS option and ABC.TXT is
displayed.

If you select My Favorite Editor (the program object) without dropping the icon
of a data-file object over the icon for My Favorite Editor, the %* is ignored
and My Favorite Editor is opened with the NOTABS parameter. No data-file object
is displayed in My Favorite Editor.

If you do not want the operating system to send the drive letter and path and
file name of the program to the program when it is opened, you can specify
which parts you want to send by typing a % parameter that is different from %*.
The other % parameters are:

( %**P )

 Insert drive and path information without the last backslash (\).

( %**D )

 Insert drive with 'ile object TEST.SCR.  You want to edit it with the program
ABC.EXE, and then save the edited file with the name TEST.OUT in path OUT on
drive D. In the Parameters field for the program object ABC.EXE, you would type
the following:

  %* d:\out\%**N.out


ΓòÉΓòÉΓòÉ 6.6. Help for Session Type: PM program ΓòÉΓòÉΓòÉ

Program is an OS/2 presentation manager program.


ΓòÉΓòÉΓòÉ 6.7. Help for Session Type: OS/2 Full ΓòÉΓòÉΓòÉ

 Select OS/2 full screen so you can start an OS/2 program and run it so that it
covers the entire screen. For example, you might want to run an OS/2
spreadsheet in a full screen instead of in a window. When you run a  program in
a full screen , you cannot see the windows and icons of the other  programs
that are open.

 Check the documentation for the program to see if the program requires a
specific session.

 Some conditions require that a program use the full screen instead of a
window.  You must use the full screen when the program:

 o Must have access to the physical screen selector

 o Must use the graphics mode of the display adapter

 o Uses the OS/2 monitor facility

 o Calls DosDevIOCtl directly

 o Attempts to register replacements for the Vio, Kbd, or Mou subsystems of the
   operating system.


ΓòÉΓòÉΓòÉ 6.8. Help for Session Type: Os/2 Win ΓòÉΓòÉΓòÉ

Select OS/2 window so you can start an OS/2* program and run it in a window.
When a program runs in a window, you can see the windows and icons of the other
programs that are open.

 Check the documentation for the program to see if the program requires a
specific session.

 Some conditions require that a program use the full screen instead of a
window. You must use the full screen when the program:

 o Must have access to the physical screen selector

 o Must use the graphics mode of the display adapter

 o Uses the OS/2 monitor facility

 o Calls DosDevIOCtl directly

 o Attempts to register replacements for the Vio, Kbd, or Mou subsystems of the
   operating system.


ΓòÉΓòÉΓòÉ 6.9. Help for Session Type: Dos Full screen ΓòÉΓòÉΓòÉ

 Select DOS full screen so you can start a DOS program and run it so that  it
covers the entire screen. For example, you might want to run a DOS  spreadsheet
in a full screen instead of in a window.  When you run a program  in a full
screen, you can not see the windows and icons of the other  programs that are
open.

 If a DOS program does not run the same in the the OS/2* operating system as it
does in DOS, you can select the DOS settings push button and change the
settings for the program or the session in which you run it.


ΓòÉΓòÉΓòÉ 6.10. Help for session type: Dos Window ΓòÉΓòÉΓòÉ

 Select DOS window so you can start a DOS program and run it in a window. When
a program runs in a window, you can see the windows and icons of the other
programs that are open.

 If a DOS program does not run the same in the the OS/2 operating system as it
does in DOS, you can select the DOS settings push button and change the
settings for the program or the session in which you run it.


ΓòÉΓòÉΓòÉ 6.11. Help for Session Type: Windows in OS/2 Window ΓòÉΓòÉΓòÉ

Select Window in OS/2 window so you can start an Windows program and run it in
a window on the OS/2 desktop. When a program runs in a window, you can see the
windows and icons of the other programs that are open.


ΓòÉΓòÉΓòÉ 6.12. Help for Session Type: Windows in OS/2 Full-screen ΓòÉΓòÉΓòÉ

Select WIN-OS/2 full screen so you can start a WIN-OS/2* full-screen session.
When WIN-OS/2 runs full screen, you cannot see the windows and icons of the
other programs that are open.

You can automatically start more than one Windows program in a WIN-OS/2
full-screen session.  For more information about running multiple Windows
programs, select Starting programs automatically in a WIN-OS/2 session or
Windows programs in WIN-OS/2 window sessions in the list below.


ΓòÉΓòÉΓòÉ 6.13. Use default program Icon ΓòÉΓòÉΓòÉ

Use the default icon for the program when it is created on the workplace shell.


ΓòÉΓòÉΓòÉ 6.14. Specify programs icon ΓòÉΓòÉΓòÉ

Specify an icon file to be used as the icon for the program when it is created
on the workplace shell.


ΓòÉΓòÉΓòÉ 6.15. Programs Icon file name ΓòÉΓòÉΓòÉ

Enter the name of the icon file that will replace the default icon. If a disk
and path are not specified then the default main directory and disk specified
by the user at install time is used.  The Icon file should have already been
copied to the location before the program object is created.


ΓòÉΓòÉΓòÉ 6.16. Start program in default view ΓòÉΓòÉΓòÉ

Programs window (if it is running in a window will start in the view specified
by the program.


ΓòÉΓòÉΓòÉ 6.17. Help for Start Program Minimized ΓòÉΓòÉΓòÉ

Select this radio button if you want the program to be displayed as an icon
(instead of an open window) when it is first started.


ΓòÉΓòÉΓòÉ 6.18. Help for Start Program Maximized ΓòÉΓòÉΓòÉ

Select this check box if you want the program to be displayed as an Full Screen
(instead of an open window) when it is first started.


ΓòÉΓòÉΓòÉ 6.19. Help for Close Window on Termination ΓòÉΓòÉΓòÉ

Select this check box if you want the window to close automatically when the
program ends in the window.  A check mark in the check box indicates the choice
is selected.

Note:   You might not want to select this choice if the program you are goin g
to run displays information on the screen when the program ends.  The window
closes immediately and you might not have time to view the displayed
information before it is removed.

This choice is not available for WIN-OS/2 sessions.


ΓòÉΓòÉΓòÉ 6.20. Create new Instances ΓòÉΓòÉΓòÉ

The system default for what happens when you select an object that is open, is
that the window for the object is displayed with its current view (the way the
window was when you removed it from the screen).  By checking this option you
can change the default object behavior so that you open a new window and
display the current view each time you select the icon for the object.  In
effect you are creating a new instance of the program so that two versions of
the program are now running.


ΓòÉΓòÉΓòÉ 6.21. Template  of a Program ΓòÉΓòÉΓòÉ

You can create a template of the program object.  Then each time you drag a
copy from the template, you create a new program that has the same settings as
the original object.

 Whenever you create a template object, the name of the object is added to the
pop-up menu for all objects that have a Create another choice on their pop-up
menu. To view the names of the templates you have created, display a pop-up
menu and select the arrow to the right of Create another.


ΓòÉΓòÉΓòÉ 6.22. Save Program action ΓòÉΓòÉΓòÉ

Saves the create program action and returns to the main screen.


ΓòÉΓòÉΓòÉ 6.23. Destroy Program action ΓòÉΓòÉΓòÉ

Pressing this button will destroy the create program action and return to the
main screen.


ΓòÉΓòÉΓòÉ 6.24. Cancel Changes to Program ΓòÉΓòÉΓòÉ

Cancel any changes to the create program action and return to the main screen.


ΓòÉΓòÉΓòÉ 7. Create Directory ΓòÉΓòÉΓòÉ

This screen allows you to specify the name and path of a directory to create on
the target Machine.  Unless you specify a full disk and path name the directory
will be created inside the main default directory as specified by the user at
install time.  Creating a directory on the Target computer is usually the first
thing you should do before a copy files action.


ΓòÉΓòÉΓòÉ 7.1. Directory name entry field. ΓòÉΓòÉΓòÉ

Name of the directory to be created. If not disk and path is specified the
directory is created inside the main directory as specified by the user at
install time.  If a path is specified, that path must already exist.


ΓòÉΓòÉΓòÉ 7.2. OK Button ΓòÉΓòÉΓòÉ

Saves the create directory action and returns to the main screen.


ΓòÉΓòÉΓòÉ 7.3. Destroy Button ΓòÉΓòÉΓòÉ

Pressing this button will destroy the create directory action and return to the
main screen.


ΓòÉΓòÉΓòÉ 7.4. Cancel Button ΓòÉΓòÉΓòÉ

Cancel any changes to the create directory action.


ΓòÉΓòÉΓòÉ 8. Copy File Action ΓòÉΓòÉΓòÉ

Copy files action.  This screen allows you to define the creation of a copy
files action.  If no path is specified in to from entry field then the current
directory is used.  If not disk/path is specified in the TO entry field then
the disk and directory specified by the user at install time as the main
disk/directory is used as the target.


ΓòÉΓòÉΓòÉ 8.1. No Prompt ΓòÉΓòÉΓòÉ

The user will not be prompted for a new disk or another similar action before
the copy command starts.


ΓòÉΓòÉΓòÉ 8.2. Prompt Message ΓòÉΓòÉΓòÉ

A prompt message will be shown before the copy files command is executed.  The
message that is shown will be the one entered in the message box that appears
when this radio button is clicked.  For instance if the files were to be copied
from a second floppy disk a new disk in the disk drive A you might enter a
message like: Insert disk 2 in Drive A


ΓòÉΓòÉΓòÉ 8.3. User Prompt ΓòÉΓòÉΓòÉ

This is the message that will appear to the user to ask for user interaction
before the files are copied.


ΓòÉΓòÉΓòÉ 8.4. OK Button ΓòÉΓòÉΓòÉ

Saves the new/modified copy files action.


ΓòÉΓòÉΓòÉ 8.5. Destroy Copy file action ΓòÉΓòÉΓòÉ

Pressing this button will destroy the copy file action and return to the main
screen.


ΓòÉΓòÉΓòÉ 8.6. Cancel changes to copy files action ΓòÉΓòÉΓòÉ

Cancel changes to copy files action.


ΓòÉΓòÉΓòÉ 8.7. Copy Files From ΓòÉΓòÉΓòÉ

Copy file from this path and file filter.  If no disk is specified the current
disk will be specified.  If no path specified the current directory (ie the
directory from which the install is being run) will be used.


ΓòÉΓòÉΓòÉ 8.8. Copy Files to ΓòÉΓòÉΓòÉ

Copy files to this directory. Normally this would be the main target directory
specified on the main screen.  If a directory is specified this directory will
be treated as a sub-directory within the main directory.  If a full disk/path
name is specified then that disk/path will be used.


ΓòÉΓòÉΓòÉ 9. Execute OS/2 Command ΓòÉΓòÉΓòÉ

Create a full screen OS/2 command session and run a program or execute an OS/2
command. When the command is created the install program (DIPRUN ) will wait
until it is complete. You have the option to hide this command action or to run
it in the foreground.


ΓòÉΓòÉΓòÉ 9.1. Title of OS/2 session ΓòÉΓòÉΓòÉ

Name of the command as presented to the user.

The Title field displays the name of the object This name is displayed with t
he icon. Type in this field to change the title. You can use any characters,
including sp aces, except the backslash (\).


ΓòÉΓòÉΓòÉ 9.2. Valid Commands ΓòÉΓòÉΓòÉ

Enter a valid OS/2 command or the name of a program to run.

Example OS/2 Command:  PKUNZIP  FILE.ZIP

The command will use the default disk and directory as specified by the user at
install time as the working directory.


ΓòÉΓòÉΓòÉ 9.3. Hide command session ΓòÉΓòÉΓòÉ

Start an separate OS/2 session and execute the specified command or program.
The main install program (DIPRUN) will wait on the completion of this session.


ΓòÉΓòÉΓòÉ 9.4. Minimize session to desktop ΓòÉΓòÉΓòÉ

Selecting this option will run the command minimized to the desktop. Diprun
will still be in the foreground.


ΓòÉΓòÉΓòÉ 9.5. Maximize session ΓòÉΓòÉΓòÉ

Selecting this option will run the command as a full screen session in the
foreground. This is good if you require user input or interaction with the
command or program you are running.


ΓòÉΓòÉΓòÉ 9.6. Save OS/2 command Action contents ΓòÉΓòÉΓòÉ

Save the create OS2 command session action and exit the dialogue.


ΓòÉΓòÉΓòÉ 9.7. Destroy OS/2 Command ΓòÉΓòÉΓòÉ

Pressing this button will destroy the create OS/2 Command session action and
return to the main screen.


ΓòÉΓòÉΓòÉ 9.8. Cancel Command ΓòÉΓòÉΓòÉ

Cancel any changes to the create OS/2 command session action.


ΓòÉΓòÉΓòÉ 10. Data Object Creation ΓòÉΓòÉΓòÉ

This Dialogue allows you to define the creation of a data object or directory
on the workplace shell.  This object is a shadow of a real file or directory
that must already exist on the hard disk.


ΓòÉΓòÉΓòÉ 10.1. Title of data object ΓòÉΓòÉΓòÉ

Name of the Data object as presented to the user.  This name can be changed by
the user after the install.

The Title field displays the name of the object This name is displayed with the
icon. Type in this field to change the title. You can use any characters,
including spaces, except the backslash (\).


ΓòÉΓòÉΓòÉ 10.2. Owning folder ΓòÉΓòÉΓòÉ

 This combo box contains a list of default system folders and folders you have
created that can be used to hold (or own) a new program or data or folder
object.

Once a folder is created its internal name is added to the list of objects that
can be owners of program, data, or other folder objects.  Make sure That you do
not change the ordering or creation of this folder so that an object owned by
the folder is created before the folder.  If you do the create will fail.


ΓòÉΓòÉΓòÉ 10.3. Data file name ΓòÉΓòÉΓòÉ

Name of the data file or directory represented by the data object.  If no
disk/path is specified the default disk and path as specified by the user at
install time is used. You can also specify a subdirectory inside this default
directory. For example: subdir\data.dat.


ΓòÉΓòÉΓòÉ 10.4. Use default data file Icon ΓòÉΓòÉΓòÉ

Use the default icon for the data object when it is created on the workplace
shell.


ΓòÉΓòÉΓòÉ 10.5. Specify an Icon for Data Object ΓòÉΓòÉΓòÉ

Specify an icon file to replace the normal Data file icon when the folder is
created on the workplace shell.


ΓòÉΓòÉΓòÉ 10.6. Icon file name for data object ΓòÉΓòÉΓòÉ

Name of the icon file to replace the normal data icon. If a disk and path are
not specified then the default main directory and disk specified by the user at
install time is used.  The Icon file should have already been copied to the
location before the data object is created.


ΓòÉΓòÉΓòÉ 10.7. Data Object Template ΓòÉΓòÉΓòÉ

You can create a template of the data object.  Then each time you drag a copy
from the template, you create a new data object that has the same settings as
the original object.

 Whenever you create a template object, the name of the object is added to the
pop-up menu for all objects that have a Create another choice on their pop-up
menu. To view the names of the templates you have created, display a pop-up
menu and select the arrow to the right of Create another.


ΓòÉΓòÉΓòÉ 10.8. Save Data Object Button ΓòÉΓòÉΓòÉ

Save Data Object and exit the dialogue.


ΓòÉΓòÉΓòÉ 10.9. Destroy the Data Object ΓòÉΓòÉΓòÉ

Pressing this button will destroy the create data object action and return to
the main screen.


ΓòÉΓòÉΓòÉ 10.10. Cancel changes to dialogue ΓòÉΓòÉΓòÉ

Cancel any changes to the create data object action.


ΓòÉΓòÉΓòÉ 11. Destroy Folder ΓòÉΓòÉΓòÉ

Destroy a Folder object that already exists on the users desktop. All of the
folders contents will be destroyed.  Simply enter the Object ID name (not the
title) of the folder to be destroyed.


ΓòÉΓòÉΓòÉ 12. Messages ΓòÉΓòÉΓòÉ

Messages

 Msg001    Do you wish to exit  'DIP Writer' at this time?

 Msg002    M02 - A file with this name already exists in this directory.
           Overwrite?

 Msg003    M03 - Invalid File Name.