Examples of Control Statements

The section contains examples of control statements.

Example: User Application to Substation ES Conversation

request-subject     my-request-subject
reply-subject       my-reply-subject
field-name          sequence-number
field-type          U32

Example: CICS-Initiated Request or Reply Conversation

request-subject     my-request-subject
reply-subject       my-reply-subject
field-type          CE
prtlvl              3
print-ex-rtt        0.055

Timer Utility

All dates are in the format CCYY-MM-DD.

All time values are represented in a thousandth of a second.

CICS-Initiated Request Or Reply

If the field-type value is CE, the print level is 3, and the Timer Utility times a CICS-initiated request or reply conversation, the following fields are displayed: 
SXG8645I CICS Send Time :2003/09/09 -- 11:17:06.504 -Task#:565 Idx:0
SXG8642I Req Time, Reply Time :11:17:06.824, 11:17:06.863
SXG8652I Round Trip Time :0.039 (sec.ths)

CICS Envelope Fields

Field Description
CICS Send Time The time stamp of the Substation ES CICS SXCREQR routine that receives the request from the user application in the CICS region.
Task# The task number of the user CICS application that issued the request.
Idx# The internal storage array allocation that the Substation ES CICS Request or Reply Facility used to hold the context or envelope.
Req Time The time at which Timer Utility received the request message.
Reply Time The time at which the Timer Utility received the reply message.
CICS Trip Time The time difference between when the message is sent by the CICS routine and when the reply message is received by the timer routine.
Round Trip Time The elapsed time the external application took to produce the reply. This length of time includes the time it took the network to deliver the message to and from the external application.

Normal Request or Reply

An example of a normal request or reply is listed as follows. The first two lines show the context field name and the field value used by the Request-Reply Timer Utility. 
sequence-number :2147483647 Reqst Idx:0
sequence-number :2147483647 Reply Idx:0
SXG8642I Req Time, Reply Time :14:42:50.012, 14:42:50.086
SXG8652I Round Trip Time :0.074 (sec.ths)

REFRESH Command Output

An example of the output of the REFRESH command is listed as follows. For an explanation, see TIBCO Substation ES Messages and Codes. 
SXG8110I z/OS Console Command:REFRESH
SXG8014I Current time is - 12:44:57.560
SXG8655I Interval Started :2003/09/09 -- 12:43:01.566
SXG8656I Interval Ended :2003/09/09 -- 12:44:42.076
SXG8659I Interval Elapsed Time :100.510 (secs.ths)
SXG8650I Hi Water Mark :1
SXG8651I No of Interval Events :2
SXG8653I Round Trip Time (Avg) :0.041 (sec.ths)
SXG8654I Messages per Second :0.020 (sec.ths)
SXG8658I Refresh completed. All entries cleared

Print Output Levels

The following table shows the messages by printing output level.

Messages by Print Output Level
Print Level Messages
0 No normal runtime messages

Summary report

1 No normal runtime messages

Start and end timestamps summary message

Summary report

2 Round-trip runtime messages

Start and end timestamps summary message

Summary report

3 Runtime messages:
  • Round trip time
  • Request time
  • Response time

Start and end timestamps summary message

Summary report

4 Runtime messages:
  • Round trip time
  • Request time
  • Response time
  • Slot data on request message
  • Matching field name
  • Matching Data
  • Slot number

Start and end timestamps summary message

Summary report

5 Runtime messages:
  • Round trip time
  • Request time
  • Response time
  • Slot data on request message
  • Matching field name
  • Matching Data
  • Slot number
  • Slot data on request message: hex dump
  • Reply data: hex dump

Start and end timestamps summary message

Summary report