Specify MSMQ name for writing job history log
$joblog_qname node qname [maxttr]
This command specifies the name of a private MSMQ queue to which messages will be written as each report is added to job instance history.
The parameters on this command are used as follows:
| node | the nodename of the machine which is to use this queue, or * for all nodes. To ensure that the queue is selected for machines which do not run COPIAFACTS so have no defined CopiaFacts nodename, either use * for this parameter or specify an empty nodename ("")for such nodes. |
| qname | the name of an existing private queue to which this node has permission to write. |
| maxttr | the maximum time to receive in hours. If omitted, the message will not expire. |
The content of messages is as follows:
| label | The pathname of the job instance log file, based on @FFBASE. |
| message | The text of the message, starting with a timestamp and the message reference number in square brackets. |
| message ID | the message reference number |
The message reference numbers are listed in Appendix J. Messages written relating to Job Preview processing will have MSMQ priority 6 (high); all other messages will have priority 0.
When using this command we recommend that you add a $system_dlls command with a keyword msmq to ensure that CF9MSMQ.DLL and the Windows MQRT.DLL are loaded.
Example:
$joblog_qname * MNAME\private$\copia_joblog 168 ; keep messages 1 week