# 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 thousandths 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

Copyright © TIBCO Software Inc. All rights reserved.