Set Log
The Set Log (MQCMD_SET_LOG) command on Multiplatforms enables you to notify the queue manager that archiving of a log is complete. If the log management type is not Archive the command fails. This command requires change authority on the queue manager object. This command is not valid on IBM i.
- Required parameters:
- ParameterType
- Optional parameters:
- Archive
Required parameters
- ParameterType (MQCFIN)
- Specifies the type of the log (parameter identifier: MQIACF_SYSP_TYPE).
The value must be MQSYSP_TYPE_SET
Optional parameters
- Archive (MQCFST)
- Specifies the log extent that is being marked as archived (parameter identifier:
MQCACF_ARCHIVE_LOG_EXTENT_NAME).
The command fails if the log extent is not recognized, or is the current log. The command does not fail if the extent has already been marked as having been archived.
A message is written to the error log if the queue manager is notified about an extent more than once.
Error codes
This command might return the following error codes in the response format header, in addition to the values shown at Error codes applicable to all commands.
- Reason (MQLONG)
- The value can be any of the following values:
- MQRCCF_LOG_EXTENT_NOT_FOUND
- The specified log extent was not found or is not valid.
- MQRCCF_CURRENT_LOG_EXTENT
- The specified log extent is the current log extent, and cannot have been validly archived yet.
- MQRCCF_LOG_TYPE_ERROR
- The command has been run on a log that is not an archive log.
- MQRCCF_LOG_EXTENT_ERROR
- The specified log extent is corrupt.
Parent topic: Definitions of the Programmable Command Formats