Home

 

AuthInfoRecPtr (PMQAIR)

This is the address of the first authentication information record. The field is ignored if AuthInfoRecCount is zero.

We can provide the array of MQAIR records in one of two ways:

• By using the pointer field AuthInfoRecPtr

  In this case, the application can declare an array of MQAIR records that is separate from the MQSCO structure, and set AuthInfoRecPtr to the address of the array.

  Using AuthInfoRecPtr 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 AuthInfoRecOffset

  In this case, the application must declare a compound structure containing an MQSCO followed by the array of MQAIR records, and set AuthInfoRecOffset to the offset of the first record in the array from the start of the MQSCO 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 AuthInfoRecOffset is recommended for programming languages that do not support the pointer data type, or that implement the pointer data type in a fashion that is not portable to different environments (for example, the COBOL programming language).

Whatever technique you choose, only one of AuthInfoRecPtr and AuthInfoRecOffset can be used; the call fails with reason code MQRC_AUTH_INFO_REC_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