Home

 

Optional parameters

 

ChannelAttrs (MQCFIL)

Channel attributes (parameter identifier: MQIACF_CHANNEL_ATTRS).

The attribute list can specify the following on its own (this is the default value used if the parameter is not specified):

MQIACF_ALL

All attributes.

or a combination of the parameters in the following table:

Parameter Sender Server Receiver Request er Client conn Server conn Cluster sender Cluster receiver
MQCA_ALTERATION_DATE

Date on which the definition was last altered

X X X X X X X X
MQCA_ALTERATION_TIME

Time at which the definition was last altered

X X X X X X X X
MQCA_CLUSTER_NAME

Name of local queue manager

            X X
MQCA_CLUSTER_NAMELIST

Name of local queue manager

            X X
MQCA_Q_MGR_NAME

Name of local queue manager

        X      
MQCACH_CHANNEL_NAME

Channel name. We cannot use this attribute as a filter keyword.

X X X X X X X X
MQCACH_CONNECTION_NAME

Connection name

X X   X X   X X
MQCACH_DESC

Description

X X X X X X X X
MQCACH_LOCAL_ADDRESS

Local communications address for the channel

X X   X X   X X
MQCACH_MCA_NAME

Message channel agent name

X X   X     X  
MQCACH_MCA_USER_ID

MCA user identifier

X X X X   X X X
MQCACH_MODE_NAME

Mode name

X X   X X   X X
MQCACH_MR_EXIT_NAME

Message-retry exit name

    X X       X
MQCACH_MR_EXIT_USER_DATA

Message-retry exit name

    X X       X
MQCACH_MSG_EXIT_NAME

Message exit name

X X X X     X X
MQCACH_MSG_EXIT_USER_DATA

Message exit user data

X X X X     X X
MQCACH_PASSWORD

Password

X X   X X   X  
MQCACH_RCV_EXIT_NAME

Receive exit name

X X X X X X X X
MQCACH_RCV_EXIT_USER_DATA

Receive exit user data

X X X X X X X X
MQCACH_SEC_EXIT_NAME

Security exit name

X X X X X X X X
MQCACH_SEC_EXIT_USER_DATA

Security exit user data

X X X X X X X X
MQCACH_SEND_EXIT_NAME

Send exit name

X X X X X X X X
MQCACH_SEND_EXIT_USER_DATA

Send exit user data

X X X X X X X X
MQCACH_SSL_CIPHER_SPEC

SSL cipher spec

X X X X X X X X
MQIACH_SSL_CLIENT_AUTH

SSL client authentication

X X X X   X   X
MQCACH_SSL_PEER_NAME

SSL peer name

X X X X X X X X
MQCACH_TP_NAME

Transaction program name

X X   X X X X X
MQCACH_USER_ID

User identifier

X X   X X   X  
MQCACH_XMIT_Q_NAME

Transmission queue name

X X            
MQIA_MONITORING_CHANNEL

Online monitoring data collection

X X X X   X X X
MQIA_STATISTICS_CHANNEL

Online statistics collection

X X X X     X X
MQIACH_BATCH_HB

Value to use for batch heartbeating

X X         X X
MQIACH_BATCH_INTERVAL

Batch wait interval (seconds)

X X         X X
MQIACH_BATCH_SIZE

Batch size

X X X X     X X
MQIACH_CHANNEL_TYPE

Channel type

X X X X X X X X
MQIACH_CLWL_CHANNEL_ PRIORITY

Cluster workload channel priority

            X X
MQIACH_CLWL_CHANNEL_RANK

Cluster workload channel rank

            X X
MQIACH_CLWL_CHANNEL_ WEIGHT

Cluster workload channel weight

            X X
MQIACH_DATA_CONVERSION

Whether sender should convert application data

X X         X X
MQIACH_DISC_INTERVAL

Disconnection interval

X X       X X X
MQIACH_HB_INTERVAL

Heartbeat interval (seconds)

X X X X X X X X
MQIACH_HDR_COMPRESSION

List of header data compression techniques supported by the channel

X X X X X X X X
MQIACH_KEEP_ALIVE_INTERVAL

KeepAlive interval

X X X X X X X X
MQIACH_LONG_RETRY

Long retry count

X X         X X
MQIACH_LONG_TIMER

Long timer

X X         X X
MQIACH_MAX_MSG_LENGTH

Maximum message length

X X X X X X X X
MQIACH_MCA_TYPE

MCA type

X X   X     X X
MQIACH_MR_COUNT

Message retry count

    X X       X
MQIACH_MSG_COMPRESSION

List of message data compression techniques supported by the channel

X X X X X X X X
MQIACH_MR_INTERVAL

Message retry interval (milliseconds)

    X X       X
MQIACH_NPM_SPEED

Speed of nonpersistent messages

