Sizing event files on USS

You can define the maximum size of the IBM Workload Scheduler event files by running the evtsize command from the BINDIR/bin directory on USS. Use this command to increase the size of an existing event file after receiving the message:

End of file on events files

In an IBM Workload Scheduler network, it might happen that an event file reaches its maximum size. If this happens during the distribution of the Symphony file, or just after a Symphony renew, a current plan extension or replan, the maximum size value changes automatically so that the distribution of Symphony can be completed without errors. At the end of this phase, you can use evtsize to reset the maximum size of the file manually.

Only a user with USS uid equal to 0, or the RACF® user associated with the server started task, can run this command. Be sure to stop the IBM Workload Scheduler engine before running this command.

evtsize -v | -u

evtsize filename size

evtsize -c filename size

evtsize -show filename

where:

-c

Compresses the filename event file and changes the maximum size value to a specified size. Use this option if the read pointer is greater than the write pointer, which denotes a file wrap condition. Otherwise, use:

evtsize filename size

to change the maximum size.

-u

Displays command usage information and exits.

-v

Displays the command version and exits.

filename

The name of the event file. Specify one of the following:

Courier.msg
Intercom.msg
Mailbox.msg
NetReq.msg
pobox/workstation.msg

size

The maximum size of the event file in bytes. When first built by the scheduler, the maximum size is set to 10 MB.

-show WRKDIR/filename

Queries the current queue length of the specified file.

The following example sets the maximum size of the pobox file for workstation FTW1 to 15 MB:

evtsize WRKDIR\pobox\FTW1.msg 15000000

The following example sets the maximum size of the pobox file for workstation FTW1 to 15 MB and compacts the file:

evtsize -c WRKDIR\pobox\FTW1.msg 15000000

The following example:

evtsize -show WRKDIR\Intercom.msg

returns the following output:

TWS for Windows NT/EVTSIZE 8.2 (1.2.2.2)
Licensed Materials Property of IBM
5698-WKB
(C) Copyright IBM Corp 1998,2001
US Government User Restricted Rights
Use, duplication or disclosure restricted by GSA ADP 
Schedule Contract with IBM Corp. 
AWS11140703 Queue size current 880, maximum 10000000 bytes
(read 48, write 928)

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