Example: Diagnosing a CICS management client interface install error
To install a BAS resource using the CICS management client interface, you use a PUT request with an INSTALL action. If the install action fails, CICSPlex® SM generates a BINSTERR record containing diagnostic information. This record is returned in an <installerror> element, which is a child element of <feedback>.
About this task
You have attempted to install a URIMAP resource named URIMAP_A into the region DEVRGN1, using a PUT request with the following URI and XML body:
http://wmvs2c.mycorp.com:27640/CICSSystemManagement/CICSDefinitionURIMap/IBEUR912?
CRITERIA=name%3DURIMAP_A
<request>
<action name="INSTALL">
<parameter name="TARGET" value="DEVRGN1"/>
<parameter name="USAGE" value="LOCAL"/>
</action>
</request>
Although you receive an HTTP/1.1 200 OK response from the CICS management client interface indicating that the request was correctly formed, the URIMAP is not installed. The response includes the following information:
To understand the reason for this problem, perform these steps:<resultsummary api_function="PERFORM SET" api_response1="1038" api_response1_alt="TABLEERROR"
api_response2="1361" api_response2_alt="DATAERROR" recordcount="1"/>
<errors>
<feedback action="INSTALL" attribute1="NAME" errorcode="31"> <installerror eibfn="3036"
eibfn_alt="CREATE URIMAP" errorcode="4" eyu_cicsname="IBWUIA" resourcename="URIMAP_A"
resourceversion="1" resp="16" resp2="500"/>
</feedback>
</errors>