ctgclient_esi.h File Reference
#include <time.h>
#include "ctgclient.h"

Go to the source code of this file.

Detailed Description

Defines functions and typedefs for sending External Security Interface (ESI) requests to a Gateway daemon.

Definition in file ctgclient_esi.h.

Macro Definition Documentation

Definition at line 56 of file ctgclient_esi.h.

Communication with the target CICS server was interrupted during the request.

Definition at line 261 of file ctgclient_esi.h.

There are insufficient communication resources to complete the request.

Definition at line 294 of file ctgclient_esi.h.

The CICS TG has reached its limit on the maximum number of CICS servers.

Definition at line 289 of file ctgclient_esi.h.

Communication with the target CICS server could not be established.

Definition at line 256 of file ctgclient_esi.h.

There are insufficient communication resources to communicate with the target CICS server.

Definition at line 252 of file ctgclient_esi.h.

The value of the new password was NULL or an empty string.

Definition at line 279 of file ctgclient_esi.h.

The value of the old password was NULL or an empty string.

Definition at line 275 of file ctgclient_esi.h.

password is NULL or an empty string.

Definition at line 221 of file ctgclient_esi.h.

userid is NULL or an empty string.

Definition at line 212 of file ctgclient_esi.h.

The password for userid on the target CICS server has expired.

Definition at line 235 of file ctgclient_esi.h.

password is not the current password or password phrase for userid on the target CICS server.

Definition at line 217 of file ctgclient_esi.h.

The new password does not conform to the standards defined for the External Security Manager of the target CICS server.

Definition at line 284 of file ctgclient_esi.h.

Password Expiry Management has been disabled on the target CICS server.

Definition at line 231 of file ctgclient_esi.h.

The protocol used to communicate with the target CICS server does not support Password Expiry Management.

Definition at line 226 of file ctgclient_esi.h.

There are insufficient resources to communicate with the target CICS server; details might be available in the CICS TG error log files.

Definition at line 247 of file ctgclient_esi.h.

An error was detected by the External Security Manager.

This could be because the user ID has been revoked or the CICS server is not configured to communicate with the External Security Manager.

Definition at line 241 of file ctgclient_esi.h.

An internal system error has occurred.

If the problem persists, collect application and Gateway daemon trace and contact your IBM service representative.

Definition at line 271 of file ctgclient_esi.h.

The target CICS server is unknown to the Gateway daemon.

Definition at line 265 of file ctgclient_esi.h.

userid is rejected as invalid by the target CICS server.

Definition at line 208 of file ctgclient_esi.h.

No error.

Definition at line 204 of file ctgclient_esi.h.

The maximum length of a server name.

Definition at line 114 of file ctgclient_esi.h.

Function Documentation

Sends an ESI request to the Gateway to change the password or password phrase for the given user ID and then waits for the reply.

The reply is returned in the ESI_DETAILS structure.

Parameters
Returns
An integer value identifies whether the call was successful or not.
Possible values include Other possible values are all of the documented ESI return codes.

Converts a supplied ESI_DATETIME structure into a tm structure.

The tm structure is defined by time.h

Parameters
Returns
The pointer supplied in result.

Sends an ESI request to the Gateway to verify a User ID and password or password phrase and then waits for the reply.

The reply is returned in the ESI_DETAILS structure.

Parameters
Returns
An integer value identifies whether the call was successful or not.
Possible values include Other possible values are all of the documented ESI return codes.