CMPOST Function

#### Search Results

Search

# 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.