The Monitor Save While Active (MONSWABRM
) command monitors a save while active message queue for a message indicating the end of library synchronization. When the end of synchronization is detected, MONSWABRM
will run the specified command. The MONSWABRM
command can be used as an exit (*EXIT) special value in a control group during backup processing.
In IBM i release 6.1 and later, MONSWABRM
can be used to monitor for a save while active checkpoint message from one save or to monitor for multiple save while active checkpoint messages from multiple saves.
In IBM i release V5R4M0, MONSWABRM
will monitor for one save while active checkpoint message even when multiple saves are associated with the backup.
NOTES:
MONSWABRM
should not be used with backups that save multiple libraries (*ALLUSR, generic libraries, etc) when *LIB or *SYSDFN is specified for the Save active (SAVACT) parameter.MONSWABRM
.MONSWABRM
does not exist, BRMS will create the message queue and monitor for the checkpoint message. If BRMS does create the message queue, once the checkpoint message has been received and the specified command has been run or the wait time specified for the Time limit in seconds (WAITMSG) parameter has been exceeded, the message queue will be deleted.MONSWABRM
will not work with the following saves: MONSWABRM
to revert backup to the prior behavior of only monitoring for one checkpoint message even if there is more than one save associated with the backup see Allow MONSWABRM to monitor for one save-while-active checkpoint message - Q1ASYNCMSG.