Home

 

Fields

 

Type (MQLONG)

Structure type.

This indicates that the structure is a MQCFBF structure describing a byte string filter parameter. The value must be:

MQCFT_BYTE_STRING_FILTER

Structure defining a byte string filter.

StrucLength (MQLONG)

Structure length.

This is the length, in bytes, of the MQCFBF structure, including the string at the end of the structure (the FilterValue field). The length must be a multiple of 4, and must be sufficient to contain the string. Bytes between the end of the string and the length defined by the StrucLength field are not significant.

The following constant gives the length of the fixed part of the structure, that is the length excluding the FilterValue field:

MQCFBF_STRUC_LENGTH_FIXED

Length of fixed part of command format filter string-parameter structure.

Parameter (MQLONG)

Parameter identifier.

This identifies the parameter that is to be filtered on. The value of this identifier depends on the parameter to be filtered on.

The parameter is one of the following:

  • MQBACF_EXTERNAL_UOW_ID

  • MQBACF_Q_MGR_UOW_ID

  • MQBACF_ORIGIN_UOW_ID (on z/OS only)

Operator (MQLONG)

Operator identifier.

This identifies the operator that is being used to evaluate whether the parameter satisfies the filter-value.

Possible values are:

MQCFOP_GREATER

Greater than

MQCFOP_LESS

Less than

MQCFOP_EQUAL

Equal to

MQCFOP_NOT_EQUAL

Not equal to

MQCFOP_NOT_LESS

Greater than or equal to

MQCFOP_NOT_GREATER

Less than or equal to

FilterValueLength (MQLONG)

Length of filter-value string.

This is the length, in bytes, of the data in the FilterValue field. This must be zero or greater, and does not need to be a multiple of 4.

FilterValue (MQBYTE×FilterValueLength)

Filter value.

This specifies the filter-value that must be satisfied. Use this parameter where the response type of the filtered parameter is a byte string. Depending on the filter-keyword, this can be:

If the specified byte string is shorter than the standard length of the parameter in MQFMT_ADMIN command messages, the omitted characters are assumed to be blanks. If the specified string is longer than the standard length, it is an error.

 

Parent topic:

MQCFBF - PCF byte string filter parameter


pc14700_


 

Home