WBTLC - Web Interface Template Manager

Table 1.
Offset Hex Type Len Name (Dim) Description
(0) STRUCTURE 56 DFHWBTL_ARG
(0) UNSIGNED 2 WBTL_VERSION_NO
(2) HALFWORD 2 WBTL_FUNCTION
(4) HALFWORD 2 WBTL_RESPONSE
(6) HALFWORD 2 WBTL_REASON
(8) CHARACTER 8 WBTL_CONNECT_TOKEN
(10) CHARACTER 8 WBTL_TEMPLATE_NAME
(18) CHARACTER 8 WBTL_TEMPLATE_ABSTIME
(20) ADDRESS 4 WBTL_TEMPLATE_ BUFFER_PTR
(24) FULLWORD 4 WBTL_TEMPLATE_ BUFFER_LEN
(28) ADDRESS 4 WBTL_SYMBOL_LIST_PTR
(2C) FULLWORD 4 WBTL_SYMBOL_LIST_LEN
(30) ADDRESS 4 WBTL_HTML_BUFFER_PTR
(34) FULLWORD 4 WBTL_HTML_BUFFER_LEN
(38) CHARACTER 0 *

Constants

Table 2.
Len Type Value Name Description
Licensed Materials - Property of IBM

5655-Y04

(C) Copyright IBM Corp. 1996, 2015 All Rights Reserved.


This is the parameter list for the CICS Web Interface Template
Manager, DFHWBTL.

--------------------------------------------------------------------

The Template Manager supports the following functions:

BUILD_HTML_PAGE
This function builds a whole HTML page from a specified
template, using optional symbol substitution. This function is a
composite of all the other HTML building functions of this
module.
START_HTML_PAGE
This function initializes an environment for the
ADD_HTML_TEMPLATE function, and optionally builds an symbol
table from the list supplied in the parameter SYMBOL_LIST. It
returns a token in CONNECT_TOKEN that represents the created
environment.
ADD_HTML_SYMBOLS
This function adds further symbols to the symbol table created
by START_HTML_PAGE. The names of the symbols are case-sensitive.
If a symbol is added with the same name as one that is already
defined, the new symbol definition replaces the old one.
READ_HTML_TEMPLATE
This function reads a named HTML template into main storage. If
the template named in WBTL_TEMPLATE_NAME exists as a member of
the partitioned dataset allocated to the DFHHTML data definition
statement, it is read into main storage. The address and length
of the storage containing the buffer are returned in
WBTL_TEMPLATE_BUFFER_PTR and WBTL_TEMPLATE_BUFFER_LEN, and the
template name is cleared to binary zeroes.
ADD_HTML_TEMPLATE
This function interprets an HTML template by substituting into
it the current values of the symbols.
END_HTML_PAGE
This function destroys the environment created by the
START_HTML_PAGE function, and releases any storage acquired by
earlier functions in the sequence.

--------------------------------------------------------------------
2 DECIMAL 1 WBTL_BUILD_HTML_PAGE
2 DECIMAL 2 WBTL_START_HTML_PAGE
2 DECIMAL 3 WBTL_ADD_HTML_SYMBOLS
2 DECIMAL 4 WBTL_READ_HTML_ TEMPLATE
2 DECIMAL 5 WBTL_ADD_HTML_TEMPLATE
2 DECIMAL 6 WBTL_END_HTML_PAGE
The following is the value that should be specified in
WBTL_VERSION_NO to show the level at which the calling module was
compiled.

--------------------------------------------------------------------
2 DECIMAL 0 WBTL_CURRENT_VERSION
2 DECIMAL 56 WBTL_PARAMETER_LEN
The following are the possible responses from the DFHWBTL program.

--------------------------------------------------------------------
2 DECIMAL 0 WBTL_OK
2 DECIMAL 4 WBTL_EXCEPTION
2 DECIMAL 8 WBTL_INVALID
2 DECIMAL 12 WBTL_DISASTER
The following are the possible responses from the DFHWBTL program,
if the returned reason is not OK.

--------------------------------------------------------------------
2 DECIMAL 1 WBTL_INVALID_FUNCTION
2 DECIMAL 2 WBTL_INVALID_TOKEN
2 DECIMAL 3 WBTL_INVALID_SYMBOL_ LIST
2 DECIMAL 4 WBTL_INVALID_BUFFER_ PTR
2 DECIMAL 5 WBTL_FEATURE_INACTIVE
2 DECIMAL 6 WBTL_TEMPLATE_NOT_ FOUND
2 DECIMAL 7 WBTL_TEMPLATE_ TRUNCATED
2 DECIMAL 8 WBTL_PAGE_TRUNCATED
2 DECIMAL 9 WBTL_GETMAIN_ERROR
2 DECIMAL 10 WBTL_FREEMAIN_ERROR
2 DECIMAL 11 WBTL_INVALID_VERSION