<records> element

The <records> element contains details of the records returned by a request. The <records> element contains one child element for each record returned by the request. If the request returns no records, the <records> element is absent.

Contained by

<response> element

Contains

The <records> element contains one child element for each instance of a resource changed by the request. These child elements are named by the resources identified in the request URI. For example, if a PUT request makes changes to CICS local files, the <records> element of the PUT response contains one or more child elements named <cicslocalfile>; that is, one <cicslocalfile> element for each record returned by the request. Child element names are derived from the CICS management client interface resource names. See CMCI resource names for a complete list of these names.

Attributes

The <records> element has no attributes if its own.

The attributes of child elements specify the values of the attributes of the identified resource. All the attributes of the resource are present in the element, whether or not the value of the attribute has changed. Attributes with values that are left blank take their default values. See CICSPlex SM resource tables for a list of required attributes for each resource.

Each resource element also includes a _keydata attribute that takes the form _keydata="data string", where data string is a string of characters that uniquely identifies an instance of the resource.

Example

The following example shows a single record listing an instance of a CICSLocalFile resource.

<records>
	<cicslocalfile _keydata="C4C6C8C3E2C44040" accessmethod="VSAM" add="ADDABLE" addcnt="0"
	basedsname="USER1.ALLAPPL.DFHCSD" blockformat="BLOCKED" blockkeyln="N/A"
	blocksize="N/A" browse="BROWSABLE" browsecnt="2115" browupdcnt="0" datasettype="K"
	delete="DELETABLE" dexcpcnt="0" disposition="SHARE" dsname="USER1.ALLAPPL.DFHCSD"
	emptystatus="NOEMPTYREQ" enablestatus="ENABLED" exclusive="NOTAPPLIC" file="DFHCSD"
	fwdrecstatus="NOTFWDRCVBLE" getcnt="115" getupdcnt="0" gmtfilecls="00:00:00.0000"
	gmtfileopn="00:00:00.0000" iexcpcnt="0" journalnum="0" keylength="0"
	keyposition="0" locdelcnt="0" lsrpoolid="01" numactstring="0" numdatbuff="0"
	numindexbuff="0" numstringwt="0" object="BASE" openstatus="CLOSED"
	rbatype="NOTAPPLIC" read="READABLE" readinteg="NOTAPPLIC" recordformat="VARIABLE"
	recordsize="0" recovstatus="NOTRECOVABLE" reltype="NOTAPPLIC" rlsaccess="NOTRLS"
	rlsreqwtto="0" strings="6" timeclose="0:00:00.0" timeopen="0:00:00.0"
	update="UPDATABLE" updatecnt="0" vsamtype="NOTAPPLIC" wstrccurcnt="0" wstrcnt="0"
	eyu_cicsname="U1WUIA" eyu_cicsrel="E660" eyu_reserved="0"/>
</records>