dspmqfls (display file names)

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:

1. The dspmqfls command displays the name of the directory containing the queue, not the name of the queue itself.
2. 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

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*