The Ultimedia Application/IBM_UCD_101.ISO/os2se20/disk_12/required/OS2_HELP_MIGRATE.HLP

OS/2 Help File | 1992-09-09 | 13.0 KB | 374 lines

ΓòÉΓòÉΓòÉ <hidden> Help for Find Programs ΓòÉΓòÉΓòÉ

Use this window to start a search of your hard disk for programs to be migrated
to your OS/2* desktop.  (When a program is migrated, an object for that program
is displayed in a folder on the OS/2 desktop.  You can then easily start the
program from the desktop by double-clicking on the object.)

All the drives on your hard disk are listed in the Drives list.  If you do not
want a drive to be searched (because you know that no programs exist on the
drive), remove the highlighting for that drive.

You can choose to migrate DOS programs, OS/2 programs, and programs written for
Windows**.

The Database field lists the name of the default database supplied with the
OS/2 operating system.  Programs on your hard disk are compared against this
database.  Those that are found in the database are placed in a DOS Programs
folder, Windows Programs folder, or OS/2 Program folder on the OS/2 desktop.
You can also use the PARSEDB utility program to create your own database.

o If you want to search all drives for all program types, select Find.
o If you want to specify a different database, different drives, different
  programs, or a combination of each, do the following:

    1. Remove the highlighting from any drives you do not want searched.
       (Either click on the drive letter or press the spacebar to remove the
       highlighting.)
    2. Remove the check mark next to any program type that you not want
       searched.
    3. To use a different database, enter the full path and file name of the
       database in the Database entry field.
    4. Select Find.

For a detailed explanation of each field, select from the list below:

o Drives
o Database
o Migrate
o Find
o Exit


ΓòÉΓòÉΓòÉ <hidden> Help for Drives ΓòÉΓòÉΓòÉ

This list contains letters representing the hard disk drives on your system.
After you select the Find push button, the system looks on every drive selected
in the list to find DOS programs, OS/2* programs, and programs written for
Windows**.  Every drive listed is preselected (highlighted).  If you need to
see more drives, scroll the list.  Remove the highlighting from any drive that
you do not want searched.


ΓòÉΓòÉΓòÉ <hidden> Help for Migrate ΓòÉΓòÉΓòÉ

Use these check boxes to indicate if you want DOS programs, OS/2*, programs,
programs written for Windows**, or all programs migrated. The check mark in
each box shows that the choice is preselected.

Remove the check mark next to any program type that you do not want to include
in the migration.


ΓòÉΓòÉΓòÉ <hidden> Help for Database ΓòÉΓòÉΓòÉ

Use the Database entry field to specify the full path and file name of the
database to be used during migration. A program is eligible for migration if an
entry corresponding to the program's name exists in the database. The default
database the system uses is database.dat.

You can create your own database using the PARSEDB utility program.  This
utility program creates a database that describes the DOS settings needed so
that migrated programs will run more efficiently.

Related Information:

PARSEDB


ΓòÉΓòÉΓòÉ <hidden> Help for Find ΓòÉΓòÉΓòÉ

Select Find to start the search of your drives for programs written for DOS,
OS/2*, Windows**, or all programs.  After the programs are found, a window
appears in which you select those you want to migrate.


ΓòÉΓòÉΓòÉ 1. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel if you decide not to migrate programs.


ΓòÉΓòÉΓòÉ 2. Help for Exit ΓòÉΓòÉΓòÉ

Select Exit to end the program.  If you have migrate programs, the changes will
be saved.


ΓòÉΓòÉΓòÉ <hidden> Help for Migrate Programs ΓòÉΓòÉΓòÉ

Use this window to specify the programs you want migrated.  When you migrate a
program, you can use it in a DOS, OS/2*, or WIN-OS/2 session of OS/2.

All the programs listed are highlighted, indicating that they are preselected
for migration.

o If you want to migrate all the programs listed, select Migrate.
o To migrate only certain programs:

    1. Remove the highlighting from any programs you do not want to migrate.
    2. Select Migrate.

If the list does not include a program you need, select Add Programs to include
other programs in the list for migration.

For a detailed explanation of each field, select from the list below:

