LINC Programming Reference Manual - Public Support Login - Unisys

WAKE.UP (WU)
WAKE.UP (WU)
The WAKE.UP; command is used to reactivate a Report suspended by a SLEEP; or
CRITICAL.POINT; command. When a WAKE.UP; command is executed, a message is sent
to the specified Report (if it is not running, the message is discarded). If multiple copies of
the Report are running, each copy is sent a message. The WAKE.UP; command can be
executed from a Report.
Reports check for wake up messages when the following commands are executed:
$ SLEEP;
$ CRITICAL.POINT;
When WAKE.UP; Commands Are Not Sent
WAKE.UP; commands are not sent in the following circumstances:
$ If the nominated Report is not running, the message is discarded.
$ For an MCP based LINC System, the WAKE.UP; command is ignored in standalone
Reports and in LINC Reports generated as Coroutines. See the CALL; command for
details of Coroutines. .
$ For an MCP based LINC System, if the Report currently has 63 outstanding input
messages a WAKE.UP; command is not sent.
$ For a UNIX LINC System, each message is sent if there are sufficient message queue
resources to permit immediate queuing. Queues depend on user customization of the
host and the current resource utilization.
$ On all hosts, queued wake ups will not be recovered.
Passing Parameters
You can optionally specify a parameter of up to 254 characters, to be passed to the
specified Report with the WAKE.UP message. The parameter can be specified using a data
item name or literal. (In order to process the parameter data, the Report you are waking up
must have been generated with a dataname on the Report Options screen, to contain the
parameter data. For more details, see your LINC Generate Operations Guide.)
If a parameter is passed, the System Data item GLB.PARAMFLAG is automatically set to Y,
in the Report, to signal that there is parameter data included with the WAKE.UP;
command. GLB.PARAMFLAG is reset to the appropriate value (which depends on whether
data has been sent) at the next SLEEP; command or CRITICAL.POINT; command with
SLEEP; command option.
With the parameter you can also specify a data item to store the contents of GLB.STATUS.
GLB.STATUS is set to (*****) if data is being passed but there is no eligible target Report.
v 1-257