gtpg2m3qGeneral Macros

SAWNC-Wait for Event Completion, Signal Aware

Use this general macro to wait for a named event to be completed. The SAWNC macro is similar to the EVNWC macro. However, if the caller of the SAWNC macro has to wait for an event to be completed, the caller can be interrupted by a signal. The SAWNC macro is used with the EVNTC and POSTC macros.

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

Format




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

TYPE
The type of event:

CNT
Count event.

MSK
Mask event.

CB
Core block type of event.

If TYPE=CB is coded, the LEVEL keyword must be specified and the BLOCK keyword can also be specified. If the BLOCK keyword is specified, the event name is retrieved from the area specified by the BLOCK keyword, and the error code, if 1, is returned in the area specified by the BLOCK keyword.

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

LEVEL=Dx
The data level of a core block reference word (CBRW) and file address reference word (FARW). Valid values are D0-DF. The FARW contains the symbolic name of the event. The LEVEL and BLOCK keywords are mutually exclusive except when CB is specified for the TYPE keyword.

BLOCK=label1
An area formatted as defined by the EV0BK DSECT that contains the name of the event. Other fields defined by the EV0BK DSECT are used to return values from the completed event. The LEVEL and BLOCK keywords are mutually exclusive except when CB is specified for the TYPE keyword.

ERROR=label2
A label where control is passed if the event ends with an error.

NFOUND=label3
A label where control is passed if the event does not exist.

EINTR=label4
The label of an instruction to be given control if SAWNC macro processing is interrupted by a signal.

Entry Requirements

Return Conditions

Programming Considerations

Examples

None.