CA2465098C - Enhancing resource adapters to facilitate communication in a distributed computer network - Google Patents

Abstract

The present invention is directed generally to client-server, client-host, or server-server communications in a distributed computer network and, more particularly, to enhancing of resource adapters adapted to facilitate such communications. The present invention is directed to enhancing resource adapters that work with screens. Aspects of the invention, which may be incorporated into or communicate with existing resource adapters, provide a standard screen record for manipulating data on a screen image. The standard screen record provides support for instances where prior knowledge of the screen format or layout is known and for those instances where there is no knowledge of the screen format. Additionally, the standard screen record provides detailed data describing all attributes of a field and of the screen image itself. Additionally, the invention also provides easy access to the field attribute data. In some embodiments, aspects of the invention may include interfaces which enable tooling to be developed which can then be used to develop applications which utilize the functionality of the other aspects of the invention. This interface could provide a common way for tooling to support resource adapters that implemented the interface.

Description

ENHANCING RESOURCE ADAPTERS TO FACILITATE COMMUNICATION IN A DISTRIBUTED
COMPUTER NETWORK

FIELD OF THE INVENTION

The invention relates generally to client-server, client-host, or server-server communications in a distributed computer network and, more particularly, to enhancing of resource adapters adapted to facilitate such communications.

BACKGROUND OF THE INVENTION

There exists many legacy server application that have provided and continue to provide valuable information processing servers to organizations worldwide. Many of these legacy server applications, which are the result of many years of development, contain, store or access many years (and sometimes decades) worth of data. These legacy applications are now being forced to become part of distributed applications (that is, applications which use the services and facilities of many servers and clients). For example, in a typical electronic transaction being performed on a client system (e.g., a personal computer, personal digital assist, etc.) an individual may, unknowingly, initate a transaction that involves: an application server (which typically provides the data or business logic processing necessary to deliver up-to-date information; additionally and typically an application server sits along with or between the user and the databases and legacy applications and provides the middleware glue to enable a browser-based application to link to multiple sources of information; with JavaTM-based application servers the processing is performed by Java servlets, JavaServer Page and Enterprise JavaBeans) and other back end systems such as databases or legacy applications. (Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc., in the United States, other countries, or both).

Many legacy systems deliver to clients a text-based screen which provides a client/user with information and allows a user to input data, modify data or submit a transaction for processing. For example, legacy applications deliver data which was originally designed to be displayed by an IBM 3270 terminal. In the example of the 3270 applications, a screen includes fields where data can be presented to a user or data entered into the field by the user. For example, a screen may contain two fields, one which is a prompt with the text "Name:", and the second field which contains a person's name or allows a person's name to be entered by a user. Each field besides containing text has attributes, which indicate the text color, background color (which may be associated with many color related attributes such as the color of text, the background color of text, etc.), whether the field is protected, whether the text has been modified, etc..

Two exemplary legacy applications that communicate with client systems are Customer Information Control System (CICS) 3270 applications (where CICS provides terminal routing, password security, transaction logging for error recovery and activity journals for performance analysis amongst other features) and Host 3270 applications.

Present client systems often employ a 3270 terminal emulation product (and the protocols) to render the data transmitted by the legacy application. The terminal emulation product allows a user to view 3270 screens on a personal computer, instead of using a 3270 terminal.

Alternatively, for these two exemplary legacy applications, a Java", 2, Enterprise Edition (J2EE) Connector Architecture resource adapter (also sometimes referred to as a connector) can be hosted by an application server. The Host on Demand (HOD) and CICS Transaction Gateway products from IBM provide such resource adapters. These resource adapters receive a data stream from a legacy 3270 application and they each provide a product specific programming interface that allows an application to work with the fields of a screen. With today's more powerful graphical user interfaces, the application can display the data in a more meaningful way, such as combining the contents of several screens into a single Web Browser page.

The 3270 data stream is a highly optimized stream which describes a screen image. A resource adapter is at liberty to deliver the screen information in any format it desires. Current resource adapters (CICS and HOD, for example) send a stream which represent each-byte on a X by Y
screen, modifying invisible screen bytes with extra information about the bytes that make up a field (i.e., foreground color, background color).
This mechanism is highly inefficient, compared to a 3270 data stream, when providing full information about a screen image since it requires sending multiple X by Y streams with changes to the invisible bytes to obtain all the possible attribute information.

These resource adapters have other significant shortcomings. For example, these resource adapters currently require the data for the entire screen to be sent, where it could be optimized to only send the data of modified fields. Additionally, when developing applications to interact with the data stream provided by a resource adapter, prior knowledge of the screen image is necessary so that use of the fields and their location on the screen can be made. Unfortunately, having this prior knowledge of the screen image is not always available.

Further, specific tooling must be created to develop applications that use the facilities offered by a connector or resource adapter. As such, given the examples above, different tooling would have to be created for each of the J2EE resource adapters described above. This is inefficient.

Accordingly, providing an interface that resource adapters can implement to overcome, at least in part, some or all of the shortcomings described above would be desirable.

SUMMARY OF THE INVENTION

The present invention is directed generally to client-server, client-host, or server-server communications in a distributed computer network and, more particularly, to enhancing of resource adapters adapted to facilitate such communications. The present invention is directed to enhancing resource adapters that work with screens.