o Applications
o Migrate
o Add Programs
o Cancel


ΓòÉΓòÉΓòÉ <hidden> Help for Applications ΓòÉΓòÉΓòÉ

This list contains the names of programs found on the drives that you selected
in the Find Programs window.  Depending upon the selections in the Migrate
field of that window, this list contains DOS programs, OS/2* programs, programs
written for Windows**, or all program types.  You can scroll the list to see
more programs.

Remove the highlighting from any program you do not want to migrate.

If the list does not include a program you need, select Add Programs to specify
other programs to be migrated.


ΓòÉΓòÉΓòÉ <hidden> Help for Migrate ΓòÉΓòÉΓòÉ

Select Migrate to place a program object for each program in the Applications
list in the appropriate folder on the OS/2* desktop.


ΓòÉΓòÉΓòÉ <hidden> Help for Add Programs ΓòÉΓòÉΓòÉ

Select Add Programs to place additional programs in the list of programs ready
for migration.  These additional programs would be migrated using default DOS
settings.  If these programs require special DOS settings, you will have to
apply these settings manually (after they are migrated).

If you decide not to migrate a program after it has been placed in the list,
remove the highlighting from that program name.


ΓòÉΓòÉΓòÉ <hidden> Help for Add Programs ΓòÉΓòÉΓòÉ

Use this window to specify additional programs that you want to migrate.

When the drives specified in the Find Programs window are searched, any files
that match entries in the default database are shown in the Migrate Programs
window.  Any other files with an extension of .CMD, .BAT, .EXE, or .COM are
also available for migration.  Those files are shown in the Available programs
list.

Select any of these programs you want to migrate.  When you select a program
from the Available Programs list, information about the program will appear in
the fields above Available Programs.

The Program title will contain the name of the program as listed in Available
Programs.  The default Working directory will be the same directory in which
the program currently is located.  You can modify the Program title and the
Working directory text to specify the name and directory you want the program
to be identified by. The system will attempt to select the type of program
(DOS, OS/2, Windows) for the highlighted program in Available Programs.

You can specify the parameters for the program in the Parameters field.  To do
this, place the cursor in that field and type the text for the parameters.

If you select Add, the highlighted program will be added to the Selected
programs list.  Once the program is in this list, you can remove it if you
decide that you do not want to migrate the program. To do this, select the
program in the Selected programs list, and then select Remove  This will remove
the program from the list of programs to be migrated.

Once you have completed your list, select OK. This will cause all of the
programs listed in the Selected programs list to be added to the list of
programs in the Migrate Programs window.

For a detailed explanation of each field, select from the list below:

o Program title
o Program type
o Parameters
o Working directory
o Available programs
o Selected programs
o Add
o Remove
o OK
o Cancel


ΓòÉΓòÉΓòÉ <hidden> Help for Program Title ΓòÉΓòÉΓòÉ

The Program title field displays the name of the selected program.  Type in
this field to change the title.  This will be the title displayed below the
icon representing the program once it is migrated.


ΓòÉΓòÉΓòÉ <hidden> Help for Program Type ΓòÉΓòÉΓòÉ

Program type indicates whether the program is a DOS program, OS/2* program or a
program written for Windows**.


ΓòÉΓòÉΓòÉ <hidden> Help for Parameters ΓòÉΓòÉΓòÉ

Type any parameters that the selected program needs when it starts or that you
want the program 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 needs any
parameters and how to use them.


ΓòÉΓòÉΓòÉ <hidden> Help for Working Directory ΓòÉΓòÉΓòÉ

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 files
reside.  The path consists of all directories that must be opened to get to the
working directory.

Specifying a working directory is optional unless you are directed to do so in
the documentation that came with the program.


ΓòÉΓòÉΓòÉ <hidden> Help for Available Programs ΓòÉΓòÉΓòÉ

This list shows the programs found on the drives specified in the Find Programs
window.  The programs are listed in alphabetical order by their full path and
file name.

If you select a program from the list, it will become highlighted and the
information associated with it will be displayed in the fields above Available
programs.  You can then change any of the information in these fields.

After you have selected the program and changed any of its related fields,
select Add to add the program to the Selected programs list.


