iTP Active Transaction Pages (iTP ATP) Programmer's Guide

HTML Forms Generator
iTP Active Transaction Pages (iTP ATP) Programmer’s Guide—522292-002
C-2
Choosing a DDL Dictionary
Choosing a DDL Dictionary
The first step in using the HTML Forms Generator is to enter the name of the DDL
dictionary that defines the message layouts for your application. In the text entry field,
enter either of the following:
•
The name of an OSS symbolic link to your dictionary subvolume. You use the OSS
ln command to create a symbolic link. The name is relative to the directory of the
current script (the directory where dview is installed) and must not start with a
period (.) or a slash (/).
•
The name of the Map Class Define that refers to the dictddf file in the DDL
dictionary subvolume. You use the MapDefine command in the httpd
configuration file to establish the define; see the ATP configuration-file fragment for
examples.
After you enter the name of your dictionary, click on the Set Dictionary button.
The Reset button clears the text entry field so you can specify a different dictionary.
Choosing Request and Reply Messages
The screen you see next, after choosing a DDL dictionary, repeats the name you entered
on the first screen, then lists all the message layouts defined in the dictionary. Click on
the name of the layout for the message you wish to create in your ATP script.
Use the radio buttons in the Request column to select the format of the request message
to be sent to the server class. You can select only one request message.
Use the check boxes in the Reply column to select the format of each type of reply
message the server class can return. In the Reply Code column, type an expression
indicating the condition in which each type of reply message should be returned. The
variable rc represents the reply code that occupies the first two bytes of a reply message
from a Pathway (NonStop TS/MP) server. Use the C expression operators ==, !=, <, >,
<=, >=, !, || and &&, and the keywords (true) and (false) to express the desired
condition.
In the text entry box labeled Pathmon Process, enter the name of the Map Class Define
that identifies the name of the PATHMON process that monitors the target server class.
The Map Class Define must be established in the httpd.config file.
Note. Scanning the DDL dictionary to retrieve the list of message layouts can be time-
consuming, depending on the size of the dictionary. To avoid repeating the operation on
subsequent uses of the Forms Generator, save the list to an HTML file, using the browser
Save As feature. Later, to get the list of message layouts, you can open the HTML file in your
browser. Edit the HTML file to restrict the set of message layouts to the subset you really plan
to use. This technique saves only the message layouts, not a filled-out form.
Note. To browse the DDL dictionary as a basis for selecting message layouts, you can use the
DDL Dictionary Viewer (dview), described in Appendix B, DDL Dictionary Viewer (dview)
.