mmwatch command

Lists the active watch folder watches for either a specific file system or all file systems.

Synopsis

mmwatch Device list [--events] [-Y]

or

mmwatch all list [--events] [-Y]

Availability

Available with IBM Spectrum Scale™ Advanced Edition or IBM Spectrum Scale Data Management Edition.

Description

Use the mmwatch command to list the active watch folder watches for either a specific file system or all file systems.

Remember: Start of changeTo use this command your cluster code level must be at IBM Spectrum Scale 5.0.2, and the file system on which the watch is set must also be to be at IBM Spectrum Scale 5.0.2.End of change

Parameters

Device
Lists the active watch folder watches for a specific file system.
all
Lists the active watch folder watches for all file systems.
--events
Lists the watch folder events for a specific file system.
list [-Y]
Displays the watch folder active watches details for the specified device. The -Y parameter provides output in machine-readable (colon-delimited) format.
Note: Fields that have a colon (:) are encoded to prevent confusion. For the set of characters that might be encoded, see the command documentation of mmclidecode. Use the mmclidecode command to decode the field.

Exit status

0
Successful completion.
nonzero
A failure occurs.

Security

You must have root authority to run the mmwatch command.

Example

To list the current watch folder watches that are running on file system gpfs1, use the following command: 
mmwatch gpfs1 list [-Y]
The following output is displayed: 
Filesystem gpfs1 has no watchers

Example

To list all current watch folder watches that are active, use this command: 
mmwatch demo list
The following output is displayed: 
Filesystem demo has 2 watcher(s):
  Watcher                                PID     Type       Start Time                Path
  -----------------------------------------------------------------------------------------------------
  node1.ibm.com                          7047    directory  Mon Aug 20 20:39:20 2018  /demo/somedir
  node2.ibm.com                          6225    directory  Tue Aug 21 10:45:05 2018  /demo

Example

To list all current watch folder watches with associated events, use this command: 
mmwatch demo list --events
The following output is displayed: 
Filesystem demo has 2 watcher(s):
  Watcher                                PID     Monitored Events
  ---------------------------------------------------------------------------------------
  node3.ibm.com                          7047    IN_CLOSE_WRITE,IN_DELETE_SELF
  node4.ibm.com                          6225    IN_ACCESS,IN_ATTRIB,IN_CLOSE_NOWRITE,
                                                 IN_CLOSE_WRITE,IN_CREATE,IN_DELETE,
                                                 IN_DELETE_SELF,IN_MODIFY,IN_MOVED_FROM,
                                                 IN_MOVE_SELF

See also

Location

/usr/lpp/mmfs/bin
Parent topic: Command reference