ΓòÉΓòÉΓòÉ <hidden> Help for Selected Programs ΓòÉΓòÉΓòÉ

This list shows the programs you have selected from the Available programs
list.  All programs in this list will be added to the list of programs in the
Migrate Programs window.

If you decide that you do not want to migrate a specific program, select it and
then select Remove. This will remove the program from the Selected programs
list.


ΓòÉΓòÉΓòÉ <hidden> Help for Add ΓòÉΓòÉΓòÉ

Select Add to put the program in the Selected Programs list.


ΓòÉΓòÉΓòÉ <hidden> Help for Remove ΓòÉΓòÉΓòÉ

Select Remove to remove a program from the Selected Programs list.


ΓòÉΓòÉΓòÉ <hidden> Help for OK ΓòÉΓòÉΓòÉ

Select OK to add the list of programs in Selected programs to the Migrate
Programs window.  These programs will be migrated with the default DOS
settings.  If additional settings are required, you will have to apply these
settings manually.  Select the changing DOS and WIN-OS/2 entry from the
Settings topic of the Master Help Index after OS/2 installation is completed.


ΓòÉΓòÉΓòÉ <hidden> Help for PARSEDB ΓòÉΓòÉΓòÉ

PARSEDB is a tool that generates a binary database from a text file.  This
database is used by the Migrate Applications utility program.  PARSEDB is not a
Presentation Manager application.  It must be invoked from a command prompt.

PARSEDB has three parameters.  The parameters are :

o tag file name

o text database file name

o binary database file name (optional)
It should be invoked by typing the following sequence:

o PARSEDB [path]tag_file [path]text_database [[path]binary_database]

The tag file name is the name of a file that contains the definitions for the
tags used to define settings for programs that can be migrated.  The text
database file name is the name of a file that contains the application settings
for specific DOS, OS/2*, and Windows**, programs.

The settings for a given program are grouped on consecutive lines.  Blank lines
mark the end of a program's settings.  Non-blank lines begin with a token,
which must be defined in the tag file.

The tag file gives the limits, default values, and valid settings for tokens
for the various DOS properties. The lines in the tag file are of the form:
index value type [optional comments]

Index is a number.  Value is the name of the setting. Type is the type of the
value.  The Type must be one of the following:

o NOP   - type for comments, any line with this type will be ignored

o STR   - type for a string value

o INT   - type for an integer value

o BOOL  - type with the values of "on" or "off"

o BYTE  - type for program, either "DOS", "OS/2", or "Windows"

o MLSTR  - type for multi-line string with component lines on individual
  linesin the text database file.

Using these types, various settings for programs can be defined.  The
definition of these types and settings used within OS/2* can be found in the
file dbtag.dat. You cannot create a new tag file; however, the tag file is
available as a reference when creating the database.txt file.

The definitions of the tokens in the tag file are used in defining database.txt
entries.  Database.txt will be used by PARSEDB to create the binary database
file that is used with Migrate.

When creating a text database file, each program must have, at a minimum, the
following migration settings:

o NAME

o TITLE

o TYPE

o ASSOC_FILE

o DEF_DIR
The ASSOC_FILE and DEF_DIR can have the values of NULL; however, they must be
included when defining a program.

A migration database is created after PARSEDB checks for validity of all
entries in the text database file, comparing them to the settings definitions
in the tag file.  If all entries are valid, a binary database is created and
named database.txt by default.  You can specify the name of the binary database
as one of the parameters to PARSEDB.

An error in either of the text files causes PARSEDB to exit with an error
message indicating the nature and location of the error.

Error conditions from PARSEDB are as follows:

o Presence of embedded ASCII NUL characters in either of the text files.  An
  error message that the file is corrupted will be returned.

o Use of a setting not found in the tag file.  An error message indicating the
  use of an illegal setting and the line number and file name will be returned.

o Absence of the minimum settings for an entry.  An error message will be
  returned indicating the entry has missing parameters.

PARSEDB does not check for duplicate entries in either the tag file or the text
database file.  Also, it does not require settings to be in any particular
order.  PARSEDB is not case sensitive.

You should never edit the tag file.  It is only to be used as a reference.