PreConnect stanza of the client configuration file

Use the PreConnect stanza to configure the PreConnect exit in the mqclient.ini file.

Note: The description of each attribute of this stanza indicates which IBM® MQ clients can read that attribute. For a summary table for all IBM MQ MQI client configuration file stanzas, see Which IBM MQ attributes can be read by each client.

The following attributes can be included in the PreConnect stanza:

Data = <URL>

URL of the repository where connection definitions are stored.

This attribute can be read by C and unmanaged .NET clients.

For example, when using an LDAP server:

Data = ldap://myLDAPServer.com:389/cn=wmq,ou=ibm,ou=com

Function = <myFunc>

Name of the functional entry point into the library that contains the PreConnect exit code.

This attribute can be read by C and unmanaged .NET clients.

The function definition adheres to the PreConnect exit prototype MQ_PRECONNECT_EXIT.

The maximum length of this field is MQ_EXIT_NAME_LENGTH.

Module = <amqldapi>

The name of the module containing the API exit code.

This attribute can be read by C and unmanaged .NET clients.

If this field contains the full path name of the module, it is used as is.

Sequence = <sequence_number>

The sequence in which this exit is called relative to other exits. An exit with a low sequence number is called before an exit with a higher sequence number. There is no need for the sequence numbering of exits to be continuous; a sequence of 1, 2, 3 has the same result as a sequence of 7, 42, 1096. This attribute is an unsigned numeric value.

This attribute can be read by C and unmanaged .NET clients.

Multiple PreConnect stanzas can be defined within the mqclient.ini file. The processing order of each exit is determined by the Sequence attribute of the stanza.