dspmqfls (display files)

Purpose

Use the dspmqfls command to display the real file system name for all WebSphere MQ objects that match a specified criterion. You can use this command to identify the files associated with a particular object. This is useful for backing up specific objects. See Understanding WebSphere 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 a wild card character * 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.

	* or all	All object types; this is the default
	q or queue	A queue or queues matching the object name parameter
	ql or qlocal	A local queue
	qa or qalias	An alias queue
	qr or qremote	A remote queue
	qm or qmodel	A model queue
	qmgr	A queue manager object
	prcs or process	A process
	ctlg or catalog	An object catalog
	nl or namelist	A namelist
	authinfo	Authentication information, for use with Secure Sockets Layer (SSL) channel security

Notes:

1. The dspmqfls command displays the name of the directory containing the queue, not the name of the queue itself.

2. In WebSphere MQ for UNIX systems, you need to prevent the shell from interpreting the meaning of special characters, for example, *. The way you do this depends on the shell you are using, but might involve the use of single quotation marks, double quotation marks, or a backslash.

Return codes

Examples

1. The following command displays the details of all objects with names beginning SYSTEM.ADMIN defined on the default queue manager.

   dspmqfls SYSTEM.ADMIN*
   

2. The following command displays file details for all processes with names beginning PROC defined on queue manager RADIUS.

   dspmqfls -m RADIUS -t prcs PROC*