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.

• 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.

  Consider using LDAPUserNamePtr 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).

  Consider using LDAPUserNameOffset 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.