TRANSFER Reference Manual

Software Provided with the TRANSFER Delivery System
TISERV UOW Descriptions
069139, Update 1 to 40969 Tandem Computers Incorporated 2–5
The manual describes return codes for each UOW under the explanation of the
RETN-CODE field in the text that covers the UOW. However, the GDDL and
GCOB files define return codes in the form of COBOL level 88 statements for the
RETN-CODE field of each UOW, listing all error codes that TISERV might return.
The manual presents very few inline comments within the UOW definitions, while
the GCOB, GLNK, and GDDL files show several explanatory comments within
these definitions.
The manual often shows different indentations for UOW fields than those used in
the GCOB, GLNK, and GDDL files.
In the manual, the UOW definitions do not contain the REDEFINES clause for
instances of the ITEM-ID field where the TRANSFER delivery system permits use
of an ITEM-HANDLE; instead, the manual documents this usage in the
explanation of the ITEM-ID field in the text. On the other hand, the GCOB, GLNK,
and GDDL files contain ITEM-HANDLE REDEFINES ITEM-ID statements within
the applicable UOW definitions.
The GCOB, GLNK, and GDDL files all contain section names that you refer to
when copying portions of UOW definitions into your source program files. In the
GCOB and GLNK files, the section names contain UOW prefixes (explained
below). As an example, the section name for the ALTER-FOLDER-ORDER UOW
definition in GCOB and GLNK is:
?section UOW-AFO-ALTER-FOLDER-ORDER-UOW
In the GDDL file, however, section names use the UOW name only. For instance,
the section name for the ALTER-FOLDER-ORDER UOW definition in that file is
simply:
?section ALTER-FOLDER-ORDER-UOW
In the GCOB and GLNK files, all definitions are preceded by a seven- or eight-
character UOW prefix that uniquely identifies each data name. The prefix for each
definition appears as part of the comment that precedes the definition. For
example, the prefix for the ALTER-FOLDER-ORDER UOW is UOW-AFO-; the
prefix for the response is RSP-AFO-. Definitions in the GDDL file do not include
these prefixes.
Because each data name within the UOW or response definition is prefixed by this
character string, most (if not all) common field names are unique. For example,
the RETN-CODE field for the ALTER-FOLDER-ORDER response is
RSP-AFO-RETN-CODE, while the RETN-CODE field for the CREATE-FOLDER
response is RSP-CF-RTN-CODE. Without these prefixes, you would need to
qualify each non-unique data name with the working storage group name such as
RETN-CODE OF ALTER-FOLDER-ORDER-RSP.