TRANSFER Programming Manual

Debugging Techniques
Designing and Writing a Client
069138, Update 1 to 040970 Tandem Computers Incorporated 9–19
The following elements are part of the preceding example:
The ASSIGN directive specifies the log file, which is the logical file DEBUGLOG.
The first PARAM directive selects which information is logged, as follows: if
DEBUGLOGLEVEL is set to a following value, and the PW-REPLY-CODE field in
the IPC header of the reply is greater than or equal to this value, the action taken is
as indicated in Table 9-1.
The second PARAM directive determines the format in which the log file is
written. Normally, this file is written as a binary file; but through this PARAM
directive, you can direct the TRANSFER delivery system to write the file in
displayable text by setting DEBUGLOGFORMAT to TRUE.
Table 9-1. DEBUGLOGLEVEL Values
DEBUGLOGLEVEL
Value Result
0 All IPCs are logged.
1 IPCs containing UOW warnings, UOW errors, and IPC request errors are
logged.
2 IPCs containing UOW errors and IPC request errors are logged.
3 IPCs containing IPC request errors are logged. This option is assigned as
a default.
4 Nothing is logged.
Alternatively, you can use the GUARDIAN 90 operating system File Utility Program
(FUP) to convert the binary content of the log file to ASCII, octal, or hexadecimal code.
Additional logging techniques include:
Log on a depot-by-depot basis. Use the ALTER-PROFILE-ELEM UOW to set the
DATA-DEPOT-LOG-FLAGS field to request this option.
Log selectively. Choose particular IPCs for recording on the log file. Set the LOG-
THIS-IPC field to Y in the headers of those IPCs that you want logged. This action
results in logging of those IPCs whether or not errors occur.
Add information to the log file. Include in each IPC a NOOP UOW that specifies
client data identifying the source of the transaction requested in the IPC.
The TRANSFER scheduler (TSCHED) and the TRANSFER asynchronous requesters
(TAREQs) write messages to the out file used by TSCHED. These messages reflect
problems dealing with initialization, UOWs, IPC headers, and SEND and HOLD
operations. If, in addition to the out file, you have configured a TSCHED log file, you
can examine this log file for possible additional debugging information.