gtpg2m1wGeneral Macros

EVNTC-Define Internal Event

This general macro is used to define for the control program a named event that can be waited on by this ECB and posted by other ECBs. This macro is used with the POSTC (see POSTC-Mark Event Completion) and the EVNWC macros (see EVNWC-Wait for Event Completion).

You can use the EVNTC, POSTC, EVNWC, and SAWNC macros to pass the contents of a core block from one ECB to another ECB.

Format




label
A symbolic name can be assigned to the macro statement.

LEVEL=Dx
A core block reference word and file address reference word (D0-DF). LEVEL and BLOCK are mutually exclusive.

BLOCK=address|(Ry)
If specified, it is the address of an area which contains the EVNTC parameters. The area should be formatted as defined by the data area EV0BK. BLOCK and LEVEL are mutually exclusive. If a register is specified, it must be R0-R7 or R14-R15.

TYPE
The type of event being defined. Refer to Entry Requirements for more information about the TYPE parameter.

CNT
Event is a counter type. Each POSTC issued will cause the specified count to be decremented by one. When the count becomes 0, the event will be marked complete.

MSK
Event is mask type. Each POSTC issued will contain a 16 bit mask which will be used to reset the EVNTC specified mask bits. When the event's mask is completely reset, the event will be marked complete.

CB
Event is core block oriented, implies count of 1. The first POSTC will cause the event to be marked complete.

LIST
Event is oriented around a list of specified values. Each POSTC macro that is issued will contain a value that will be used to post the corresponding value in the EVNTC macro specified list. When all values are posted in the event list, the event will be marked completed.
Note:
For TYPE=LIST, the BLOCK parameter must be specified.

NAME=Y|N
If specified as Y, the event name is supplied by the issuer in the file reference word for this level or in the area specified by the BLOCK parameter. If not specified, or given as 'N', a unique name is generated by the macro processor and returned in the file reference word for the level or in the area specified by the BLOCK parameter.

DUPNAM=label1
This must be specified if NAME=Y is given. This is the label to branch to if the specified name already exists in the event table.

TIMEOUT=n
If specified, the value in seconds an ECB can wait on the event before the event is assumed to be in error. The value may be specified either by a self-defining value (from 0 to 4096) or by a value in a register (from 0 to 32 768). If a value of 0 is specified, time-out is not performed. The default time-out is 180 seconds. If a register is specified, it must be R0-R7 or R14-R15.

STATE
Indicates valid states for time-out processing. The default value is NORM.

NORM
Event will have time-out processing only when in NORM state. During time out processing the count specified by TIMEOUT will be decremented by one provided that the system state is NORM. If the value of TIMEOUT becomes 0, the event is posted as having timed out, regardless of system state. NORM is the default.

1052
Event will timeout processing in all states with S-TIMERS on. During time out processing the count specified by TIMEOUT will be decremented by one. If the value of TIMEOUT becomes 0, then the event is posted as having timed out, regardless of system state.

Entry Requirements

Return Conditions

Programming Considerations

Examples