evtsize

Defines the size of the HCL Workload Automation message files. This command is used by the HCL Workload Automation administrator either to increase the size of a message file after receiving the message, “End of file on events file.", or to monitor the size of the queue of messages contained in the message file.

Authorization

You must be maestro or root in UNIX™, or Administrator in Windows™ to run evtsize. Stop the HCL Workload Automation engine before running this command.

Syntax

evtsize -V | -U

evtsize file_name size

evtsize -compact file_name [size]

evtsize -show file_name

Arguments

-V: Displays the command version and exits.
-U: Displays command usage information and exits.
-compact file_name [size]: Reduces the size of the specified message file to the size occupied by the messages present at the time you run the command. You can optionally use this keyword to also specify a new file size.
-show file_name: Displays the size of the queue of messages contained in the message file
file_name: The name of the event file. Specify one of the following:
Courier.msg Intercom.msg Mailbox.msg PlanBox.msg Server.msg pobox/workstation.msg
size: The maximum size of the event file in bytes. When first built by HCL Workload Automation, the maximum size is set to 10 MB.
Note: The size of the message file is equal to or bigger than the real size of the queue of messages it contains and it progressively increases until the queue of messages becomes empty; as this occurs the message file is emptied.

Examples

To set the maximum size of the Intercom.msg file to 20 MB, run the following command:

evtsize Intercom.msg 20000000

To set the maximum size of the pobox file for workstation chicago to 15 MB, run the following command:

evtsize pobox\chicago.msg 15000000

The following command:

evtsize -show Intercom.msg

returns the following output:

HCL Workload Scheduler (UNIX)/EVTSIZE 9.4 (1.2.2.4) Licensed Materials - 
Licensed Materials - Property of IBM* and HCL**
5698-WSH
(C) Copyright IBM Corp. 1998, 2016 All rights reserved.
(C) Copyright HCL Technologies Ltd. 2016, 2024 All rights reserved
* Trademark of International Business Machines
** Trademark of HCL Technologies Limited
AWSDEK703I Queue size current 240, maximum 10000000 bytes (read 48, write 288)

where:

880: Is the size of the current queue of the Intercom.msg file
10000000: Is the maximum size of the Intercom.msg file
read 48: Is the pointer position to read records
write 928: Is the pointer position to write records