Control Parameters

The following table describes the Request-Reply Timer parameters.

Request-Reply Timer Control Parameters
Parameter Description
request-subject The name of the subject on which the Timer Utility listens for requests in order to capture the time and information about the request.
reply-subject The name of the subject on which the Timer Utility listens for the reply. This parameter enables the Timer Utility to match the request information to the reply and computes the elapsed the time the conversation took place.

You can specify up to three reply-subject names for a request subject.

field-name The name for the context value according to which the request or reply match is performed.
field-type The field type associated with the field name used as the context field request or reply conversation.

The valid types are as follows:

  • STR: string
  • OPA: opaque
  • U32 or I32: 32-bit unsigned integer or 32-bit signed integer
  • CE: Substation ES CICS envelope

If you specify CE as the type, you need not specify field-name and field-length. With CE as field-type, the Timer Utility identifies the envelope that originates from CICS.

field-length The length of the field associated with field-type. Normally, you specify field-length only if you define field-type as a string or opaque.

The valid range is 1 to 36 bytes. The default is 20 bytes.

print-ex-ctt The keyword that causes a printing of the entries that exceed the CICS round-trip time specified for the keyword value. Normally, quite a few entries can be printed during the sniffing of messages. Using this parameter reduces the amount printed if you are only looking for CICS round-trip messages that exceed a specific time value. The time stamp used is obtained from the message CICS Envelope.

The time value is in seconds and up to one-thousandth of a second, for example, 1.25, .123, or 0.035.

If both print-ex-ctt and print-ex-rtt are specified, the Timer Utility prints processes that exceed either limit, according to the set prtlvl level.

print-ex-rtt The keyword that causes a printing of the entries that exceed the round-trip time specified for the keyword value. Normally, quite a few entries can be printed during the sniffing of messages. Using this parameter reduces the amount printed if you are only looking for round-trip messages that exceed a specific time value.

The time value is in seconds and up to one-thousandth of a second, for example, 1.25,.123, or 0.035.

If both print-ex-rtt and print-ex-ctt are specified, the Timer Utility prints processes that exceed either limit, according to the level set in the prtlvl parameter.

prtlvl The level of the amount of information printed during the execution of the Timer Utility. If a high throughput of requests is to be processed, it is recommended that you specify a level of 2 or less.

The valid values are 0 to 5. The default is 0.

If thefield-type value is CE, to view the content of the envelope, set prtlvl to 3.