Home

 

Fields

 

Type (MQLONG)

Structure type.

This indicates that the structure is a MQCFIF structure describing an integer filter parameter. The value must be:

MQCFT_INTEGER_FILTER

Structure defining an integer filter.

StrucLength (MQLONG)

Structure length.

This is the length in bytes of the MQCFIF structure. The value must be:

MQCFIF_STRUC_LENGTH

Length of command format integer-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. Any of the parameters which can be used in the Inquire command can be used in this field.

The parameter is from the following groups of parameters:

• MQIA_*

• MQIACF_*

• MQIAMO_*

• MQIACH_*

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

MQCFOP_CONTAINS

Contains a specified value. Use this when filtering on lists of values or integers.

MQCFOP_EXCLUDES

Does not contain a specified value. Use this when filtering on lists of values or integers.

See the FilterValue description for details telling you which operators may be used in which circumstances.

FilterValue (MQLONG)

Filter value identifier.

This specifies the filter-value that must be satisfied.

Depending on the parameter, the value and the permitted operators can be:

• An explicit integer value, if the parameter takes a single integer value.

  You can only use the following operators:

  • MQCFOP_GREATER

  • MQCFOP_LESS

  • MQCFOP_EQUAL

  • MQCFOP_NOT_EQUAL

  • MQCFOP_NOT_GREATER

  • MQCFOP_NOT_LESS

• An MQ constant, if the parameter takes a single value from a possible set of values (for example, the value MQCHT_SENDER on the ChannelType parameter). We can only use MQCFOP_EQUAL or MQCFOP_NOT_EQUAL.

• An explicit value or an MQ constant, as the case may be, if the parameter takes a list of values. We can use either MQCFOP_CONTAINS or MQCFOP_EXCLUDES. For example, if the value 6 is specified with the operator MQCFOP_CONTAINS, all items where one of the parameter values is 6 are listed.

For example, if we need to filter on queues that are enabled for put operations in your Inquire Queue command, the parameter would be MQIA_INHIBIT_PUT and the filter-value would be MQQA_PUT_ALLOWED.

The filter value must be a valid value for the parameter being tested.

 

Parent topic:

MQCFIF - PCF integer filter parameter

pc14880_

 

Home