Aspects of the invention, which may be incorporated into or communicate with existing resource adapters, provide a standard screen record for manipulating data related to a screen image. The standard screen record provides support for instances where prior knowledge of the screen format or layout is known and for those instances where there is no knowledge of the screen format. Additionally, the standard screen record provides detailed data describing all attributes of a field and of the screen image itself.
Additionally, the invention also provides easy access to the field attribute data.

In some embodiments, aspects of the invention may include interfaces which enable tooling to be developed which can then be used to develop applications which utilize the functionality of the other aspects of the invention. This interface could provide a common way for tooling to support resource adapters that implemented the interface.

In one embodiment of the invention, for use in an object oriented environment, a screen is represented by a collection of objects - a screen object containing field objects. Additionally, a screenable interface describes a highly efficient way of presenting a screen image and a screen record is used to present the screen image to a client application.

In accordance with an aspect of the present invention, there is provided a method for providing data describing a field of a screen image to a first application. The method comprises the steps of receiving said data describing said field from a second application, populating a data structure within a class with said data describing said field, said class including a function for accessing said data describing said field, and making the class available to said first application. In one embodiment, said received data further comprises attribute data, said attribute data describing an attribute associated with said field, and said method further comprises populating said data structure with said attribute data, said class further including a function for accessing attribute data within said class. Preferably, said attribute data within said data structure identifies whether said data describing said field has been modified. The method may further comprise using said function for accessing said data describing said field to modify said data describing said field, and may still further comprise using said function for accessing attribute data within said data structure to indicate said data describing said field has been modified and/or transmitting to said second application a data stream from said data structure storing said modified data. The first application may be a client application and the second application may be a legacy application.

A data processing system to carry out the above method, and one or more computer-readable media containing data and instructions which, when executed, adapt a computer to carry out the above method, are also provided.

Other aspects and features of the present invention will become apparent to those ordinarily skilled in the art upon review of the following description of specific embodiments of the invention in conjunction with the accompanying figures.

BRIEF DESCRIPTION OF THE DRAWINGS

In the figures which illustrate an example embodiment of this invention:
FIG. 1 schematically illustrates a computer system embodying aspects of the invention;

FIG. 2 schematically illustrates, in greater detail, a portion of the computer system of FIG. 1;

FIG. 3 illustrates, in functional block form, a portion of FIG. 1; and FIG. 4 illustrates, in greater detail and in functional block form, portions of FIG. 3 DETAILED DESCRIPTION

An embodiment of the invention, computer system 100, is illustrated in FIG.l. Computer network 100, illustrated for exemplary purposes as including a general purpose, networked computing device 102, is in communication with other networked computing devices, such as host 110 via network 108. As will be appreciated by those of ordinary skill in the art, network 108 may be embodied using conventional networking technologies and may include one or more of the following: local area networks, wide area networks, intranets, public Internet and the like. Furthermore, network 108 may physically be embodied in any type of network be it electrical, optical, wireless or various hybrid combinations. Further, although computing device 102 is illustrated as a conventional desktop computer, other networked computing devices could be additionally and alternatively employed. Such networked computing devices may include a tablet portable computer, notebook computer, personal digital assistant or the like. Accordingly and hereinafter, computing device 102 will be referenced as client 102.

In the exemplary embodiments client 102 and host 110 each includes processing system 102 which communicates with various input devices 104, output devices 106 and network 108. Input devices 104, two of which are shown, may include, for example, a keyboard, a mouse, a scanner, an imaging system (e.g., a camera, etc.) or the like. Similarly, output devices 106 (only one of which is illustrated) may include displays, information display unit printers and the like. Additionally, combination input/output (I/O) devices may also be in communication with processing system 102. Examples of conventional I/O
devices include removable and fixed recordable media (e.g., floppy disk drives, tape drives, CD-ROM drives, DVD-RW drives, etc.), touch screen displays and the like.

An example of client 102 and host 110 is illustrated in greater detail in FIG. 2. As illustrated, client 102 or host 110 each include several components - central processing unit (CPU) 202, memory 204, network interface (I/F) 208 and I/O I/F 210. Each component is in communication with the other components via a suitable communications bus 206 as required.

CPU 202 is a processing unit, such as an IntelTM Pentiuiffm, IBM PowerPCTM, Sun Microsystems UltraSparcT processor or the like, suitable for the operations described herein. As will be appreciated by those of ordinary skill in the art, other embodiments of processing system 102 could use alternative CPUs and may include embodiments in which one or more CPUs are employed. (Intel and Pentium are trademarks of Intel Corporation in the United States or other countries). CPU 202 may include various support circuits to enable communication between itself and the other components of client 102 or host 110, respectively.

Memory 204 includes both volatile (214) and persistent (216) memory for the storage of: operational instructions for execution by CPU 202, data registers, application storage and the like. Memory 204 preferably includes a combination of random access memory (RAM), read only memory (ROM) and persistent memory such as that provided by a hard disk drive.

Network I/F 208 enables communication between client 102 (or host 110) and other network computing devices (not shown) via network 108. Network I/F
208 may be embodied in one or more conventional communication devices.
Examples of a conventional communication device include an Ethernet card, a token ring card, a modem or the like. Network I/F 208 may also enable the retrieval or transmission of instructions for execution by CPU 202 from or to a remote storage media or device via network 108.

