Encapsulation of applications for inclusion within an object management facility environment5832266Abstract A computing system having an object management facility is presented. The object management facility manages a plurality of objects. Each object references an application designed to run in conjunction with the object management facility. The computing system also includes an encapsulation system which facilitates the inclusion in the computing system of a first application not designed to run in conjunction with the object management facility. The encapsulation facility includes an encapsulation shell and a shell filter. The encapsulation shell is referenced by objects as if the encapsulation shell was an application designed to run in conjunction with the object management facility. The encapsulation shell also acts as an interface between the object management facility and the first application. The shell filter interacts with the encapsulation shell and upon instruction from the encapsulation shell is able to intercept commands from a user to the first application. The shell filter also forwards to the first application commands generated by the encapsulated shell. Claims We claim: Description BACKGROUND
TABLE 1
______________________________________
1FirstFreeEntry Contains the record number of the
first free record in HPOMF.CAT,
or "0" if there are no free
records.
FileId Contains the null terminated
string "HPOMF.CAT". This serves
as a signature.
Version Contains the file format version
nunber, which also serves as a
signature.
1MaxRecordNumber
Contains the number of the
highest record ever allocated
from within HPOMF.CAT (this
highest record may or may not be
free).
______________________________________
Table 2, below, contains the fields for file records in HPOMF.CAT for file records other than file record 0:
TABLE 2
______________________________________
1FirstFreeEntry Is "-1" if this record defines an
object, otherwise this record is
free and this field is the record
number of the next free record,
or "0" if there are no more free
records. If the record is free,
none of the other fields in the
record is meaningful.
TypeInclass Specifies the class of this
object. This is the number of
the record in HPOMF.CLS that
indicates to which class the
object belongs (see discussion of
class above).
SysCatFlags Specifies if the object is global
if the bit masked by the number
20 (hexadecimal) is set in this
byte. In the preferred
embodiment all other bit
positions must contain "0" and
are not used.
properties Specifies the number of
properties, the length of the
property names and the location
in HPOMF.PRP of the object's
properties. See the description
of HPOMF.PRP below for further
definition of the structure of
this field.
fastprops Certain object properties, such
as name, are so heavily accessed
that they are stored directly in
this field, rather than
indirectly in the properties
file. Properties stored in this
field are called "fast
properties."
______________________________________
System file 602, HPOMF.CLS is also referred to as SYSCLASS. This system file is a list of all installed classes in the system. It is record oriented. The first record, numbered 0, is a header which contains various signatures (see above) and is used to manage a list of free records. All other records either define an installed class or are free. In the preferred embodiment HPOMF.CLS can grow dynamically, but cannot shrink. Each file record in HPOMF.CLS is thirty-two bytes in length. HPOMF.CLS file record 0 (the header) contains the following fields listed in Table 3:
TABLE 3
______________________________________
1FirstFreeEntry Contains the record number of the
first free record in HPOMF.CLS,
or "0" if there are no free
records.
FileId Contains the null terminated
string "HPOMF.CLS"
Version Contains the file format version
number.
1MaxRecordNumber
Contains the number of the
highest record ever allocated
from within HPOMF.CLS (this
highest record may or may not be
free).
______________________________________
Table 4, below, contains the fields for file records in HPOMF.CLS for file records other than file record 0:
TABLE 4
______________________________________
1FirstFreeEntry Is "-1" if this record defines an
installed class, otherwise this
record is free and this field is
the record number of the next
free record, or "0" if there are
no more free records. If the
record is free, none of the other
fields in the record is
meaningful.
ModuleFileName Specifies the name of the
application associated with
objects of this class as a null -
terminated string.
properties Specifies the number of
properties, the length of the
property names and the location
in HPOMF.PRP of the object's
properties. See the description
of HPOMF.PRP below for further
definition of the structure of
this field.
______________________________________
In FIG. 75, the relationship of HPOMF.CAT and HPOMF.CLS is shown. Within each object entry within HPOMF.CAT, the record number, which is an object's tag, serves as an identifier 650 of data files in a mass storage memory 170 associated with the object. The field "TypeInClass" serves as an identifier 651 of the class entry in HPOMF.CLS, which identifies the class of each object. Within each class entry in HPOMF.CLS, the field "ModuleFileName" serves as an identifier 652 of the application file in mass storage memory 170 which is associated with the class. In FIG. 76, the organization of a portion of mass storage memory 170 is shown. A root directory 660 contains pointers to an HPNWDATA directory 661 and HPNWPROG directory 668. HPNWPROG directory 668 is the location of storage for applications files, represented by arrows 669. HPNWDATA contains a plurality of HPOMFddd directories, represented by directories 662, 663, 664, 665 and 666. In the HPOMFddd directories are stored data files associated with objects. The "ddd" in HPOMFddd stands for a three digit, leading zeros, hexadecimal number. Each HPOMFddd directory has a different "ddd" hexadecimal number. The "ddd" number indicates which HPOMFddd directory stores data files for a particular object. Data files for a particular object are stored in the HPOMFddd directory which has a "ddd" number equal to the tag for the object divided by an integer number, e.g., fifty four. Within each HPOMFddd directory, files are stored by tag numbers, e.g. data file names have the format xxxxxxxx.lll, where "xxxxxxxx" is an eight digit leading zeros hexadecimal tag, and "lll" are a reference chosen by the application. System file 603, HPOMF.XRF is also referred to as SYSXREF. This file is a list of all the links existing in the system. It is record oriented, but does not have a header record. Each record file is either free, or defines an existing link, or is used as an overflow record from the previous record to specify additional view specification information. Records that contain view specifications are called view specification file records. View specification file records can be identified only by a previous record which defines an existing data link; view specification file records cannot be identified by the content within a view specification file record. HPOMF.XRF is increased in size 16K bytes at a time. A newly allocated portion of HPOMF.XRF is filled with zeros. File records within HPOMF.XRF which are free or which define a link have the following fields listed in Table 5:
TABLE 5
______________________________________
ParentTag Contains the tag (HPOMF.CAT
record number) of the parent
object of this link. If this
field is 0, then this record does
not define a link and is free.
ChildTag Contains the tag of the child
object of this link. If
ParentTag in this record is 0,
and this field is also 0, then no
record beyond this record in
HPOMF.XRF defines a link.
RefName Contains the reference name that
the parent has assigned to the
link. This field is meaningless
if ParentTag or ChildTag is zero.
0therwise, if the top three bits
of this value are 110, the next
record in the file is a view
specification.
______________________________________
File records within HPOMF.XRF which are view specification file records have the following fields listed in Table 5A:
TABLE 5A
______________________________________
DataId Contains the value that the child
has assigned to identify the part
of itself that is being viewed
through the link.
Snapshot Contains the tag (HPOMF.CAT
record number) of the object
which is the view's snapshot, or
if zero, the view has no
snapshot. For further discussion
of snapshots, see below.
Misc Composed of several bit fields
described below:
VS.sub.-- NEWDATASET
Set if child has told OMF
that new data is available,
but has not been announced
to the parent. The
hexadecimal number 8000 0000
is a mask which indicates
which bits are used for this
bit field.
VS.sub.-- NEWDATAANNOUNCED
Set if child has told OMF to
announce new data to parent,
but parent was inactive and
was not notified. The
hexadecimal number 4000 0000
is a mask which indicates
which bits are used for this
bit field.
VS.sub.-- SNAPSHOTOLD
Set if child has told OMF
that the view's snapshot is
out-of-date. The
hexadecimal number 2000 0000
is a mask which indicates
which bits are used for this
bit field.
VS.sub.-- WANTMESSAGES
Set if chi1d has told OMF
that it wants to process
view messages when snapshot
is out-of-date. The
hexadecimal number 1000 0000
is a mask which indicates
which bits are used for this
bit field.
VS.sub.-- TEXTDISKLOC
File position in HPOMF.PRP
where a view's 32 character
textual data ID is located.
This contains zero if no
textual data ID has been
defined by the child. The
low order five bits of the
file position are always
zero and are thus not stored
in the Misc field. The
hexadecimal number 0FFF FFE0
is a mask which indicates
which bits are used for this
bit field.
VS.sub.-- INITIALIZED
Set if the view
specification has been
initialized. If clear, all
information in the view
specification is zero. The
hexadecimal number 0000 0010
is a mask which indicates
which bits are used for this
bit field.
VS.sub.-- RESERVED
Reserved for future
expansion. The hexadecimal
number 0000 0008 is a mask
which indicates which bits
are used for this bit field.
VS.sub.-- VIEWCLASS
Specifies the view class the
child assigned to the view.
The view class defines what
view methods are available
to the parent. The
hexadecimal number 0000 0007
is a mask which indicates
which bits are used for this
bit field.
______________________________________
For example, in FIG. 77, Object 671 is a folder and has a tag of "6". Object 671 is a parent of an object 672 through a link 674 and a parent of an object 673 through a link 675. Object 672 has a tag of "12". Link 674 as a reference name "1". Object 673 has a tag of "19". Link 675 has a reference name "7". Reference names are picked by the parent object and need to be unique for the particular parent object; however, other parents may have a link with the same reference name provided each reference name is unique for each parent. FIG. 79 shows a block diagram of HPOMF.XRF 603. HPOMF.XRF contains an entry for each link between parents and children. In HPOMF.XRF 603 column 731 contains the tag of the parent for each link. Column 732 contains the tag of the child for each link. Column 733 contains the reference name for each link. The first three bit positions of column 733, shown in FIG. 79 as sub-column 734, indicate whether a view specification file record is present ("110") whether no view specification file record follows ("000") or whether the link is between is a link from the global parent to a global object ("100"). As may be seen, entry 735 is an entry which describes link 674 shown in FIG. 77. That is, in column 731 of entry 735 there is the parent tag "6". In column 732 there is the child tag "12" and in column 733 there is the reference name "1". Since object 671 is a folder, there is no view, therefore the three bits within subcolumn 734 would be "000". Similarly, entry 736 is an entry which describes link 675 shown in FIG. 77. That is, in column 731 of entry 736 there is the parent tag "6". In column 732 there is the child tag "19" and in column 733 there is the reference name "7". Since object 671 is a folder, there is no view, therefore the three bits within subcolumn 734 would be "000". In FIG. 78, Object 676 is a document and has a tag of "17". Object 676 is a parent of an object 677 through a link 679 and a parent of an object 678 through a link 680. Object 677 has a tag of "8". Link 679 as a reference name "1". Object 678 has a tag of "21". Link 680 has a reference name "3". In FIG. 79, an entry 737 describes link 679 shown in FIG. 78. That is, in column 731 of entry 737 there is the parent tag "17". In column 732 there is the child tag "8" and in column 733 there is the reference name "1". Object 676 is a document, and assuming there is a view associated with link 679, the three bits within subcolumn 734 contain the three bits "110" and entry 738 is a view specification record. Similarly, an entry 739 describes link 680 shown in FIG. 78. That is, in column 731 of entry 739 there is the parent tag "17". In column 732 there is the child tag "21" and in column 733 there is the reference name "3". Assuming there is a view associated with link 680, the three bits within subcolumn 734 contain the three bits "110" and entry 740 is a view specification record. In FIG. 80, view specification record 740 is shown to include a field 741 which contains a data identification for the view, a field 742 which indicates whether there is a snapshot used in the view, and a field 743 which contains miscellaneous information about the view. The data identification number is used by the child object of the link, to determine what data is sent through the link. FIGS. 37-43 show the establishment of a link with a view. As has been discussed before, in FIG. 37 window 791 for "Paste Up" (object 707) has been opened by double clicking on the icon for "Paste Up". In FIG. 38, using Cursor 781, controlled by mouse 20, portion 790 of the text of "Sample Text" has been selected. The portion in inverse video stating "New Wave Office environment" is portion 790. In FIG. 39, cursor 781 is used to select the selection "Share" in a pull down menu 792. Once "Share" is selected, child object 709 ("Sample Text") creates a data identification number which identifies portion 790 of the text to child object 709. Child object 709 also causes OMF 100 to put a link to child object 709 on clipboard 720--Child object 709 communicates to OMF 100 through command set forth in Appendix B, which can be found in the application file. Child object 709 also informs OMF 100 what data identification number is associated with the new link between the child 709 and clipboard 720. If there is a snapshot associated with the link, child 709 will also inform OMF 100 if there is a snapshot associated with the link. Snapshots are discussed more fully below. As a result OMF 100 will make an entry in HPOMF.XRF 603 for a link between clipboard 720 and child object 709. The view specification record for the link will include the data identification number given to OMF 100 by child 709. In FIG. 40, area 793 in window 791 is selected using cursor 781. In FIG. 41, a selection "Paste" is selected from a pull down menu 794 using cursor 781. At this point parent object 707 ("Paste Up") requests OMF 100 for a link making him the parent of what is on clipboard 720. The view specification record for the between clipboard 720 and child 709 is copied for link 729 between parent 707 and child 709. In FIG. 43 "Sample Text" (object 709) is shown to be a child of "Paste Up" (object 707) through link 729. In FIG. 42, "displayed text 790 is displayed in "Paste Up" window 791. In accomplishing this, parent object 707 makes a call to OMF 100 asking that a message be sent to the object identified by the reference name for link 729. This message requests the child object 709 to display data from this link into a location specified by parent object 707. OMF 100 takes the message from parent 707, adds the data identification number from the view specification record for link 729, and delivers the message to child 709. Child 709 displays the data in the specified location, in this case area 793. The name of the message sent from parent 707 to OMF 100 to child 709 is "DISPLAY.sub.-- VIEW", further described in Appendix B, which can be found in the application file. Another message "PRINT.sub.-- SLAVE", also described in Appendix B, which can be found in the application file, may be used when it is desired to print data on a printer rather than display data on a terminal screen. In addition, Parent 707 may send a "GET.sub.-- SIZE" message to child object 709. In a "GET.sub.-- SIZE" message, parent object 707 identifies a reference name for link 729 and indicates coordinates for a display. OMF 100 takes the GET.sub.-- SIZE message from parent 707, adds the data identification number from the view specification record for link 729, and delivers the message to child 709. Child 709 returns to parent 707 the size of the portion of the specified area that child 709 would use to display the data. This allows parent 707 to modify the region reserved for displaying data from child 709 when child 709 is not able to scale the data to fit in the region specified by parent 707. When a data from a child object is being displayed by a parent object, and the child object changes the displayed data, the child objects notifies OMF 100 that there has been a change in the data object. For example, as described above, in FIG. 47, data from "Star" (object 706) now displayed in region 795 of window 791. And, as may be seen in FIG. 48, "Star" (object 706) is a child of "Paste Up" (object 707) through a link 726. Since data is being passed from child object 706 to parent object 707, link 726 is a data link which includes a view specification. In FIG. 49, the method for changing data in child object 706 is shown. A user places cursor 781 over region 795 of window 791 and double clicks a button on mouse 20. The result is the opening and display of "Star" (object 706) in a window 796. Using cursor 781 to select selection "Ellipse" in a menu window 797 results in the data within "Star" (object 706) being changed from a star to an ellipse. As shown in FIG. 51, the result is a change both in data displayed in window 796 and data displayed in region 795 of window 791. Child object 706 accomplishes this change by making a call to OMF 100 stating that data associated with the data identification number associated with link 726 is changed. OMF 100 looks up all of the links that use the data identification number. If the parent object of any of the links is not active, OMF 100 sets the bit VS.sub.-- NEWDATAANNOUNCED for that link in HPOMF.XRF. When the parent object is activated, the parent object can then request the new data. If the parent object is active, OMF 100 will send a message to the parent object saying that new data is available. OMF 100 will identify to the parent object the reference name of the link for which there is additional data. The parent object sends a message to the child object if it wants the new data displayed. In the present case parent object 707 is active, and has requested the new data to be displayed in region 795 of window 791. A further description of the View Specifications are found in Appendixes B, C and D, all of which can be found in the application file. The advantage of the present invention is that parent object 707 is able to communicate with child object 706 through OMF 100, without parent object 707 or child object 706 knowing the identity or any other details about each other. The parent object identifies the link using only the reference name of the link. The child object identifies the link using just the data identification number of the link. OMF 100 does all the translation and identification of which links and which objects are involved. System file 604, HPOMF.PRP, is also referred to as SYSPROP. HPOMF.PRP contains all the object and class properties except for the fast object properties which are contained in HPOMF.CAT. Each record in system file 601 (HPOMF.CAT) and system file 602 (HPOMF.CLS) has a properties field, as described above. Each properties field contains the fields described in Table 6 below:
TABLE 6
______________________________________
DirDiskLoc Contains the position (byte
offset) within HPOMF.PRP of the
property list directory.
nProps Contains the number of properties
in the property list. This is
the number of entries in the
directory entry array described
below.
PoolSize Contains the conbined length of
al1 the names of the properties
in the property list, including a
null-terminating byte for each
name. This is the size of the
directory name pool described
below.
______________________________________
For each object and for each class, at the DirDiskLoc position in the HPOMF.PRP file is the property directory for that object or that class. The directory has two major portions: the entry array, followed by the name pool. The entry array has one entry for each property in the property list. Each entry has fields set out in Table 7 below:
TABLE 7
______________________________________
ValueLen Specifies the length in bytes of
the associated ptop.erty. This
can be zero.
ValueDiskLoc Contains the position within
HPOMF.PRP of the value of the
associated property. If ValueLen
is zero, this is also zero, and
there is no value stored
anywhere.
CacheOffset This field is only used at run
time and is not meaningful in the
file.
______________________________________
Immediately following the entry array is the name pool. This portion of HPOMF.PRP contains the null-terminated names of properties in the property list, in the same order as the entry array. Properties may include such things as titles, user comments, date and time of creation, the user who created the object, etc. For more information on properties, see Appendix D, which can be found in the application file. HPOMF.PRP grows dynamically as need. At the beginning of HPOMF.PRP there is a 128 byte bitmap which controls the allocation of the first 1024 pages of HPOMF.PRP. Each page is 32 bytes in length. These pages immediately follow the bit map. The bitmap is an array of words with the most significant bit of each word used first. Thus, bits 15 through 0 of the first word of the bitmap control the allocation of pages 0 through 15 of the file, respectively. When storage in the first 1024 pages is insufficient, a second bitmap is added to the file following page 1023. This bitmap controls the allocation of pages 1024 through 2047, which immediately follow the second bitmap. Additional bitmaps and pages are added in the same way, as needed. Each directory and property value is stored as a single block in the file, i.e., as a contiguous run of pages that are all allocated in the same bitmap. This causes the restriction that no directory or value can exceed 32K bytes (1024 times 32) in length. System file 605, HPOMF.INS, is also referred to as SYSINSTL. HPOMF.INS contains a list of the files that were copied to the system when each class was installed. This information is used so that these files can be deleted when the class is de-installed. The very beginning of HPOMF.INS is a double word value which serves as a validity/version identifier. In the preferred embodiment the value of this double word must be 0101ABCD hex to be valid. In Table 8, this number is stored as shown because of the protocols for storage in the particular processor used by the preferred embodiment, i.e. an 80286 microprocessor made by Intel Corporation. Following the double word comes a series of variable length records. There is one record for each installed class. The first word of each record is the length of the rest of the record, in bytes. This is followed by the null--terminated class name of the installed class. Then follows the file names of the files copied to the OMF directories, each terminated by a null byte, and preceded by a byte which gives the length of the file name, including the length byte and the null terminator. If the file name begins with the special character "*", the file is assumed to be located in the HPNWPROG directory. If the file name begins with the special character "+" the file is assumed to be located in the HPNWDATA directory. For example, assume two classes are installed: class "AB" and class "CDE". Class "AB" caused two files to be installed: "Z" to HPNWPROG directory 668 and "YY" to the HPNWDATA directory. Class "CDE" caused 1 file to be installed: "XXX" to HPNWPROG directory 668. Given this case Table 8 below shows the contents of HPOMF.INS for this example:
TABLE 8
______________________________________
offset content comments
______________________________________
0 CD AB 01 01 File header/version check
4 0C 00 Length of AB record (12
decimal)
6 41 42 00 "AB" + Null
9 04 Length of length byte "*Z" +
Null
A 2A 5A 00 "*Z" + Null
D 05 Length of length byte + "+YY" +
Null
E 2B 59 59 00 "+YY" + Null
12 0A 00 Length of CDE record (10
decimal)
14 43 44 45 00 "CDE" + Null
18 06 Length of length byte + "*XXX" +
Null
19 2A 58 58 58 00
"*XXX" + Null
______________________________________
System File 606, HPOMF.SDF is also referred to as the "shutdown file". HPOMF.SDF exists only when the system has been cleanly shut down. It is deleted as the system starts, and created as it shuts down. On startup, if this file is missing, OMF assumes that the last session ended abnormally, and so it goes through its crash recovery procedures to validate and repair the system files as best it can. The system files can be in an invalid but predictable state on a crash. These errors are corrected without user intervention. Certain other kinds of file consistency errors are detected, but are not really possible from an "ordinary" system crash. These errors are in general not correctable and the OMF will not allow the system to come up in this case. If HPOMF.SDF is present, it contains a list of objects. When the system is being shut down normally, each object which is active at the time can request that the OMF restart them when the system is restarted. The list of objects, then is the list of tags of objects which have requested that they be restarted when the system is restarted. The first word in HPOMF.SDF is a flag word. If this word is non-zero, OMF will execute its crash recovery code even though HPOMF.SDF exists. Normal shutdown will set this flag when producing the file if some serious error occurred in the session being ended. After the first word, the rest of the file is a sequence of three byte records. The first two bytes of each record contain the tag of the object to be restored. The least significant byte is first. The third byte is not used in the preferred embodiment, and is zero. For example, if the system is shut down cleanly in the last session and two objects, having tags of 2 and 7, respectively, have requested restart, the contents of HPOMF.SDF will be as set out in Table 9 below.
TABLE 9
______________________________________
offset content comments
______________________________________
0 00 00 Indicates no crash recovery needed
2 02 00 Tag of first object to restart
4 00 Unused and reserved
5 07 00 Tag of second object to restart
7 00 Unused and reserved
______________________________________
System file 7, HPOMFICO.NWE, is a Microsoft Windows dynamic library executable file which contains a dummy entry point and no data. Microsoft Windows is a program sold by Microsoft Corporation, having a business address at 16011 NE 36th Way, Redmond, Wash. 98073-9717. HPOMFICO.NWE also contains as "resources" the icons of each installed class. OMF modifies HPOMFICO.NWE directly during run time, and loads and unloads it to get the icon resources from it. The format of HPOMFICO.NWE is defined in Microsoft Windows documentation distributed by Microsoft Corporation. Normally working with a view (see discussion on views above) causes a child's application to be invoked. Where large applications are involved, this can cause a lot of unnecessary overhead. The use of snapshots allow this overhead to be eliminated. A snapshot is an object that uses executable code from a separate library referred to as a dynamic access library (or DAL) rather than using the full application executable code. The only data file associated with a snapshot contains data which is to be sent from a child object to a parent object. The code which encapsulates the data file although referred to as a dynamic library, is still stored in directory HPOMFPROG (directory 668). For example, FIG. 81 shows a parent object 501 linked to a child object 502 through a link 504. Associated with link 504 is a snapshot 503. Once child object has designated snapshot 503 in a view specification record for link 504, snapshot 503 is able to provide data from child object 502 to parent 501 without the necessity of invoking an application associated with child object 502. As shown in FIG. 82, when there is no snapshot, child object 502 must be active in order to send view data 522 to parent object 501, in order for parent object 501 to display view data 522 in a window display 521. In FIG. 83, however, snapshot 503 is shown to provide view data 522 to parent object 501 without the necessity of child 502 being active. Further implementation details of snapshots are given is Appendix B, Appendix C and Appendix D, all of which can be found in the application file. A program not originally written for use with OMF 100 may be encapsulated and inherit many features of programs designed for use with OMF 100. In Chapter 6 of the HP NewWave Environment: Programmer's Guide, attached hereto as Appendix D, which can be found in the application file, implementation details for designing an encapsulating program are given. In Appendix E, which can be found in the application file, a listing is given of a program which provides for generic encapsulation of programs. In Appendix F, which can be found in the application file, examples are given of files which need to be created for encapsulation of a program into the NewWave Environment. With the use of FIGS. 84-145 the features of encapsulated applications are described. FIG. 84 is a block diagram which shows how an application 846 may be encapsulated for use with OMF 100. As may be understood from prior discussion and illustrated by FIG. 84, typical applications 842 written for the NewWave environment are able to interact directly with a user 843 and with OMF 100. Data files for applications 842 are part of OMF data files 840. When any of applications 842 wish to access data files, they do so through OMF 100. In accordance with the preferred embodiment of the present invention, no modifications need be made to encapsulated application 846 in order to integrate it into the NewWave Environment. Encapsulated application 846 is allowed to continue to directly manipulate its own user data files 849. An encapsulation shell 845 serves as an interface between OMF 100 and encapsulated application 846. Encapsulated application does not know that encapsulation shell 845 exists, therefore encapsulated application 846 does not send data to encapsulation shell 845. However encapsulation shell 845 does interact with encapsulated application 846 and with user data files 849. A shell filter 844 acts as a monitoring program between user 843 and encapsulated application 846. Most communication between user 843 and encapsulated application 846, shell filter 844 merely passes on. However, where appropriate shell filter may intercept communication between user 843 and encapsulated application 846. Once the communication has been intercepted shell filter may, for example, pass the communication to encapsulation shell 845 for further processing. Encapsulation shell 845 is written to generically handle a number of different types of applications. However, there is some information which encapsulation shell 845 needs to know about each encapsulated application. Therefore, each encapsulated application has associated with it configuration properties which encapsulation shell 845 accesses for information encapsulation shell needs to know about that encapsulated application. For encapsulated application 846, encapsulation shell 845 accesses information stored in configuration properties 847. Further, using shell filter 844 and encapsulation shell 845 additional features may be added to an encapsulated application. Definitions for such added features particular to a specific application may be stored in a separate file accessed by encapsulation shell 845. For example, definitions for features specific to encapsulated application 846 are stored in a menu/macro definitions file 848. FIG. 84A shows an an example of how a file structure may be implemented in accordance with a preferred embodiment of the present invention. A root directory 850 has a plurality of subdirectories. A subdirectory 851 contains a series of subdirectories--e.g., subdirectory 855, subdirectory 856 and subdirectory 857--which contain OMF object data files. The files within subdirectory 851 are files which are within the NewWave data domain, that is these files are accessed through OMF 100. A subdirectory 852 contains a series of subdirectories--e.g., subdirectory 858, subdirectory 859, subdirectory 860 and subdirectory 861--which contain encapsulation data files for various encapsulated applications. Subdirectory 852 contains a second series of subdirectories--e.g., subdirectory 865, subdirectory 866 and subdirectory 867--which contain temporary data files used for encapsulation conversion. A subdirectory 853 contains files which include executable code which create and maintain the NewWave environment. Subdirectory 854, subdirectory 862, subdirectory 863 and subdirectory 864 contain executable code for applications which are not specifically designed to operate in the NewWave environment. In FIG. 84B, the anatomy of a file specification for files used in MS-DOS systems is shown. File specification includes a drive designation 874, a directory path 871, a file root name 872 and an extension 873. In the following discussions, a computer session in conjunction with figures depicting screens appearing on monitor 14, is used to illustrate the functionality of encapsulation shell 845 with an encapsulated application. In FIG. 85 the window for NewWave office is shown to have a number of icons some of which represent objects which are encapsulated applications. Of the shown objects "AdvanceLink", "Info. Access", "Terminal", "Calendar" and "Calculator" are encapsulated applications. From a user's point of view, creating a new encapsulated object may be done similar to creating ordinary objects. In FIG. 85A, cursor 781 is used to select "Create a New . . . " from pull down menu 782. After the selection, dialog box 779 appears, as shown in FIG. 86. The five icons displayed within dialog box 779--"AdvanceWrite", "MS-Word", "WordPerfect", "MS-Write" and "MS-Paint"--represent encapsulated applications. Icon "MS-Write" is highlighted and thus selected. Cursor 781 now is used to select the region labelled "OK". Once this region is selected, a dialog box 1101 appears, as shown in FIG. 87. A default directory for data files for "MS-Write" appears in a region 1104. The default directory is "C:.backslash.HPNWDOS.backslash.MSWRITE". This corresponds to subdirectory 861 shown in FIG. 84A. In a box 1102 is listed the existing applications files in the default directory. A new name for a file may be written into a region 1106 using keyboard 19. In FIG. 88, the name "sample" has been typed into region 1106. After cursor 781 is used to select the region labelled "OK", an object "Sample" appears in the window for "NewWave Office" as shown in FIG. 89 and pointed to by cursor 781. A data file "SAMPLE.WRI" is created and placed in directory "C:.backslash.HPNWDOS.backslash.MSWRITE" (subdirectory 861). Although the user sees very few differences in the creation of an object which references an encapsulated program, OMF 100 and encapsulation shell 845 make various adjustments to the standard procedure. In the description of the flowchart in FIG. 143, below, the process OMF 100 and encapsulation shell 845 go through when an object is created is described. When cursor 781 is placed over the word "SAMPLE" in icon "SAMPLE" a button on mouse 20 is clicked, the directory location of the data file "SAMPLE.WRI" is displayed, as shown in FIG. 90. The object name "SAMPLE" may not be changed. In the preferred embodiment, the only way to change the name is to copy the object, thus making a new data file in directory "C:.backslash.HPNWDOS.backslash.MSWRITE". Another click on a button of mouse 20 results in the directory location no longer being shown, as is seen in FIG. 91. The application for "SAMPLE" may be opened by placing cursor 781 over the icon for "SAMPLE", as shown in FIG. 91, and twice clicking a button on mouse 20. In the description of the flowchart in FIG. 141, below, the process OMF 100 and encapsulation shell 845 go through before opening an object for an encapsulated application is further described. Once OMF 100 determines that it can open the encapsulated application, OMF 100 sends to encapsulation shell 845 a message to open the object associated with the selected encapsulated application. Encapsulation shell 845 accesses configuration properties 847 for a command string and parameters (and optionally a keystroke macro) which will start the selected encapsulated application. Encapsulation shell 845 monitors the initiation of the encapsulated application and installs shell filter 844 to control interactions between user 843 and the encapsulated application 846. The optional keystroke macro is fed to the encapsulated application via shell filter 844. For encapsulated applications for which menu/macros have been written, encapsulation shell 845 secures information about menu/macros from menu/macro definitions file 848. This information is maintained in the memory of computer 18 to allow shell filter 844 to respond to any actions by the user which invoke a menu/macro. This involves, for example, the interception by shell filter 844 of a particular keystroke sequence. When this keystroke sequence is recognized, shell filter 844 displays the menus specified by menu/macro definitions file 848. At this point shell filter 844 intercepts all user commands from keyboard 19 or mouse 20 until user 843 selects a menu command or cancels the menu access. When a menu command is selected, shell filter 844 sends a keystroke macro, stored in menu/macro definitions file 848, which is associated with the selected menu command to encapsulated application 846. In FIG. 92 a window 1103 is shown open for the application "Write". "Write" is a word processing program distributed my Microsoft Corporation and is designed to operate in conjunction with Microsoft's Windows program. The application name appears in the title of Window 1103 as "Write". Using keyboard 19, data may be entered as shown in FIG. 93. Using cursor 781 to select "Exit" in a pull down menu 1105, as shown in FIG. 94, starts the Exit process. Shell filter 844 intercepts this message requesting termination. As shown in FIG. 95, as part of the exiting procedure "Write" produces dialog box 1107 which asks whether the user wishes to save changes made to the file. If yes, the changes are made to data file "SAMPLE.WRI" in directory "C:.backslash.HPNWDOS.backslash.MSWRITE". Shell filter 844 notifies encapsulation shell 845 that the user is terminating his session with encapsulated application 849. Encapsulation shell 845 informs OMF 100 that the encapsulated application is closing. Encapsulation shell 845 terminates shell filter 844. Based on information supplied in configuration properties 847, encapsulation shell 845 performs automatic registration of files and file conversions procedures discussed below. Then encapsulation shell 845 returns control to OMF 100. When specified in configuration properties 847, encapsulation shell 845 performs automatic registration of files as follows. Encapsulation shell 845 records the system time when it starts encapsulated application 846. When encapsulated application 846 is terminated, encapsulation shell 845 searches the default referenced file area for the encapsulated application--i.e., the subdirectory of subdirectory 852 which corresponds to the encapsulated application--and compares a timestamp of each file with the recorded start time of the encapsulated application. If a new file is located and that file is not already referenced by an object, encapsulation shell 845 automatically creates a new object of the same class as encapsulation shell 845. The new object references the new file and encapsulation shell 845. The title of the new object is set to the file name of the new file. This process is done for all new files that are found. This allows the user to create new files while running the encapsulation program. When the application is closed, new icons are displayed which represent the files that were created. In addition, if specified by configuration properties 847, at termination time other subdirectories within subdirectory 852 which represent other encapsulated classes may be searched for files which have a timestamp later than the recorded start time of the encapsulated application. Encapsulation shell 845 may then create objects for these files, which are of the appropriate class. These new files also appear as new icons when the application is closed. In FIG. 96, "SAMPLE" has been closed. Objects which include encapsulated applications may be manipulated by a user in the same way as the user manipulates normal objects. For example, in FIG. 97 a new folder entitled "Important Docs" has been created and opened. In FIGS. 97 and 98 Cursor 781 is shown moving the object "SAMPLE" to an opened window 1107 for folder "Important Docs". In FIG. 99, object "SAMPLE" is shown within window 1107. As shown in FIG. 100, placing cursor 781 over the name "SAMPLE" and clicking a button on mouse 20 has resulted in the full name "C:.backslash.HPNWDOS.backslash.MSWRITE.backslash.SAMPLE" appearing. The actual location of the data file "SAMPLE.WRI" in directory "C:.backslash.HPNWDOS.backslash.MSWRITE" is unchanged, although the object "SAMPLE" has moved from the "NewWave Office" to folder "Important Docs". Also, "Cut", "Paste", "Share" and "Copy" commands for encapsulated applications are performed by a user in the same way as the user performs "Cut", "Paste", "Share" and "Copy" commands for ordinary objects. In FIG. 101, the object "SAMPLE" has been selected. Cursor 781 is used to select the command "Cut" from a pull down menu 1109. The result, seen in FIG. 102, is that object "SAMPLE" has been "cut" from folder "Important Docs" and therefore no longer appears in window 1107. Also in FIG. 102 the command "Paste" from pull down menu 783 is selected using cursor 781. The result, seen in FIG. 103 is object "SAMPLE has been moved from folder "Important Docs" to "NewWave Office". Again, placing cursor 781 over the name "SAMPLE" and clicking a button on mouse 20 results in the full name "C:.backslash.HPNWDOS.backslash.MSWRITE.backslash.SAMPLE" appearing. The actual location of the data file "SAMPLE.WRI" in directory "C:.backslash.HPNWDOS.backslash.MSWRITE" is again unchanged. Also, in FIG. 104, Object "SAMPLE" is shown highlighted and thus selected. The command "Share" in pull down menu 783 is selected using cursor 781. In FIG. 105, the command "Paste" in pull down menu 1109 is selected. The result, shown in FIG. 106, is object "SAMPLE" being shared, and appearing in both the window "NewWave Office" and in window 1107. In FIG. 107, Object "SAMPLE" in "NewWave Office" is shown highlighted and thus selected. Cursor 781 is used to select command "Copy" in pull down menu 783. In FIG. 108, cursor 781 is used to select command "Paste" in pull down menu 783. The result, shown in FIG. 109, is "Copy of: SAMPLE" appearing in "NewWave Office". At this point all files for object "Copy of: SAMPLE" are stored as ordinary objects, in one of the subdirectories of subdirectory 851. There is no new file placed in subdirectory 851, that is, directory "C:.backslash.HPNWDOS.backslash.MSWRITE". When object "Copy of: Sample" is opened, by placing cursor 781 over "Copy of:SAMPLE" and twice clicking a button on mouse 20, as shown in FIG. 110, OMF 100 calls encapsulation shell 845. Encapsulation shell 845 checks to see if a "copied object" flag is set. If the copied object flag is set, that indicates to OMF that the user is trying to open a "copied object" that is, an object which references data for an encapsulated application which has been copied and for which the data file has not yet been stored in a subdirectory of subdirectory 851 and has not been moved to a subdirectory of subdirectory 852 where it is to be made available to the encapsulated application. In the present case, since the user is attempting to open a "copied object" encapsulation shell 845 prompts the user for a new name by causing dialog box 1101 to appear, as shown in FIG. 111. As can be seen from comparing FIG. 88 with FIG. 111, the file SAMPLE.WRI has been added to box 1102. This happened when object "SAMPLE" was created. As is seen from FIG. 112, the user has entered via the keyboard the new name "MYDOC2" for object "Copy of: Sample". After selecting the region "OK" in FIG. 112 with cursor 781, encapsulation shell 845 moves the data file from its location in a subdirectory of subdirectory 851 where it formally resided in the OMF data file storage domain, to a location in subdirectory 861. Then encapsulation shell 845 starts the application "Write" and gives "Write" the file name "MYDOC2". "Write" opens "MYDOC2". The contents of "MYDOC2" are a copy of data from object "SAMPLE" and are seen in window 1113 of FIG. 113. When object "MYDOC2" is closed, an icon for "MYDOC2" is seen in "NewWave Office", as shown in FIG. 114 and pointed to by cursor 781. As shown in FIG. 115, placing cursor 781 over the name "MYDOC2" and clicking a button on mouse 20 results in the full name "C:.backslash.HPNWDOS.backslash.MSWRITE.backslash.MYDOC2" appearing. The location of the data file "MYDOC2" is in directory "C:.backslash.HPNWDOS.backslash.MSWRITE". As shown in FIG. 116, a shorthand way of copying "MYDOC2" is to place cursor 781 over "MYDOC2", depress and hold the "Ctrl" Key on the keyboard while simultaneously depressing a button on mouse 20 and dragging cursor 781 to another location. During this operation the icon for "MYDOC2" remains highlighted in black, rather than becoming gray as when "moved" or "opened". The result, shown in FIG. 117, is the appearance of "Copy of: MYDOC2" on "NewWave Office". In FIG. 118 object "MYDOC2" and "Copy of: MYDOC2" have been selected. These items may be removed from the system by selecting command "Throw Away" in pull down menu 783 as shown. In FIG. 119 cursor 781 is used to select the command "Destroy All Items" in pull down menu 1117. The result, shown in FIG. 120, is the deletion of objects "MYDOC2" and "Copy of: MYDOC2". In the case of "MYDOC2, the encapsulation shell deletes the file in the user file area. For "Copy of: MYDOC2", the OMF deletes the file in the OMF file area. FIGS. 121A, 121B and 122 contain a flowchart which describe the steps taken by encapsulation shell 845 upon the closing of a current application. The program executed by encapsulation shell 845, described by the flowchart, is entered upon the closing of the current application, as indicated by a step 950. In a step 951, a file HPOMF.DOS is accessed. HPOMF.DOS is a file accessed and maintained by encapsulation shell 845 to keep track of MS-DOS files. It provides the necessary information to map OMF objects to encapsulated files. HPOMF.DOS is further described herein in the discussion of FIGS. 144 and 145. Using HPOMF.DOS encapsulation shell 845 obtains the property "PROP.sub.-- ENCAPDATADIR". Property "PROP.sub.-- ENCAPDATADIR" is a class property which indicates the default directory where DOS files are placed for the particular application which belongs to the class. A step 952 begins a loop in which each file in the default directory indicated by "PROP.sub.-- ENCAPDATADIR" is checked. In the first operation of the loop, performed in a step 953 and a step 954, the time/date stamp of a file within the default directory is checked. If the time date stamp of the file is later than the time/date stamp at which the application was opened the file is considered to be either new or modified. If the file is new or modified, in a step 955, the root of the file name is obtained (see FIG. 84B). All the files within the default directory which have the same file name as the file are considered part of the file's file set. In a step 956 it is determined, using file HPOMF.DOS whether the file is linked to an object. If not, in a step 957, a new object of the class of the current application is created and linked to the file set of the file. Also, in a step 958, a new entry is added to HPOMF.DOS for the file set (see FIG. 145). If the file is already linked to an object, in a step 959, it is determined whether the object is active. If the file is active, in a step 960, the object is sent a message indicating that the file has changed. Once the loop beginning at step 952 is complete, the class property "PROP.sub.-- EXPORTEDENCAP" for the current application is checked in a step 961. The property "PROP.sub.-- EXPORTEDENCAP", if it exists for the current application, contains a list of classes of encapsulated applications other than the current application. The purpose of listing these applications is so that the default directory where each of these encapsulated applications store DOS files may be checked. A step 962 begins a loop in which the default directory for each encapsulated application listed in "PROP.sub.-- EXPORTEDENCAP" is checked. In the first operation of the loop, performed in a step 963, the HPOMF.DOS file is accessed to obtain the identity of the default directory for each encapsulated application. It is included in the class property "PROP.sub.-- ENCAPDATADIR" for that encapsulated application. Once the class property "PROP.sub.-- ENCAPDATADIR" has been obtained for a particular encapsulated application, another loop is entered beginning at a step 964. In this loop each file in the default directory specified by "PROP.sub.-- ENCAPDATADIR" for the particular encapsulated application is checked. In the first operation of the loop, performed in a step 965 and a step 966, the time/date stamp of a file within the default directory is checked. If the time date stamp of the file is later than the time/date stamp at which the application was opened the file is considered to be either new or modified. If the file is new or modified, in a step 967, the root of the file name is obtained (see FIG. 84B). All the files within the default directory which have the same file name as the file are considered part of the file's file set. In a step 968 it is determined, using file HPOMF.DOS whether the file is linked to an object. If not, in a step 969, a new object of the class of the current application is created and linked to the file set of the file. Also, in a step 970, a new entry is added to HPOMF.DOS for the file set (see FIG. 145). If the file is already linked to an object, in a step 971, it is determined whether the object is active. If the file is active, in a step 972, the object is sent a message indicating that the file has changed. Once the loop beginning at step 962 is complete, the class property "PROP.sub.-- EXPORTEDNW" is checked in a step 974. The property "PROP.sub.-- EXPORTEDNW", if it exists for the current application, contains a list of classes of true NewWave applications which are able to convert file generated by the current application into file usable by the NewWave application. A step 977 begins a loop in which a conversion directory of each NewWave application listed in "PROP.sub.-- EXPORTEDNW" is checked. In the first operation of the loop, performed in a step 977, the HPOMF.DOS file is accessed to obtain the file list within the current conversion directory. Once the file list for a conversion directory has been obtained for a particular NewWave application, another loop is entered beginning at a step 978. In this loop each file in the conversion directory is checked. In the first operation of the loop, performed in a step 979 and a step 9980, the time/date stamp of a file within the conversion directory is checked. If the time date stamp of the file is later than the time/date stamp at which the application was opened the file is considered to be either new or modified. If the file is new or modified, in a step 981, a new object is created--of the class of the NewWave application--which references the file. In a step 982, encapsulation shell 845 activates the newly created object and sends the object a "Convert" message with the name of the file. In a step 983, encapsulation shell 845 checks to see whether the conversion was successful. If the conversion was not successful, in a step 984, encapsulation shell displays a warning message to the user with a reminder that the unconverted file still exists in the conversion directory. If the conversion was successful, in a step 985, encapsulation shell 845 deletes the file from the conversion directory. Once all the conversions are complete, encapsulation shell 845 is closed in a step 975. The following discussion indicate how the above-described closing of an application appears to a user. A copy of a file may be created within an application. In FIG. 123 object "SAMPLE" has been opened and the application "Write" is running, displaying data from file "C:.backslash.HPNWDOS.backslash.MSWRITE.backslash.SAMPLE.WRI" in window 1103. Cursor 781 is used to select the command "Save As" from pull down menu 1105. In FIG. 124 a file name within the default directory is typed into region 1120 of dialog box 1121. After selecting the region labelled "OK" using cursor 781 a new file is made. This file however does not have an associated object because OMF 100 has not monitored the creation of the new file. Therefore, in FIG. 125, no new object has appeared. After using cursor 781 to select the command "Exit" from pull down menu 1105, window 1103 is shut. As described above, upon termination, encapsulation shell 845 searches the default referenced file area for the encapsulated application--in this case subdirectory 861--and compares a timestamp of each file with the recorded start time of the encapsulated application. If a new file is located and that file is not already referenced by an object encapsulation shell 845 automatically creates a new object of the same class as encapsulation shell 845. In this case object "NEWDOC" is found, an object is created, and a icon bearing the name "NEWDOC" appears on "NewWave Office" as shown in FIG. 126 and pointed to by cursor 781. In FIG. 127, object "SAMPLE" has been opened in window 1103. In saving the file, a box 1122 in window 1121 has been checked. This causes the file to be saved in MS Word format. As seen in region 1120, the file is saved in directory "C:.backslash.HPNWDOS.backslash.MSWORD" rather than "C:.backslash.HPNWDOS.backslash.MSWRITE". As discussed above, if specified by configuration properties 847, at termination time other subdirectories within subdirectory 852 which represent other encapsulated classes may be searched for files which have a timestamp later than the recorded start time of the encapsulated application. Encapsulation shell 845 may then create objects of the appropriate class for these files. The objects which represent the new files have associated with them new icons when the application is closed. In the present case directories "C:.backslash.HPNWDOS.backslash.MSWORD" (subdirectory 860) and "C:.backslash.HPNWDOS.backslash.MSWRITE" (subdirectory 861) are searched and a new copy of SAMPLE in directory "C:.backslash.HPNWDOS.backslash.MSWORD" is found. A new object of the class for "MSWORD" is created and an icon named "SAMPLE" is displayed in the window for "NewWave Office" as shown in FIG. 128 and pointed to by cursor 781. The shape of the icon indicates that the new object "SAMPLE" is associated with the object class for "MS Word" rather than for "MS Write". In FIG. 129 the command "Create a New" in pull down menu 782 is selected using cursor 781. In FIG. 130 the name "DEMODOC1" is typed into region 1124 in window 1112, and the icon "AdvanceWrite" has been highlighted. The result, shown in FIG. 131, is the creation of an object "DEMODOC1" as pointed to by cursor 781. In FIG. 132, it is shown that "DEMODOC1" appears in directory "C:.backslash.HPNWDOS.backslash.ADVWRITE". Pointing to icon "DEMODOC1" with cursor 781 and clicking twice on a button of mouse 20, as shown in FIG. 133, results in the opening of "AdvanceWrite" in FIG. 133. In FIG. 134 the application "AdvanceWrite" is shown. Since "AdvanceWrite" is not a program which was written to function under the "Windows" environment, "AdvanceWrite" takes over the entire screen. In FIG. 135, using the keyboard, text has been added to the screen as shown in FIG. 134. In FIG. 136, pressing an "ALT" key on keyboard 19 activates the menu/macro facility. Shell filter 844 upon recognizing this keystroke displays a Title bar 1128 and menu bar 126 appearing. Cursor 781 is used to select the command "Convert to NewWave Document" in a pull-down menu 1124. Upon receipt of the selection, shell filter 844 transmits to the application "AdvanceWrite" the associated keystroke macro. This keystroke macro commands "AdvanceWrite" to save the current file in the format required for conversion within a special conversion subdirectory, and then commands "AdvanceWrite" to exit. Shell filter 8444 informs encapsulation shell 845 that the application "AdvanceWrite" is terminating. Dependent upon the configuration properties, encapsulation shell 845 searches the conversion subdirectory for any new files. Encapsulation shell 845 creates a conversion object which references a conversion application able to perform the conversion. The conversion application is identified in configuration properties 847. Once the conversion object is created, encapsulation shell 845 sends to the conversion object the identity of the file to be converted and a command to perform the conversion. The converted data file is then stored as part of a NewWave object and the intermediate conversion file in the conversion subdirectory is deleted. The result is a copy of "DEMODOC1" as shown in FIG. 137 and pointed to by cursor 781. The "DEMODOC1" is a NewWave Document, and thus may be treated as any other object on the system. Clicking on the title of the copy of "DEMODOC1" reveals that there is no directory listed. As shown in FIG. 139 the name of the object has been changed to "NW Demo Document" as pointed to by cursor 781. This name change may be done because the object is a NewWave Document. In FIG. 140 the name bar of object "NW Demo Document" has been closed. Examples of code which implements "Windowlike" commands which are added to programs which normally do not function in a "Windows" environment are given in Appendix G, which can be found in the application file. FIG. 141 is a flowchart which shows the process OMF 100 and encapsulation shell 845 go through when an object is opened in accordance with the preferred embodiment of the present invention. In a step 1140 a user attempts to open an object. In a step 1144, encapsulation shell 845 checks if the object is in DOS reference mode. If so the file is activated in a step 1142. If not in a dialog box 1146 appears to the user, who is asked to name a file. The user may, using cursor 781, cancel the transaction, and in a step 1148, encapsulation shell 845 returns without taking action. When the user selects a name, encapsulation shell 845, in step 1150 checks to see if the chosen name is a valid file name. If it is an invalid file name the user is informed using a dialog box 1152 and the user is asked to pick another file name by dialog box 1146. If the file name is valid, encapsulation shell 845 checks to see if a file specification exists for the file. If the file specification does not exist in a step 1158 encapsulation shell 845 determines whether the file specification can be created. If so, the file specification is created and encapsulation shell 845, in a step 1168, returns. If the file specification cannot be created, the user is so informed by a dialog box 1156 and the user is asked to pick another file name by dialog box 1146. If the file specification does exists, encapsulation shell 845, in a step 1154, determines whether the file name is registered to the same class. If so, the user is so informed by a dialog box 1164, and the user is asked to pick another file name by dialog box 1146. If there is no file of the same name registered to the same class, encapsulation shell 845, in a step 1162, determines whether the file name is registered to another class. If so, the user is so informed by a dialog box 1160 and the user is asked to pick another file name by dialog box 1146. If the file name is not registered to another class, encapsulation shell 845, in a step 1172, determines whether a keyfile exists for the file. If not the user is informed by a dialog box 1170 that the file specification is in use by other files and the user is asked to pick another file name by dialog box 1146. If the keyfile exists the user is informed by a dialog box 1174 that the file already exists and is asked to pick another file name by dialog box 1146. FIG. 142 shows the steps taken by encapsulation shell 845 when the file is activated in step 1142. In a step 880 the method by which the object for the file was opened is determined. If the normal method of opening the file is used--e.g., by placing cursor 781 over the icon for the file and double clicking a button on mouse 20--then a default set of class properties is obtained in a step 881. If an alternate method of opening the file is employed--e.g., by placing cursor 781 over the icon for the file, holding down the "SHIFT" key on keyboard 19 and pressing a button on mouse 20--then an alternate set of class properties is obtained in a step 882. In a step 883 encapsulation shell 845 obtains object properties for the file. In a step 884 encapsulation shell 845 prepares menus and macros which are are to be added to the application and which are to be monitored by shell filter 844. Shell filter has a different means of monitoring an application depending upon whether the application was written to operate in the "Windows" environment. Therefore, in a step 885, encapsulation shell 845 determines whether the opened application is a "Windows" application. If so, a list of active windows is obtained in a step 887. This is useful information to shell filter 844, which, when created, wants to intercept messages directed to a newly opened window for the present file. If the opened application is not a "Windows" application, preparation is made in a step 886 for shell filter 844 to intercept keystrokes. In a step 888, encapsulation shell 888 grays the icon for the file, indicating to a user that the file has been opened. In a step 889 the application for the file is started. In a step 890, encapsulation shell again branches depending upon whether the application for the file is a "Windows" application. If the application is a "Windows" application, shell filter 844 is set up, in a step 892, to intercept messages sent to the window containing the "Windows application. If the application is not a "Windows" application, shell filter 844 is set up, in a step 891, to intercept keystrokes a user makes on keyboard 19 and user actions on mouse 20. FIG. 143 is a flowchart which shows the process OMF 100 and encapsulation shell 845 goes through when an object is created in accordance with the preferred embodiment of the present invention. In a step 1180 a user attempts to create a new object. A user is asked by a dialog box to confirm if he wants to create a new file. If the user makes the conformation encapsulation shell 845 determines in a step 1184 whether the user has indicated a file name. If not the user is asked to pick a file name by a dialog box 1186. At dialog box 1186 a user may ask to cancel which will bring up dialog box 1182. Once a name has been selected encapsulation shell 845, in step 1188 checks to see if the chosen name is a valid file name. If it is an invalid file name the user is informed using a dialog box 1190 and the user is asked to pick another file name by dialog box 1186. If the file name is valid, encapsulation shell 845 checks to see if a file specification exists for the file. If the file specification does not exist in a step 1198 encapsulation shell 845 determines whether the file specification can be created. If so, the file specification is created and encapsulation shell 845, in a step 1202, returns. If the file specification cannot be created, the user is so informed by a dialog box 1200 and the user is asked to pick another file name by dialog box 1186. If the file specification does exists, encapsulation shell 845, in a step 1194, determines whether the file name is registered to the same class. If so, the user is so informed by a dialog box 1196 and the user is asked by a dialog box 1196 whether he wants to create a share of the existing file. If so a share is created in a step 1216. If not, the user is asked to pick another file name by dialog box 1186. If there is no file of the same name registered to the same class, encapsulation shell 845, in a step 1206, determines whether the file name is registered to another class. If so, the user is so informed by a dialog box 1204 and the user is asked to pick another file name by dialog box 1204. If the file name is not registered to another class, encapsulation shell 845, in a step 1208, determines whether a keyfile exists for the existing file. If not the user is informed by a dialog box 1210 that the keyfile is missing but other files are present and the user is asked to pick another file name by dialog box 1186. If the keyfile exists the user is informed by a dialog box 1218 that the file already exists and the user is asked to confirm that these existing files are to be registers. If the user confirms, the object and reference files are created in a step 1214. Otherwise, the user is asked to pick another file name by dialog box 1186. When OMF 100 sends an open message to an object, the open message includes a alternate class parameter specifying whether or not the Shift key was depressed by the user when the user generated an open command to OMF 100, that is, a special parameter is sent when a user places cursor 781 over an object to be opened holds down the key marked "shift" on keyboard 19 while twice clicking a button on mouse 20. Encapsulation shell 845 may be configured, through parameters stored in configuration properties 847, to open an alternate application other than encapsulated application 846--in this case encapsulated application 846 is the default application--when encapsulation shell 845 receives from OMF 100 an alternate class parameter. The above described use of a default class and an alternate class upon opening an object may be used to allow a user to specify the opening of two completely different application programs that both can process the same data file type. Alternatively, the use of a default class and an alternate class may be used to request encapsulation shell to open the same encapsulated application, but to open it with different parameters which direct how the data file is to be used. For example, a user may thus be able to specify whether he wants to edit or browse a file. Similarly, a user may thus be able to specify whether he wants to edit or compile a computer program stored in a data file. In FIG. 14 is shown the different record types within the file HPOMF.DOS. A header record 990 contains a version number and other identification information. There is only one header record in HPOMF.DOS. It is 256 bytes long. A directory record 991 identifies a directory that contains encapsulated data files. There is one directory record for each MS-DOS directory that contains encapsulated data files. The first directory record follows immediately after header record 990. Directory record 991 contains three fields. A field 993 (IprecNextDIr) contains a 32-bit pointer (the offset from the beginning of the file, in bytes) of the next directory record in HPOMF.DOS. This field is set to zero in the last Directory Record. A field 994 (IprecFile) is a 32 bit pointer (the offset from the beginning of the file, in bytes) of the first File Record for the directory. A field 995 (szDirectory) contains a null-terminated string which is the directory name, including the drive specification. A file record 992 identifies an encapsulated data file. There is one File Record for each encapsulated data file. Each Directory Record points to the first File Record within that directory. File Record 992 contains 5 fields. A field 996 (IprecNextFile) is a 32-bit pointer (the offset from the beginning of the file, in bytes) of the next File Record for this directory. If this is the last file in the directory, field 996 is zero. A field 997 (bDeleted) is a 16-bit Boolean value that indicates whether the file has subsequently been deleted. Field 997 is initially set to false when the File Record is created. When the file is deleted, the File Record is left in place (for performance reasons) and field 997 is set to "True" to indicate the entry is no longer valid. A File Record with field 997 set to "True" can be reused for another file. A field 998 (szFileName) contains a null-terminated string which is the root file name (see FIG. 84B) of the encapsulated data file set. A field 999 (dwObject) is a 32-bit value specifying the NewWave object identifier (parameter-scope name) of the object associated with this encapsulated file. A field 1000 (Flag) is an 8-bit field containing other status information associated with this encapsulated data file. FIG. 145 shows the logical structure of file HPOMF.DOS. Header record 991 is followed by directory record 991. Directory record 991, in field "IprecNextDir", contains a pointer to a directory record 1006. Directory record, in field "IprecNextDir", contains a pointer to directory record 1009. And so on. Directory record 991 also contains, in field "IprecFile", a pointer to file record 992. File record 992 contains, in field "IprecNextFile" a pointer to file record 1004. File record 1004 contains, in field "IprecNextFile" a pointer to file record 1005. Similarly, directory record 1006 also contains, in field "IprecFile", a pointer to file record 1007. File record 1007 contains, in field "IprecNextFile" a pointer to file record 1008. The following Appendices can be found in the application file. Appendix A is a list of major data structures within OMF 100. Appendix B is a description of functions which OMF interface 599 recognizes in the preferred embodiment of the present invention. Appendix C (HP NewWave Environment: Program Design Examples) Gives examples of how the preferred embodiment of the present invention may be implemented including detail as to how OMF 100 allows data to be viewed between windows displayed on monitor 14. Appendix D (Programmer's Guide) gives a further overview of the preferred embodiment of the present invention. Appendix E is a listing of a program which provides for generic encapsulation of programs. Appendix F, gives examples of files which need to be created for encapsulation of a program into the NewWave Environment. Appendix G gives examples of code which implement "Windowlike" commands which are added to programs which normally do not function in a "Windows" environment.
|
||||||||||
