All the parameters are optional. If none are specified, the current active
log data sets are switched and off-loaded immediately.
- CANCEL OFFLOAD
- Cancels any off-loading currently in progress and restarts the off-load
process. The process starts with the oldest active log data set and proceeds
through all the active data sets that need off-loading.
Use this command
only if the off-load task does not appear to be working, or if you want to
restart a previous off-load attempt that failed.
- CMDSCOPE
- This parameter specifies how the command is executed when the queue
manager is a member of a queue-sharing group.
CMDSCOPE cannot be used for
commands issued from the first initialization input data set CSQINP1.
- ' '
- The command is executed on the queue manager on which it was entered.
This is the default value.
- qmgr-name
- The command is executed on the queue manager you specify, providing
the queue manager is active within the queue-sharing group.
You can specify
a queue manager name, other than the queue manager on which the command was
entered, only if you are using a queue-sharing group environment and if the
command server is enabled.
- MODE(QUIESCE)
- Stops any new update activity on the queue manager, and brings all existing
users to a point of consistency after a commit. When this state is reached,
or the number of active users is zero, the current active log is archived.
The time that the queue manager waits to reach such a state is limited
to the value specified by QUIESCE in the CSQ6ARVP system parameter macro.
The value of QUIESCE can be overridden by the TIME parameter of this command.
If activity has not quiesced in that time, the command fails; no off-load
is done, and logging continues with the current active log data set.
- TIME(nnn)
- Overrides the quiesce time period specified by the QUIESCE value of
the CSQ6ARVP system parameter macro.
nnn is the time, in seconds,
in the range 001 through 999.
To specify the TIME parameter, you must
also specify MODE(QUIESCE).
If you specify the TIME parameter, you
must specify an appropriate value for the quiesce period. If you make the
period too short or too long, one of the following problems might occur:
- The quiesce might not be complete
- WebSphere MQ lock contention might develop
- A timeout might interrupt the quiesce
- WAIT
- Specifies whether WebSphere MQ is to wait until the quiesce process has finished
before returning to the issuer of the ARCHIVE LOG command.
To specify the
WAIT parameter, you must also specify MODE(QUIESCE).
- NO
- Specifies that control is returned to the issuer when the quiesce process
starts. (The synonym is N.) This makes the quiesce process
asynchronous to the issuer; you can issue further MQSC commands when the
ARCHIVE LOG command returns control to you. This is the default.
- YES
- Specifies that control is returned to the issuer when the quiesce process
finishes. (The synonym is Y.) This makes the quiesce
process synchronous to the issuer; further MQSC commands are not processed
until the ARCHIVE LOG command finishes.