I/O I/F 210 enables communication between processing system 102 and the various I/O devices 104, 106. I/O I/F 210 may include, for example, a video card for interfacing with an external display such as output device 106.
Additionally, I/O I/F 210 may enable communication between processing system 102 and a removable media 212. Although removable media 212 is illustrated as a conventional diskette other removable memory devices such as Zip- drives, flash cards, CD-ROMs, static memory devices and the like may also be employed.
Persistent memory 216 may be used to provide instructions for execution by CPU
202 or as a removable data storage device.

The computer instructions/applications stored in memory 204 and executed by CPU 202 (thus adapting the operation of computer system 100 as described herein) are illustrated in functional block form in FIG. 3. As will be appreciated by those of ordinary skill in the art, the delineation between aspects of the applications illustrated as functional blocks in FIG. 3 is somewhat arbitrary as the various operations attributed to a particular application as described herein may, in alternative embodiments, be subsumed by another application.

Included in memory 202 client 102 and host 110 but not illustrated are operating system (OS) and a communications suite.

The OS is suitable for operation with a selected CPU 202 and the operations described herein. Multitasking, multithreaded OSes such as, for example, IBM AIXTm, Microsoft Windows NTrm, Linux or the like, are expected in many embodiments to be preferred. (Microsoft, Windows and Windows NT are trademarks of Microsoft Corporation in the United States, other countries or both. Linux is a registered trademark of Linus Torvald in the United States, other countries, or both).

A communication suite provides, through, interaction with OS and network I/F 208 (FIG. 2), suitable communication protocols to enable communication with other networked computing devices via network 108 (FIG. 1). The communications suite may include one or more of such protocols such as TCP/IP, ethernet, token ring and the like.

In the exemplary embodiment illustrated in FIG. 3, a client 102 communicates with host 110 via a network connection 312 (which may be, for example network connection 108 shown in Figure 1). Client 102, a computing device, hosts an client application 302, a client side resource adapter 304 and screen record 306. Host system 110 hosts a legacy application 310 which communicates with client 102 via network 108.

Legacy application 310 does not require any modification nor adaptation to communicate with application 302 on client 102. Rather, the resource adapter 304, provides the necessary communications support to enable communication between legacy application 306 and client application 302. The screen record 306 provides a common way for an application to work with a screen, with rich function.

In the exemplary embodiment, resource adapter 304 is embodied in an JavaTN 2, Enterprise Edition (J2EE) connector which communicates and uses the screenable interface and implementing classes 306. A J2EE connector provides a programming interface (API) that acts an interface between a Java program (such as client application 302) and a legacy application such as legacy application 310. Thus, access to the legacy application can easily be provided within an Enterprise JavaBean (EJB). Although resource adapter 304 is, in the exemplary embodiment, a J2EE connector, alternative resource adapters (e.g., connectors conforming to the Common Connector Framework from IBM Corp. or others) could equally be employed.

As suggested above, client application 302 is, in the exemplary embodiment, an application written Java. However, other programming languages could equally be employed in alternative embodiments.

With the screen record 306 a resource adapter 304 can translate the data stream received from legacy application 310 (via network 312) hosted by host system 110 into a format that can be used and understood by client application 302. Similarly, data generated by client application 302 can be passed to the resource adapter through the screen record 306. Resource adapter 304 is then able to process the data received from the screen record 306 and forward it to legacy application 310 on host 110.

As illustrated in FIG. 4, screen record 306 provides two interfaces:
a screen record interface (for communication between screen record 306 and client application 302); and a screenable interface (for communication between resource adapter 304 and screen record 306). Additionally, FIG. 4 illustrates, in block functional form, the functions of screen record 306.
As illustrated, the exemplary embodiment provides functions which are broadly separated into a format handler 404 and a screen record handler 402.

Format handler 404 provides-format and translation.servi.ces for screen record 306. That is, data received from resource adapter 304 is processed by format handler 404. Similarly, data destined for resource adapter 304 is first processed by format handler 404 before the data is transmitted to its destination - client application 302 or resource adapter 304, respectively.

The following table lists the interfaces with a short description.
Interface Description IScreenable interface used by resource adapter 304 to supply and retrieve data from screen record 306 IScreenlnfo Used by an application to query screen attributes.
IFieldData Used by the resource adapter 304 to build a field.
IFieldAttrlnfo Used by an application to query the attributes and extended attributes of a field.
ITextAttrlnfo Used by an application to query the attributes of the text in a field.
IExtendedAttribu Defines constants for the extended attributes.
tes IFieldInfo Used by an application for retrieving field data such as name, text, or position.

(*) In an alternative embodiment, screen record 306 may also provide implementations of these interfaces. This alternative embodiment may be preferred in the instance where the screen record 306 employs pre-built fields and populates the fields with various bits of information.
Alternatively, screen record 306 may provide the information via a different mechanism for the creation of the field. ., IScreenable interface The IScreenable interface is implemented by screen record 306 and can be detected, and is used, by resource adapter '304. The IScreenable interface provides resource adapter 304 with the ability to pass information to application 302. In the pseudo-code below, the exemplary embodiment of the IScreenable interface includes several methods (described in greater detail below).

