Previous Topic: Route Message Output to a File

Next Topic: Return and Reason Codes

Invoke a Monitor from Within a Program

When invoking CA Mainframe Application Tuner as a called program, you must pass it the following parameter list:

Parameter

Value

Notes

Parameter 1

(+0)

Value must point to a fullword with an integer of 1.

Value indicates the TUNCALL parameter list format.

Parameter 2

(+4)

This value is a pointer to the start of the command being processed.

The command being sent to TUNCALL in this manner is a single buffer.

No comments or continuation cards are allowed.

Buffer can be up to 32K in size.

Parameter 3

(+8)

This value is the address of an integer fullword containing the length of the command buffer specified in parameter 2.

Parameter 4

(+12)

This value is the address of a 16 byte area where the token is to be returned for MONITOR INVOKE.

currently, only the first 4 bytes of the area is actually used.

Parameter 5

(+16)

This value is the address of 2 consecutive 112 byte fields that contain messages upon return from TUNCALL.

Parameter 6

(+20)

This value is the address of a fullword of storage that contains the return code passed back by the server as a response to the request.

If TUNCALL ends with a return code of 16, this field should be examined further.

Parameter 7

(+24)

This value is the address of a fullword of storage to contain the reason code passed back by the server as a response to the request.

If TUNCALL ends with a return code of 16, this field should be examined further.