CICS management client interface error messages

A typical example of a CMCI message is as follows:

<?xml version="1.0" encoding="UTF-8"?>
<error message_id="DFHWU4003" connect_version="0410">
<title>400 CICS management client interface HTTP Error</title> 	
<short>An error has occurred in the CICS management client interface. The request cannot be processed.</short> 	
<full> An unknown query parameter was specified in the URI.</full>  	
<errorInfo name="ccc">ccc</errorInfo>  
</error>

The message consists of the message identifier, title, short and long explanations, and specific error information. In this case the information in the <errorInfo> element identifies the unknown query parameter in the URI.

DFHWU4001 - DFHWU4029, HTTP 400 errors:

An HTTP 400 response code indicates that the request was not understood by the server. All HTTP 400 responses include the following information:

400 CICS management client interface Error

• An error has occurred in the CICS management client interface. The request cannot be processed. full explanation

Where full explanation is one of the following:

• The resource name was not specified in the URI.
• The URI specified contains a PATH that exceeds the maximum allowable length of 256 bytes.
• An unknown query parameter was specified in the URI.
• The context was missing from the URI.
• The result cache token was missing from the URI.
• The body of the HTTP request was missing.
• The body of the HTTP request was not specified correctly.
• The record index specified in the URI is not valid.
• The record count specified in the URI is not valid.
• The record index was specified for a noncached result.
• Extraneous data was detected at the end of the URI.
• Multiple CRITERIA expressions were found in the URI.
• Multiple PARAMETER expressions were found in the URI.
• Multiple NODISCARD expressions were found in the URI.
• Multiple SUMMONLY expressions were found in the URI.
• CRITERIA is not valid for result cache operations.
• PARAMETER is not valid for result cache operations.
• The resource name was missing from the URI.
• A specified attribute was not valid for this resource.
• The DEFVER attribute was not specified or was specified with a value of zero.
• A value of a specified attribute was out-of-range or not valid.
• NODISCARD is only valid for HTTP GET requests.
• CRITERIA is not valid for HTTP POST requests.
• PARAMETER is not valid for HTTP POST requests.
• The result cache token specified exceeded its maximum allowable length.
• An action was specified in the HTTP body that was not valid.

DFHWU4030, HTTP 401 error:

401 Basic Authentication Error

• Authentication with the server has failed.
• A user name, or password, or both are required but missing or incorrect.

DFHWU4300, HTTP 403 error:

403 CICS management client interface Access Forbidden

• An error has occurred in the CICS management client interface. Access to the specified result cache has been denied.
• The result cache token specified in the URI does not belong to the user who made the request.

DFHWU4400 - DFHWU4402, HTTP 404 errors:

404 CICS management client interface Resource Not Found

• An error has occurred in the CICS management client interface. The resource specified in the URI could not be found.
• The resource type is not supported by this version of the CICS management client interface.

404 CICS management client interface Result Cache Record Not Found

• An error has occurred in the CICS management client interface. The result cache record specified could not be found.
• The result cache record index was out of range.

404 CICS management client interface Result Cache Not Found

• An error has occurred in the CICS management client interface. The result cache specified could not be found.
• The result cache token could not be found.

DFHWU4500, HTTP 405 errors:

405 CICS management client interface Method (DELETE|GET|POST|PUT|HEAD|Unknown) Not Allowed

• An error has occurred in the CICS management client interface. The specified HTTP method is not allowed for the URI.
• A method has been specified that is not valid for the URI sent to the CICS management client interface.

DFHWU5000 - DFHWU5002, HTTP 500 errors:

500 System Management client Internal Server Error

• An internal error has occurred in the CICS management client interface.
• Contact your system administrator.

500 CICS management client interface Short On Storage

• The CICS management client interface server has gone Short On Storage below the bar.
• Contact your system administrator.

500 CICS management client interface Short On Storage

• There was insufficient GCDSA storage available to complete the request.
• Contact your system administrator.