Inquire Policy on Multiplatforms

The Inquire Policy (MQCMD_INQUIRE_PROT_POLICY) command inquires about the policy, or policies, set on a queue.

Required parameters

generic-policy-name (MQCFST)

Policy name (parameter identifier: MQCA_POLICY_NAME).

This parameter is the name of the policy with attributes that are required. Generic policy names are supported. A generic name is a character string followed by an asterisk (*), for example ABC*, and it selects all policies having names that start with the selected character string. An asterisk on its own matches all possible names.

The policy name is always returned regardless of the attributes requested.

The name of the policy, or policies (or part of the policy name or names) to inquire are the same as the name of the queue, or queues, that the policies control.

The maximum length of the string is MQ_OBJECT_NAME_LENGTH.

Optional parameters

PolicyAttrs (MQCFIL)

Policy attributes (parameter identifier: MQIACF_POLICY_ATTRS). The attribute list might specify the following value on its own- default value if the parameter is not specified:

MQIACF_ALL

All attributes.

or a combination of the following:

MQCA_POLICY_NAME

Name of the policy.

MQIA_SIGNATURE_ALGORITHM

The digital signature algorithm.

MQIA_ENCRYPTION_ALGORITHM

The encryption algorithm.

MQCA_SIGNER_DN

The distinguished name of an authorized signer, or signers.

MQCA_RECIPIENT_DN

The distinguished name of an intended recipient, or recipients.

MQIA_TOLERATE_UNPROTECTED

Whether the policy is enforced or unprotected messages tolerated.

MQIA_KEY_REUSE_COUNT

The number of times that an encryption key can be re-used.

MQIACF_ACTION

The action taken on the command with regards to signer and recipient parameters.

Parent topic: Definitions of the Programmable Command Formats