DISPLAY SMDS on z/OS

Use the MQSC command DISPLAY SMDS to display the parameters of existing IBM MQ shared message data sets associated with a specified application structure.

Use MQSC commands

For information on how we use MQSC commands, see Performing local administration tasks using MQSC commands.

We can issue this command from sources 2CR. For an explanation of the source symbols, see Use commands on z/OS®.

Syntax diagram
Parameter descriptions for DISPLAY SMDS
Usage notes for DISPLAY SMDSCONN

Synonym:

DISPLAY SMDS

)

CFSTRUCT(structure-name)

WHERE(FilterCondition)

ALL

requested attrs

Requested attrs

DSEXPAND1

Notes:

¹ For more information about this parameter, see Plan the coupling facility and offload storage environment.

Parameter descriptions for DISPLAY SMDS

The parameter descriptions for the DISPLAY SMDS command.

SMDS(qmgr-name|*)

Specifies the queue manager for which the shared message data set properties are to be displayed, or an asterisk to display the properties for all shared message data sets associated with the specified CFSTRUCT.

CFSTRUCT( structure-name )

Specify the coupling facility application structure for which the properties of one or more shared message data sets are to be displayed.

WHERE

Specify a filter condition to display only the SMDS information that satisfies the selection criterion of the filter condition. The filter condition is in three parts: filter-keyword, operator, and filter-value:

filter-keyword

Any parameter that can be used to display attributes for this DISPLAY command.

operator

This is used to determine whether a CF application structure satisfies the filter value on the given filter keyword. The operators are:

LT: Less than
GT: Greater than
EQ: Equal to
NE: Not equal to
LE: Less than or equal to
GE: Greater than or equal to
LK: Matches a generic string that you provide as a filter-value
NL: Does not match a generic string that you provide as a filter-value

filter-value

The value that the attribute value must be tested against using the operator. Depending on the filter-keyword, this can be:

An explicit value, that is a valid value for the attribute being tested.
We can use any of the operators except LK and NL. However, if the value is one from a possible set of values returnable on a parameter (for example, the value YES on the RECOVER parameter), we can only use EQ or NE.
A generic value. This is a character string (such as the character string you supply for the DESCR parameter) with an asterisk at the end, for example ABC*. The characters must be valid for the attribute you are testing. If the operator is LK, all items where the attribute value begins with the string (ABC in the example) are listed. If the operator is NL, all items where the attribute value does not begin with the string are listed. We cannot use a generic filter-value for parameters with numeric values or with one of a set of values.
We can only use operators LK or NL for generic values on the DISPLAY SMDS command.

ALL

Specify this keyword to display all attributes. If this keyword is specified, any attributes that are requested specifically have no effect; all attributes are still displayed.

This is the default behavior if we do not specify a generic name and do not request any specific attributes.

Requested parameters for DISPLAY SMDS

The following information is returned for each selected data set:

SMDS: The queue manager name which owns the shared message data set for which properties are being displayed.
CFSTRUCT: The coupling facility application structure name.
DSBUFS: Displays the override value for the number of buffers to be used by the owning queue manager for accessing shared message data sets for this structure, or DEFAULT if the group value from the CFSTRUCT definition is being used.
DSEXPAND: Displays the override value (YES or NO) for the data set expansion option, or DEFAULT if the group value from the CFSTRUCT definition is being used.