Query strings

A query string is an input parameter, specifying the statistical data to be retrieved.

A query string is an input parameter to statistical C API functions which provide a result set token pointer. The string is a null-terminated, colon-separated list of IDs. The IDs can be statistical group IDs, or statistical IDs. An empty query string "" is interpreted as matching all IDs appropriate to the function call.

Query strings are of type (char *), and contain character data in the native encoding. The null terminator is added implicitly when creating strings in C using the "" characters.

The user application creates and manages the query string character buffer.

Where an C API function produces a data result set, the function getIdQuery can be used to obtain a query string suitable for input to another C API call.

Example

A pseudo-code example showing the query string used to retrieve the Gateway daemon status and all connection manager statistics is:
result = getStatsByStatId(gwyTok, "GD_CSTATUS:CM", &rsToken1;

Concept Concept

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tgzos_latest/help/topic/com.ibm.cics.tg.zos.doc//progdezos/querystrings.html