dspmqfls (display file names)
Display the file names corresponding to IBM® MQ objects.
Purpose
Use the dspmqfls command to display the real file system name for all IBM MQ objects that match a specified criterion. You can use this command to identify the files associated with a particular object. This command is useful for backing up specific objects. See Understanding IBM MQ file names for information about name transformation.
Syntax
Required parameters
- GenericObjName
- The name of the object. The name is a string with no flag and is a required parameter. Omitting the name returns an error.
This parameter supports an asterisk (*) as a wildcard at the end of the string.
Optional parameters
- -m QMgrName
- The name of the queue manager for which to examine files. If you omit this name, the command operates on the default queue manager.
- -t ObjType
- The object type. The following list shows the valid object types. The abbreviated name is shown first followed by the full name.
Table 1. Valid object types. Object Type Description * or all All object types; this parameter is the default authinfo Authentication information object, for use with TLS channel security channel or chl A channel clntconn or clcn A client connection channel catalog or ctlg An object catalog namelist or nl A namelist listener or lstr A listener process or prcs A process queue or q A queue or queues matching the object name parameter qalias or qa An alias queue qlocal or ql A local queue qmodel or qm A model queue qremote or qr A remote queue qmgr A queue manager object service or srvc A service
Note:
- The dspmqfls command displays the name of the directory containing the queue, not the name of the queue itself.
- On UNIX, you must prevent the shell from interpreting the meaning of special characters, for example, an asterisk (*). The way you do this depends on the shell you are using. It may involve the use of single quotation marks, double quotation marks, or a backslash.
Return codes
Return code | Description |
---|---|
0 | Command completed normally |
10 | Command completed but not entirely as expected |
20 | An error occurred during processing |
Examples
- The following command displays the details of all objects with names beginning
SYSTEM.ADMIN
defined on the default queue manager.dspmqfls SYSTEM.ADMIN*
- The following command displays file details for all processes with names beginning
PROC
defined on queue managerRADIUS
.dspmqfls -m RADIUS -t prcs PROC*