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 = user_data

This attribute specifies user data that is passed to the preconnect exit. The data that is passed to the preconnect exit is specific to the implementation of the preconnect exit that we are using and what data it is expecting to be passed.

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

For example, this attribute could be used to specify the URL of the repository where connection definitions are stored, such as, 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 = myMod

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.

Parent topic: Configure a client using a configuration file

Related information

• Referencing connection definitions using a pre-connect exit from a repository