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

Logon Security and User Profiles
Compaq NonStop Pathway/iTS Web Client Programming Manual—520270-001
3-2
Actions of the Web Client
Actions of the Web Client
If the logon is successful (that is, if the end user enters a valid user name/password
combination), the client application begins to run. However, before the browser
displays the starting page of the client application, the application communicates with
the host NonStop Himalaya to retrieve information associated with the profile entered
by the end user. This information resides in a database (with the Guardian file name
USERPROF) on the NonStop Himalaya.
A Pathway server program supplied as part of Pathway/iTS reads the database and
obtain the profile information on behalf of the application. The applet stores this
information in various special registers for later use. Then the browser displays the
starting page—that is, the HTML page corresponding to the INITIAL program unit in
the SCREEN COBOL source program—and the client application continues to run.
If the end user does not enter a profile (that is, if the entered profile is null), the user ID
and password are validated, but no values are retrieved or set for any of the special
registers.
If the end user enters a valid profile, the profile is sent via the web gateway to the server.
The server retrieves from the database and returns to the application the values of the
seven special registers associated with user profiles (defined in the following
subsection), and also returns values for the PW-TCP-PROCESS-NAME,
PW-TCP-SYSTEM-NAME, and TERMINAL-FILENAME special registers. (All other
SCREEN COBOL special registers have no meaning for web clients; these special
registers always have default values in the converted Java code.)
If the end user enters an invalid profile (one that is not in the user profile database), a
“Profile Not Found” popup message appears. In this case, no values are returned to the
application for the seven special registers associated with user profiles, but values are
returned for the other three special registers.
Contents of the User Profile Database
The USERPROF database is a key-sequenced database with the profile name as the key.
Each record of the user profile database consists of the key and seven fields; the values
of the seven fields are stored in corresponding special registers in the Java applet. The
fields are as follows:
Field Name Type and Length
Corresponding Special
Register in Applet
TERMINAL-PRINTER PIC X(36) TerminalPrinter
LOGICAL-TERMINAL-NAME PIC X(16) logicalTerminalName
USER-PROFILE-1 PIC X(36) userProfile1
USER-PROFILE-2 PIC X(36) userProfile2
USER-PROFILE-3 PIC X(36) userProfile3
USER-PROFILE-4 PIC X(36) userProfile4
USER-PROFILE-5 PIC X(36) userProfile5