RemoteUserIdentifier (MQCHAR12)

This field specifies the first 12 bytes of a user identifier from a partner.

There are two fields that contain the remote user identifier:
  • RemoteUserIdentifier contains the first 12 bytes of the remote user identifier, and is padded with blanks if the identifier is shorter than 12 bytes. RemoteUserIdentifier can be blank.
  • LongRemoteUserIdPtr points to the full remote user identifier, which can be longer than 12 bytes. Its length is given by LongRemoteUserIdLength. The full identifier contains no trailing blanks, and is not null-terminated. If the identifier is blank, LongRemoteUserIdLength is zero, and the value of LongRemoteUserIdPtr is undefined.

    LongRemoteUserIdPtr is not present if Version is less than MQCD_VERSION_6.

The remote user identifier is relevant only for channels with a ChannelType of MQCHT_CLNTCONN or MQCHT_SVRCONN.
  • For a security exit on an MQCHT_CLNTCONN channel, this value is a user identifier that has been obtained from the environment. The exit can choose to send it to the security exit at the server.
  • For a security exit on an MQCHT_SVRCONN channel, this field might contain a user identifier which has been obtained from the environment at the client, if there is no client security exit. The exit might validate this user ID (possibly with the password in RemotePassword) and update the value in MCAUserIdentifier.

    If there is a security exit at the client, then this information can be obtained in a security flow from the client.

The length of this field is given by MQ_USER_ID_LENGTH. This field is not present if Version is less than MQCD_VERSION_2.