X X X X     X X
MQIACH_PUT_AUTHORITY

Put authority

    X X   X   X
MQIACH_SEQUENCE_NUMBER_ WRAP

Sequence number wrap

X X X X     X X
MQIACH_SHORT_RETRY

Short retry count

X X         X X
MQIACH_SHORT_TIMER

Short timer

X X         X X
MQIACH_XMIT_PROTOCOL_TYPE

Transport (transmission protocol) type

X X X X X X X X

ChannelType (MQCFIN)

Channel type (parameter identifier: MQIACH_CHANNEL_TYPE).

If this parameter is present, eligible channels are limited to those of the specified type. Any attribute selector specified in the ChannelAttrs list which is only valid for channels of a different type or types is ignored; no error is raised.

If this parameter is not present (or if MQCHT_ALL is specified), channels of all types are eligible. Each attribute specified must be a valid channel attribute selector (that is, it must be one of those in the following list), but it might not be applicable to all (or any) of the channels actually returned. Channel attribute selectors that are valid but not applicable to the channel are ignored, no error messages occur, and no attribute is returned.

The value can be:

MQCHT_SENDER

Sender.

MQCHT_SERVER

Server.

MQCHT_RECEIVER

Receiver.

MQCHT_REQUESTER

Requester.

MQCHT_SVRCONN

Server-connection (for use by clients).

MQCHT_CLNTCONN

Client connection.

MQCHT_CLUSRCVR

Cluster-receiver.

MQCHT_CLUSSDR

Cluster-sender.

MQCHT_ALL

All types.

The default value if this parameter is not specified is MQCHT_ALL.

If this parameter is present, it must occur immediately after the ChannelName parameter on platforms other than z/OS. Failure to do this can result in a MQRCCF_MSG_LENGTH_ERROR error message.

CommandScope (MQCFST)

Command scope (parameter identifier: MQCACF_COMMAND_SCOPE). This parameter applies to z/OS only.

Specifies how the command is executed when the queue manager is a member of a queue-sharing group. You can specify one of the following:

  • blank (or omit the parameter altogether). The command is executed on the queue manager on which it was entered.

  • a queue manager name. The command is executed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, be using a queue-sharing group environment, and the command server must be enabled.

  • an asterisk (*). The command is executed on the local queue manager and is also passed to every active queue manager in the queue-sharing group.

The maximum length is MQ_QSG_NAME_LENGTH.

We cannot use CommandScope as a parameter to filter on.

IntegerFilterCommand (MQCFIF)

Integer filter command descriptor. The parameter identifier must be any integer type parameter allowed in ChannelAttrs except MQIACF_ALL. Use this to restrict the output from the command by specifying a filter condition. See MQCFIF - PCF integer filter parameter for information about using this filter condition.

If you specify an integer filter for channel type, we cannot also specify the ChannelType parameter.

If you specify an integer filter, we cannot also specify a string filter using the StringFilterCommand parameter.

QSGDisposition (MQCFIN)

Disposition of the object within the group (parameter identifier: MQIA_QSG_DISP). This parameter applies to z/OS only.

Specifies the disposition of the object for which information is to be returned (that is, where it is defined and how it behaves). The value can be:

MQQSGD_LIVE

The object is defined as MQQSGD_Q_MGR or MQQSGD_COPY. This is the default value if the parameter is not specified.

MQQSGD_ALL

The object is defined as MQQSGD_Q_MGR or MQQSGD_COPY.

If there is a shared queue manager environment, and the command is being executed on the queue manager where it was issued, this option also displays information for objects defined with MQQSGD_GROUP.

If MQQSGD_LIVE is specified or defaulted, or if MQQSGD_ALL is specified in a shared queue manager environment, the command might give duplicated names (with different dispositions).

MQQSGD_COPY

The object is defined as MQQSGD_COPY.

MQQSGD_GROUP

The object is defined as MQQSGD_GROUP. This is permitted only in a shared queue environment.

MQQSGD_Q_MGR

The object is defined as MQQSGD_Q_MGR.

MQQSGD_PRIVATE

The object is defined as either MQQSGD_Q_MGR or MQQSGD_COPY. Note that MQQSGD_PRIVATE returns the same information as MQQSGD_LIVE.

We cannot use QSGDisposition as a parameter to filter on.

StringFilterCommand (MQCFSF)

String filter command descriptor. The parameter identifier must be any string type parameter allowed in ChannelAttrs except MQCACH_CHANNEL_NAME and MQCACH_MCA_NAME. Use this to restrict the output from the command by specifying a filter condition. See MQCFSF - PCF string filter parameter for information about using this filter condition.

If you specify a string filter, we cannot also specify an integer filter using the IntegerFilterCommand parameter.

 

Parent topic:

Inquire Channel


pc12170_


 

Home