CMPOST Function

The CMPOST function can be used to signal that an event has completed. The event in question is indicated via an Event Control Block (ECB) which must previously have been or is about to be the object of a CMWAIT or ROLEVT request for the application program waiting on the event to complete.

A program catalogued PV may post an ECB anywhere in the Com-plete address space. A program catalogued non PV may only post an ECB which is within a previously allocated COMSTOR area.

The format for the CMPOST function is:

CMPOST ( Return code , ECB , post code )
retcode A fullword containing the return code after Com-plete has processed the appropriate function.
ECB This is the address of the Event Control Block (ECB) to be posted active. Note that for the post to have any effect, another application must be waiting on the ECB in question.
post code This is the address of an optional fullword, the contents of which will be placed in the ECB when it has been posted active. This can be useful to determine what posted the ECB active if it can be posted from different parts of the system.
Return Codes
0 ECB posted successfully
4 Invalid parameter list supplied. The ECB in the list does not exist or is not fullword aligned
8 No COMSTOR available
12 ECB provided by non PV user was not in a COMSTOR area
Abends

There are no abends expected with the normal usage of this function.