TRANSFER Release D30 Documentation Supplement

Message Counting
1-22 118474—TRANSFER Release D30 Documentation Supplement
TRANSFER D30 Documentation Supplement
* Rec-seq-num 1 = 1st, 2 = 2nd and 3 = 3rd
Class
10 Reset-timestamp TYPE BINARY 64.
10 Last-Update-timestamp TYPE BINARY 64.
10 Total-Message-count TYPE BINARY 32.
10 Node OCCURS 256 TIMES.
15 Message-count TYPE BINARY 32.
10 FILLER PIC X(28).
PROFILE Types:
951 - Local submits
952 - Local deliveries
953 - Sent remote
954 - Received from remote
Considerations
The rec-seq-num indicates class. Rec-seq-num 1 = 1st, 2 = 2nd, and so on.
The records are stored as system control. The update count is always set to 0 so it does
not overflow. Although there is an update timestamp in the record, it is not available
through the UOW interface, so a last update timestamp is included in the data portion.
If the message-count exceeds Binary 32, then the value is set to -1D and not
incremented. A binary 32 value holds 4,294,967,295 messages before an overrun
condition occurs. It is assumed that a user program periodically collects the data and
resets the counters. (For a TRANSFER system generating 10 messages a second, the
maximum counter for one year would be 315,360,000, which would not overflow the
counter.)
To minimize record locking contention, use a subtransaction will be used to update these
profile records. Some messages might be counted an extra time if the transaction is
restarted but this should not be a significant problem.
A new parameter, COUNTMESSAGES, is recognized by TISERV, TWORK, and
TRECV. It can have one of four values:
Only the first character is checked (“N”, “M”, “D”, “B”). If it is not valid, the following
message is displayed, and the program abends.
COUNTMESSAGES NONE No counting is done. This is the default
COUNTMESSAGES MSGS Do the counting, but do not include Delivery counts
as they are more expensive.
COUNTMESSAGES DELIVS Do the delivery counting only.
COUNTMESSAGES BOTH Do all the counting, messages, and deliveries.
Invalid value for COUNTMESSAGES. Must be NONE, MSGS, DELIVS
or BOTH.