Generally, the IScreenable interface implemented by screen record 306 enables a 'resource adapter to create a screen record (an object of class ScreenRecord in the exemplary embodiment but, generically, could, be embodied within any type of data structure - not necessarily an object in an object oriented environment) which accurately describes the fields, the field attributes and the remaining non-field portions' of a screen and the `fields and data contained therein (e.g., informational text; screen color;
text type, color, size; etc.). Each screen record will be associated with a unique identifier (ID) so that the screen to which a screen record is associated can be properly identified. Through the methods (or, when not implementing the interface using Java, functions) provided by the IScreenable interface, the screen identifier can be set or retrieved.

Additionally, the IScreenable interface provides methods which, when invoked, enable a resource adapter 304 to retrieve data, from the fields defining the screen image. In the exemplary embodiment, the data about the fields can be retrieved for all the fields or for only the modified fields. Furthermore, the methods provided by the IScreenable interface in exemplary embodiment enable a resource adapter 304 to step through (i.e., move iteratively through) either all the fields or only the modified fields contained within a screen image.

As indicated above, resource adapter 304 the exemplary embodiment conforms to the J2EE Connector architecture. Consequently, the pseudo-code below, which forms part of the screen record handler 402 of screen record 306 is implemented in the Java language. Alternative languages in alternative embodiments of the invention could equally be employed.
* Screen interface used by a resource adapter.

public interface IScreenable {
/**
* Indicates the start of the field build process, providing information * about the Screen itself. The fullRefresh Boolean indicates that the * resource adapter will provide all the information about the screen so * a record should clear out appropriate information as it will be fully * refreshed void beginBuild(IScreenlnfo Scrlnf, boolean fullRefresh);
* Adds a field to the screen record.

void buildField(IFieldData fieldData, IFieldAttrInfo fieldAttrs,ITextAttrlnfo textAttrs) throws ScreenException;
/**
* Indicates the end of the field build process.
void endBu ldO;

* Returns the screen record ID.
String getScreenld.();
I**
* Set the screen ID.

public void setScreenld(String ScreenId);

* Returns an iterator for the fields contained in the screen record.
java.util.Iterator getFields();

* Returns an iterator for the modified fields in the screen record.
java.util.Iterator getModifiedFieldsC);
}

As indicated by the pseudo-code above, the IScreenable interface includes several methods: beginBuild; buildField; endBuild, setScreenld;
getFields; and getModifiedFields. These methods are described individually below. Additionally, those methods provided by the IScreenable interface are invoked using objects defined by the IScreenlnfo, IFieldData, IFieldAttrInfo, ITextAttrlnfo classes. These classes are also described in greater detail below.

beginBuild This method indicates to screen record 306 that the passing of field information is about to begin. Resource adapter 304 passes to screen record 306 an IScreenlnfo object which provides information about the screen as a whole (which is described in greater detail below in the Screenlnfo Interface section). The beginBuild method has a flag (boolean fullRefresh) which indicates to the screen record 306 whether resource adapter 304 is going to provide a full refresh of the screen or only a subset of fields which have been changed. The setting of this flag, and which information to provide to screen record 306 (the entire screen or a subset thereof), is determined by resource adapter 304. Such a determination will be made based on whether the screen record (the unit of data that is passed between resource adapter 304 and screen record 306 -in the exemplary embodiment the screen record is an object of type ScreenRecord - see Appendix B for pseudo-code implementing the ScreenRecord object class) has been defined to contain all of the data fields defined by the screen (thus enabling support of the transfer of a subset of the record data). If the record has been created which contains all of the data fields present in the screen image, then the record has been sufficiently defined to support an update only. A resource adapter only calls buildField for fields which already exist in the record - new fields are not added. That is, when there is no existing ScreenRecord then a resource adapter can create a ScreenRecord, and build (add) all the fields necessary. If a FullRefresh is not selected, then a ScreenRecord must already be populated. Only the fields that exist can be changed, and new ones should not be added by the Resource Adapter. In the case where a tool has pre-built the ScreenRecord and customized it with accessors and meaningful names, then the resource adapter should not overwrite those fields. This can be done by the generated ScreenRecord overriding the behaviour of the beginBuild and buildField methods.

buildField The buildField method is used to create a field or populate an existing field in a screen record. When a field is created it is assigned an index number. The index number in the exemplary embodiment starts at 1 and is incremented for each invocation of buildField. Resource adapter 304, in the exemplary embodiment, delivers fields in a screen image in sequential order: from left to right, and top to bottom. (Other orders or forms could alternatively be employed.) As indicated in the pseudo--code above, buildField can throw a ScreenException and may be passed up to three parameters: IFieldData; IFieldAttrlnfo; and ITextAttrln.fo. Each of these three possible parameters are described below. Additionally, pseudo-code is provided in Appendix A for the classes which are instantiated for each of these three possible parameters.

endBuild This method indicates that the build process has ended. It indicates that no more fields are to be created or populated. No parameters are passed to the endBuild method.

getScreenld and setScreenld The setScreenld and getScreenld methods provide the ability to access (i.e., write or read, respectively) with a unique identifier or retrieve that unique identifier, respectively. The Screenld tagging allows a resource adapter 304 to tag a ScreenRecord supplied to receive output.
If that ScreenRecord is then used for input, the resource adapter 304 can look at the tag (Screenld) to determine if it was the last one used for output. If so, then as a performance optimization, a resource adapter 304 can skip validation of the input record that would otherwise confirm that the input record matched the data presented by a screen.

getFields This method, which enables access (in this case, the ability to read) to the fields stored within the screen record, returns an iterator of all the fields within the record. The getFields method relies on the screen record (which in the exemplary embodiment is implemented by instances of the ScreenRecord class which in turn relies on the Fieldlnfo interface.

getModifiedFields -This method, when invoked, also enables access to the fields stored within the screen record, returns an iterator of all fields that have been flagged as modified by the screen record handler 402. A field is flagged as modified when the value of the modified attribute is true. This will occur when the FieldRecord.setText(String) method is invoked.

As noted above, the IScreenable interface, and more particularly the beginBuild method, uses three parameters conforming to the classes:
IFieldData; IFieldAttrlnfo; and ITextAttrlnfo. These three classes are described below.

IFieldData In the exemplary embodiment, an object instantiated from the IFieldData class is required. The IFieldData class provides the basic information about a field and its contents. Pseudo-code describing an implementation of this class is found in Appendix A. For example, in the exemplary implementation, the IFieldData class provides a method, getPos, which returns an absolute position so that the row and column location of a field in the screen image can be calculated.

IFieldAttrlnfo This class (which in the exemplary implementation is optional) provides information about attributes for a particular field. For example, the pseudo-code found in Appendix A describing one exemplary implementation of this class provides information such as background color, foreground color, character set, highlight attributes and the like.

If a null value is passed to the buildField method (described above), the screen record 306 assumes that the field has no attributes. As a consequence, the screen record 306 may provide default values as required if field attribute properties are to be exposed.

ITextAttrlnfo In the exemplary embodiment, use of this class is optional. The ITextAttrlnfo class provides information about attributes for individual characters of text. The pseudo-code for an-exemplary ITextAttrlnfo class found in Appendix A illustrates that the exemplary embodiment provides information on text colors and other extended attributes. As will be appreciated other text attributes (e.g., font size, font characteristics -italics, bolding, underlining, etc.) could be provided in alternative embodiments.

if a null is passed to the buildField method of the IScreenable interface, the screen record 306 assumes that no individual attributes are available. Consequently, screen record 306 provides any default values that may be required if the text attribute properties are to be exposed.

IScreenlnfo Interface This interface represents information about the screen image. The Screenlnfo interface is implemented by resource adapter 304 to pass information to the screen record 306. Pseudo-code implementing an exemplary embodiment of the Screenlnfo interface is included in Appendix A.

In the exemplary embodiment, general data about the screen image is described by the Screenlnfo interface. This general data include general visual characteristics such as, for example, default colors and character set and the like. Additionally, the Screenlnfo interface provides data describing the number of rows (returned by invoking the getDepth method), the number of columns (returned by invoking the get Width method) and the number of fields in the screen image (returned by invoking the getFieldCount) .

As will be appreciated by those of ordinary skill in the art, the Screenlnfo interface (amongst other aspects of the present invention) enables applications to be developed without a detailed knowledge of the screen image that is provided by legacy application 310 (FIG. 3). Using the Screenlnfo interface significant or important details about the screen image can be determined by a client application 302 during execution. For example, a client application 302 can, during execution, use the Screenlnfo interface to determine the size of a screen image (row x columns) and the number of fields contained therein. When coupled with the getFields method described above, additional detail about each field can be ascertained. These features provide a very powerful combination that produces numerous benefits to an application developer.

IFieldlnfo As indicated above, the Fieldlnfo interface is relied upon by the getFields method which forms part of the IScreenable interface described above. The Fieldlnfo interface represents the information that a resource adapter 304 may use to determine which field to update in its internal representation of the screen image. Objects returned by the getFields or getModifiedFields methods defined in the IScreenable interface, implemented by records implement this interface.

A pseudo-code exemplary of an implementation of the IFieldlnfo interface is found in Appendix A. In the exemplary implementation, the IFieldinfo provides methods which, when invoked, provided data describing the name of a field, the starting row and column of field, and the text contained within that field (e.g., the address of a person for Field named "ADDRESS").

IExtendedAttributes The IExtendedAttributes interface contains a collection of constants that define extended attribute values such as color, highlight and transparency. A field record can implement this interface to add the constants to its interfaces or classes.

IFieldRecord The FieldRecord Interface contains methods used to access fields and screen characteristics and is implemented by a similarly named class. The FieldRecord class, shown in pseudo-code in Appendix C.

ScreenRecord This class implements the ExtendedAttributes, Screenable and ScreenRecord interfaces. The screen record (implemented by the objects instantiated from the ScreenRecord class - shown in pseudo-code in Appendix B) provides the basic record that is passed between client application 302 and format handler 306 (FIGS. 3 and 4).

in addition to the resource adapter interfaces, there are some interfaces implemented in the exemplary embodiment that enable tooling to be developed. The following table lists the interfaces used by tooling and a short description.

Interface Information IFieldRecord used by application programmer to access a field's text, attributes, and extended attributes.
IScreenRecord Used by application programmer to access fields and screen characteristics.

Class Information FieldRecord A resource adapter can use this to add a field to a ScreenRecord. It can be used in generic Screen programming by an application programmer.
ScreenRecord A resource adapter can use this to work with a Screen. It can be used in generic Screen programming by an application programmer.
IScreenRecord Interface The IScreenRecord interface contains methods used to access fields and screen characteristics and is shown below.

public interface IScreenRecord {
IFieldRecord getField(int index) throws ScreenException;
IFieldRecord getField(String name) throws ScreenException;
int getFieldCount();
java.util.Iterator getFields();
int getScreenDepth();
int getScreenWidth();
}

As a result of the screen record and its related interfaces described above, a client application 302 can be developed without any prior knowledge of the screen image that is generated and transmitted by legacy application 310. This development without prior knowledge is enabled by the screen record 306 which enables an application to query a screen record for the fields (and related attributes) contained within a screen image. Advantageously, a client application can determine which of those fields have been modified thus improving the responsiveness of a client application 302. -In operation, conventional data from legacy application 310 (FIG. 3) describing a screen image will be transmitted over a network by a resource adapter 304. Using the interfaces described above and, in particular, the screenable interface, resource adapter 304 will cause a screen record 306 (in the exemplary embodiment, an instance of the ScreenRecord class) to be created (assuming such a screen record has not yet been created). The data structures of screen record 306 is then populated with data received by resource adapter 304 from legacy application 310. in the instance where the screen record was previously created by resource adapter 304 (by instantiating an object of class ScreenRecord in the exemplary embodiment), a new screen record 306 would not be created. Rather, the various data structures (e.g., fields, field or text attributes, etc.) in the existing screen record 306 are modified as necessary. However, where a tool has pre-built a screen record 306 and customized it with accessors and meaningful names, then resource adapter 304 would not overwrite those fields.

Client application 302 is then passed or accesses the created and populated screen record 306 to access or modify the data therein as required. The modified screen record 306 is then passed back to resource adapter 304. Resource adapter 304 then accesses the data necessary to generate a data stream (to be transmitted over network 312) from the data contained in screen record 306. This generated data stream, which is in a format understandable by legacy application 310, is then transmitted over network 312 to legacy application 310.

As will be appreciated by those skilled in the art, modifications to the above-described embodiment can be made without departing from the essence of the invention. For example, in place of many variables each individually associated with one of the many text attributes, a bit field could be used in alternative embodiments where each bit would represent a particular attribute. For example, a first bit, when "on" (i.e., set to "1") could indicate that the field is highlighted. Setting or changing to this bit to "off" (i.e., set to "0') would indicate the same field is not highlighted.

In a further alternative, the procedure for accessing the fields in the IScreenable interface could be modified. in the exemplary embodiment, the getFields method enables iteration through the various fields. Other procedures could be alternatively employed. For example, the fields could be accessed by an index. Alternatively, the fields could be accessed by the name of the field. in a further alternative, getFields would enable a field to be accessed by reference to a particular object (each field being represented by an object). in a still further alternative, the fields could be accessed by enumeration. Other possible access procedures could equally or alternatively be employed.

In a further alternative, a single interface between resource adapter 304 and client application 302 (the single interface defined by an embodiment of the present invention) could be employed as a replacement to the IScreenable interface and the screen record interface. In this embodiment, the interface would provide a signal to the client application that field information (describing the screen and any related data) is about to commence. Thereafter, data describing the various fields in the screen would be delivered. When data is delivered to the single interface, the resource adapter would be able to query all or some of the fields received and, additionally, ascertain whether any processing is required for a particular field (e.g., processing may be required if a field has been modified).

As will be appreciated by those of ordinary skill in the art, the various classes and interfaces described in the exemplary embodiment of the present invention may be modified while falling within the scope of the claimed invention. For example, it may be desirable to merge certain interfaces/classes together or, alternatively, break up the different methods and variables of one or more interfaces/classes into more than one interface/class having a scope of operation which differs from those described above. For example, it is contemplated that, in an alternative embodiment, the IFieldAttrlnfo and IExtendedAttributes interfaces could be merged. Similarly, the IFieldlnfo and the IFieldData:interfaces could also be merged in the same or a different embodiment. Other interfaces, in alternative embodiments, could be similarly merged or, alternatively, split apart into more than one interface.

While one (or more) embodiment(s) of this invention has been illustrated in the accompanying drawings and described above, it will be evident to those skilled in the art that changes and modifications may be made therein without departing from the essence of this invention. All such modifications or variations are believed to be within the sphere and scope of the invention as defined by the claims appended hereto. Other modifications will be apparent to those skilled in the art and, therefore, the invention is defined in the claims.

Appendix A

IScreenlnfo /**
* <p>
* This interface defines the screen information interface. This will allow * a user to query the characteristics of the screen.

public interface IScreenlnfo extends Cloneable, java.io.Serializable {
* Returns the default background color for the screen.

public int getDefaultBackgroundColor();

* Returns the default character set for the screen.
public int getDefaultCharSet O ;

/**
* Returns the default foreground color of the screen.
public int getDefaultForegroundColor O ;

/**
* Returns the depth or number of rows in the screen.
public int getDepth O ;

* Returns the number of fields on the screen.
public int getFieldCount O ;

/**

* Returns the width or number of columns in the screen.

public int getwidth O ;

* Returns whether a screen supports extended highlighting public boolean supportsHighlighting 0 ;
}

IFieldData /**
* <p>
* This interface defines the field data interface used by the resource * adapter. When the resource adapter builds a field, this interface is * used to supply the name, size, position, and text of the field.

public interface IFieldData extends Cloneable, java.io.Serializable {

* Returns the maximum length of the field, including any attribute bytes public int getMaxLength O ;

* Returns Field Name if one exists, null or I'll otherwise public String getName O ;

/**
* Returns the position of the field on the screen.
public int getPos();

* Returns the text of the field. Can never'be null public String getText O ;
}

IFieldAttrlnfo /**
* <p>
* This interface defines the field attribute interface. This will allow * a user to query the attributes and extended attributes of a field.
public interface IFieldAttrlnfo extends Cloneable, java.io.Serializable {

* Creates a new object of the same class as this object. It then initializes * each of the new object's fields by assigning it the same value as * the corresponding field in this object. No constructor is called.
* @return A new object initialized to the same state as this object.
public object clone() throws CloneNotSupportedException;

/**
* This method determines if the two FieldAttrlnfo types are equivalent.
* Returns TRUE if this FieldAttrlnfo type is the same as the obj argument;
* Returns FALSE otherwise.
* @param obj The reference object with which to compare.
public boolean equals(Object other);

/**
* Returns extended background attribute property public int getBackGroundCol.or();

/**
* Returns Character set extended Attribute public int getCharacterSet();

/**
* Returns extended foreground attribute property public int getForeGroundColorO;

/**
* Returns extended highlight attribute property public int getHighLight();
/**
* Returns extended transparency attribute property public int getTransparency();

/**
* Returns base display attribute property public boolean isDisplay( * Returns base intensity attribute property public boolean isHighIntensity();

/**
* Left Vertical line required for field outlining extended attribute public boolean isLeftline();

/**
* Mandatory entry from field validation extended attribute public boolean isMandatoryEntry();

/**
* Mandatory fill from field validation extended attribute public boolean isMandatoryFill();

/**
* Returns base modified attribute property public boolean isModified();

* Returns base numeric attribute property public boolean isNumeric();

* Overline required for field outlining extended attribute public boolean isOverline();

* Returns penDetectable property public boolean isPenDetectable 0 ;

* Returns base protected attribute property *1 public boolean isProtected O ;

* Right Vertical line required for field outlining extended attribute public boolean isRightline();

/**
* Mandatory fill from field validation extended attribute public boolean isTrigger();

Hex" ftrlnfo * <p>
* This interface defines the text attribute field interface. This will * allow a user to query the color and extended attributes of each character * in the text of a field.

public interface ITextAttrlnfo extends Cloneable, java.io.Serializable {
/**
* Creates a new object of the same class as this object. It then initializes * each of the new object's fields by assigning it the same value as * the corresponding field in this object. No constructor is called.
* @return A new object initialized to the same state as this object.
public object clone() throws CloneNotSupportedException;

* This method determines if the two TextAttrlnfo types are equivalent.
* Returns true if this TextAttrlnfo type is the same as the obj argument;
* false otherwise.
* The object parameter is he reference object with which to compare.
public boolean equals(Object other);

* Returns a character array of the text colors.
public char[] getTextColors();

/**
* Returns a character array of the extended attributes.
public char[] getTextExtAttrs();
}

IFieldRecord public interface IFieldRecord extends IFieldlnfo {

* Methods used to access fields and screen characteristics void appendText (String text) throws ScreenException;

* Returns Background color data *

int getBackGroundColor();

* Returns Foreground color data *

int getForeGroundColor();
I**
* Returns highlighting data *

int getHighlight();

* Returns maximum length of a field data *

public int getMaxLength();

* Returns transparency data *

int getTransparency 0 ;

* Returns data indicating whether field is displayed.
*

boolean isDisplay();
/**
* Returns boolean value indicating whether field is High Intensity *

boolean isHighIntensity();
/**
* Returns boolean value indicating whether field has been modified *

boolean isModified O ;

* Returns boolean value indicating whether field is numeric *

boolean isNumeric O ;
/**
* Returns boolean value indicating whether field is Pen *

boolean isPenDetectable 0 ;
/**
* Returns boolean value indicating whether field is protected *
*/

boolean isProtected();

void setText(String text) throws ScreenException;
}

IFieldRecord * <p>
* This interface defines the field information interface used by * an application to obtain the name, starting column, starting row, * starting position, or text of a field.

public interface IFieldInfo {

* Returns the name of the field.
String getName();

* Returns the starting column of the field.
int getStartCol();

* Returns the starting position of the field.
int getStartPos();

* Returns the starting row which contains the field.
int getStartRow();

* Returns the text of the field.
String getText();
}

APPENDIX B

ScreenRecord * Screen record supports the user and resource adapter interfaces for working * with a screen record.

public class ScreenRecord implements IExtendedAttributes, IScreenable, IScreenRecord, java.io.Serializable, javax.resource.cci.Record {

* Iteration function for stepping through fields in a screen record protected final class Fieldlterator implements Iterator {
}
* Basic Data structure.
public ScreenRecord() {
super();
fields- = new java.util.HashMap();
nameMap_ = new java.util.HashMap();
fieldlndex = 0;
name = new String();
description- = new String();
depth = [Screen depth in rows]
width = [Screen width in columns];
screenld }

* Adds a field to the screen record void addField(FieldRecord fld, int fldlndex) {
}

j**
* Removes all the fields from the screen record.

public void beginBuild(IScreenInfo scrInf, boolean clearRecord) {
}

* Sets the screen image dimensions in the screen record.
protected void setScreenDimensions(int depth, int width) {
}

* This method either creates a new field within the screen record * or populates an existing one. The reference to an existing field * is the "name" attribute. A Resource Adapter can pass null for.
* this attribute to indicate the field has no name. When a field is * created it is assigned an index number. The index number * starts at 1 and increment for each invocation of createField.
* The Resource Adapter delivers fields in a left to right, top to * bottom approach.

public void buildField(IFieldData fidinfo, IFieldAttrInfo fieldAttributes, ITextAttrlnfo textAttributes) {
}
* Creates a new object of the same class as this object. It then initializes * each of the new object's fields by assigning it the same value as * the corresponding field in this object. No constructor is called.
* A new object initialized to the same state as this object.

public object clone() throws CloneNotSupportedException {
}

* This method determines if the FieldRecords are equivalent.
* Returns TRUE if this FieldRecord is the same.as the obj argument;
* Returns FALSE otherwise.

* @param obj The reference object with which to compare.

public boolean equals (Object obj) {
}

* Returns the field specified by the index.

public IFieldRecord getField(int index) throws ScreenException {
}

/**
* Returns the field specified by the name.

public IFieldRecord getField(String name) throws ScreenException {
}

* Return the number of fields in the screen.
public int getFieldCount() {
}

* getFields method returns public java.util.Iterator getFields() {
}

* getModifiedFields method returns only modified fields.
* Modified fields determined by a boolean variable.
* Method may be modified to return only fields that are modified * and that are not protected (modifications of protected fields * are not allowed) public java.util.iterator getModifiedFields() {
}

/**
* getRecordName method Returns Screen Record name.
public String getRecordName() {
}

* getRecordShortDescription returns description of Screen Record.
public String getRecordShortDescription() {
}
/**
* Returns the number of rows (depth) of a screen public int getScreenDepth() {
}

* getScreenId method returns the unique identifier (ID) of a screen record public. String getScreenId() {
}

/**
* Returns the number of columns (width) of a public int getScreenWidth() {
}
/**
* setRecordName method sets the screen record's name. Another method which * enables access to the Record name (in this case access being the ability * write or set the value) public void setRecordName(String name) {
}

* setRecordShortDescription method sets the description of the screen record.

public void setRecordShortDescription(String description) {
}

* setScreenId method sets the unique identifier (ID) of a screen record.
public void setScreenId(String screenId) {
}
}

APPENDIX C

FieldRecord public class FieldRecord implements IFieldRecord, java.io.Serializable {
*

protected FieldRecord() {
super ( ) ;
}
* FieldRecord provides the methods and variables to describe * the features and characteristics of a field public FieldRecord( String name, int position, int row, int col, String text, int maximumLength, IFieldAttrlnfo fieldAttributes, ITextAttrlnfo textAttributes) {
}

* Appends text to a field's data * If a field is protected (i.e., it cannot be amended), the * appendText method throws an exception public void appendText (String text) throws ScreenException {
}

* Creates a new object of the same class as the object passed.
* The clone method then initializes * each of the new object's fields by assigning it the same value as * the corresponding field in passed object. No constructor is called.
* A new object initialized to the same state as this object.

{
public object clone() throws CloneNotSupport edExcept ion }
* The equals method determines if the FieldRecords are equivalent.
* Returns TRUE if this FieldRecord is the same as the obj argument;
* Returns FALSE otherwise.
* The parameter passed obj, is the reference object with which to * compare.

public boolean equals(Object obj) {
}

/**
* Returns a value indicative of the background color.
public int getBackGroundColor() {
}
* Returns a value indicative of the foreground color.
public int getForeGroundColor() {
}
* Returns a value indicative of the highlighting.
public int getHighlight() {
}

* Returns a value indicative of the maximum length of a field.

public int getMaxLength() {
}

* Returns a value indicative of the field's name.
public String getName() {
}
* Returns a value indicative of the column where a field starts.
public int getStartCol() {
}
1**
* Returns a value indicative of the position where a field starts.
public int getStartPos() {
}
* Returns a value indicative of the row where a field starts.
public int getStartRow() {

* Returns a value indicative of the text associated with a field.
public String getText() {
}

* Returns a value indicative of the color attribute a field's text.
public char[] getTextColors() {
}
* Returns a extended text attributes.
public char[] getTextExtAttrs() {
}
* Returns a value indicative of the transparency attribute of * a field.

public int getTransparency() {
}

* Returns a value indicative of whether a field is to be displayed.
public boolean isDisplay() {
}
* Returns a value indicative of the intensity of field (a display * characteristic).
*1 public boolean isHighIntensity() {
}

/**
* Returns a boolean value indicative of whether a field * has been modified.

public boolean isModified() {

}

* Returns a value indicative of the type of data that is * contained by a field.

public boolean isNumeric() {
}

* Returns a value indicative of whether the data associated with * field is protected (i.e., not modifiable).

public boolean isProtected() {
}

}

Claims (3)

1. A computer-implemented method for providing data describing a screen image to a first application executing on a client and a host system executing a second application and connected to the client via a network, the client having a resource adapter and a screen record, the method comprising:

the screen record providing a screen image to the first application;

the resource adapter passing a IScreenInfo object to the screen record, said object providing information on the whole screen image;

the resource adapter receiving the data describing the screen image from the second application, wherein the screen image data is transmitted by the second application in a first format used by the second application's unmodified graphical user interface;

the client translating the data which the resource adapter received from the second application into a second format which can be used by the first application, in the client, populating the screen record in an object oriented environment with the data received from the second application and describing a field in order to translate the data into the second format, the population being performed using an interface which is implemented by the screen record and is used by the resource adapter, the screen record in the object oriented environment having a code to access the data describing the field, wherein a defined getFields method enables the access to the data within the screen record and returns an iterator of all the fields within the record.

2. The method as claimed in claim 1, wherein the resource adapter comprises a Java 2 Enterprise Edition connector.

3. A computer readable media containing data and instructions, the data and instructions, when executed, adapt a computer system to carry out the method of claim 1 or claim 2.