The data records

The body of an HTTP response from a data interface request always contains a header, and can also return one or more data records following the HTTP header.

The description of each individual command states which commands return data records (see Data interface command reference). The structure of the complete HTTP response to a data interface request is shown in Figure 1, which illustrates the response to a DATA/FETCH request.

Figure 1. Structure of an HTTP response to a data interface request
This diagram illustrates the various elements that make up the structure of an HTTP response. The whole represents the complete HTTP package, which consists of an HTTP header and an HTTP body. The HTTP body is further split into the data header and data records.

Data representation

The data representation used for CICSPlex® SM resource table attributes depends on the attribute types. In general, the representation is as documented in CICSPlex SM resource tables. However, note following conventions used by the data interface:
Decimal points
These are always represented by a . (period).
Time and date fields
The separator for time fields is always a : (colon), and the separator for dates is always a / (slash). The representation used for dates is always of the form YYYY/DD/MM.
Non-printable characters
Character strings that contain non-printable characters are expressed in a quoted hexadecimal format. For example:

'DDFF0400DDFF0400'X

Special characters
Character strings that contain special characters (such as an apostrophe, for example) are expressed as quoted strings. In the following example, the phrase It's raining again, which contains a single apostrophe, is encoded as follows:
'It''s raining again.'