emuoperations

emuoperations is a script used to execute scheduled operations.

A date and time specified in a Scheduled Operations record is the earliest that the operation will be run. The actual time at which an operation is run will depend on when the emuoperations script is scheduled to run. When run, emuoperations looks for any operations that were scheduled to run prior to the current date and time and commences them. Thus, if emuoperations is scheduled to run once per day, it will commence any operation scheduled to run in the previous 24 hours (in theory an operation could have been scheduled to run 23 hours and 59 minutes earlier). If emuoperations is to be run once per day, it probably makes sense therefore to schedule operations close to the time at which emuoperations is run. Alternatively, emuoperations can be run at various times throughout the day.

emuoperations may be used in two ways:

  1. Run all Scheduled Operations

    Usage: emuoperations

    Any Scheduled Operations required to be run will be executed. The current date and time is used to determine what operations are required. This form of the command is used by cron on a daily basis to ensure all Scheduled Operations for the given day are performed.

  2. Run a specific Scheduled Operation

    Usage:emuoperations -iirn

    The irn argument is the IRN of a Scheduled Operations record to be executed. This form of emuoperations is useful for testing new operations as it allows a specific operation to be run without waiting for the Scheduled Operations date and time to arrive.

The emuoperations script connects to an imuserver to perform the scheduled operations. This connection needs to be made on a specific port. By default the standard EMu configuration port for IMu is the port number 20000 greater than EMu's client connection port. For example, if the standard EMu client connection port is 20000, the standard imuserver connection port is 40000.

The emuoperations imuserver must run on a different port to perform the scheduled operations. The eoperations load starts the imuserver for handling operation requests. The port for emuoperations to connect on is defined by the EMUSERVERPORT environment variable plus 30000. EMUSERVERPORT is the port the EMu client uses to connect to the EMu server and corresponds to the Service value entered in the EMu Client login box.

It is recommended that the Administrator sets the EMUSERVERPORT environment variable in the etc/config file on the EMu server. Add the following text to the end of the etc/config file (if it does not exist already):

#
#  EMUSERVERPORT is the port the EMu client uses to connect to the EMu server.
#  The port corresponds to the "Service" value entered in the EMu Client Login box.
#
EMUSERVERPORT=port
export EMUSERVERPORT

where port is the service name used to connect to this EMu server.