Home

 

Parameter descriptions

 

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.

We 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, also specify MODE(QUIESCE).

If you specify the TIME parameter, 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; we 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.

 

Parent topic:

ARCHIVE LOG


sc10790_


 

Home