Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 7 Connection : tibemsConnection : tibemsConnection_SetClientId

tibemsConnection_SetClientId
Function
Purpose
Set the client ID of a connection.
C Declaration
tibems_status tibemsConnection_SetClientId(
    tibemsConnection connection,
    const char* clientId );
COBOL Call
CALL "tibemsConnection_SetClientId"
USING BY VALUE connection,
BY REFERENCE clientId,
RETURNING tibems-status
END-CALL.
 
connection has usage pointer.
Parameters
 
Remarks
Each connection uses a unique client ID.
Client IDs partition the namespace of durable subscribers; see tibemsSession_CreateDurableSubscriber on page 301.
Administrators can configure connection factories to assign client IDs to new connections. Alternatively, administrators can allow client programs to assign their own IDs. If the factory does not assign an ID, the program may set this property. However, it is illegal to overwrite an existing client ID value, and or to set this property after using the connection in any way (for example, after creating a session, or starting the connection); attempting to set this property in these situations results in TIBEMS_ILLEGAL_STATE.
See Also
tibemsConnection_GetClientId on page 216

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved