Home

 

LDAPUserNamePtr (PMQCHAR)

This is the LDAP user name. It consists of the Distinguished Name of the user who is attempting to access the LDAP CRL server. If the value is shorter than the length specified by LDAPUserNameLength, terminate the value with a null character, or pad it with blanks to the length LDAPUserNameLength. The field is ignored if LDAPUserNameLength is zero.

We can supply the LDAP user name in one of two ways:

• By using the pointer field LDAPUserNamePtr

  In this case, the application can declare a string that is separate from the MQAIR structure, and set LDAPUserNamePtr to the address of the string.

  Using LDAPUserNamePtr is recommended for programming languages that support the pointer data type in a fashion that is portable to different environments (for example, the C programming language).

• By using the offset field LDAPUserNameOffset

  In this case, the application must declare a compound structure containing the MQSCO structure followed by the array of MQAIR records followed by the LDAP user name strings, and set LDAPUserNameOffset to the offset of the appropriate name string from the start of the MQAIR structure. Ensure that this value is correct, and has a value that can be accommodated within an MQLONG (the most restrictive programming language is COBOL, for which the valid range is -999 999 999 through +999 999 999).

  Using LDAPUserNameOffset is recommended for programming languages that do not support the pointer data type, or that implement the pointer data type in a fashion that might not be portable to different environments (for example, the COBOL programming language).

Whichever technique is chosen, use only one of LDAPUserNamePtr and LDAPUserNameOffset; the call fails with reason code MQRC_LDAP_USER_NAME_ERROR if both are nonzero.

This is an input field. The initial value of this field is the null pointer in those programming languages that support pointers, and an all-null byte string otherwise.

Note:

On platforms where the programming language does not support the pointer datatype, this field is declared as a byte string of the appropriate length.

 

Home