Pathway/iTS Web Client Programming Manual (G06.24+)

Compaq NonStop Pathway/iTS Web Client Programming Manual—520270-001
4-1
4
User-Written User Conversion
Procedures for Web Clients
If the SCREEN COBOL application you are converting to a web client includes USER
CONVERSION clauses and user-written user conversion procedures, Pathway/iTS
supports your existing pTAL user conversion routines running on a NonStop Himalaya.
User conversion procedures used with web clients are bound to a special user conversion
server class called USER-LIB-SERVER. This server class is then configured to run in
the Pathway environment. When user conversion is needed, the converted Java code
sends a message to the USER-LIB-SERVER server class, and the appropriate user
conversion procedure services the request. The server then sends its the reply to the
browser.
Because the USER CONVERSION clause is associated with each screen field item,
multiple messages to the USER-LIB-SERVER server class would ordinarily be needed
if the screen has multiple screen fields with a USER CONVERSION clause specified.
Pathway/iTS optimizes the number of messages sent to USER-LIB-SERVER by
collecting all user conversion information in a given screen and sending the message
once to USER-LIB-SERVER. If a SCREEN COBOL field has a USER CONVERSION
clause specified, the ScreenField class in the converted code will have the user
conversion attribute set. Whenever the converted Java application needs to
communicate with the NonStop Himalaya (for example, to perform an accept or server-
class send operation), the Gateway class packages the information for all the fields
needing user conversion and sends one message to USER-LIB-SERVER to perform the
user conversion.
To use your existing user conversion procedures on the NonStop Himalaya, you perform
two steps:
•
Build your existing user conversion library by binding it with the special user
conversion server class
•
Configure the user conversion server class
This section explains only what you need to do to use existing user conversion routines
that are installed and running correctly. For information on maintaining or modifying
your existing user conversion routines, refer to the Pathway/iTS TCP and Terminal
Programming Guide.