|
|
|
The &SNAMS RECEIVE_NOTIFY verb notifies the procedure when data is available to be received.
This option is an asynchronous request which enables the procedure to continue execution and is notified of data arrival by a notification event being queued to the internal environment of the procedure. This request returns no data. When the notify event is received the &SNAMS RECEIVE request is used to access any data that arrived.
This verb has the following format:
&SNAMS RECEIVE_NOTIFY [ ID=requestid ]
Operands:
(Optional) Specifies the message identifier.
When omitted, SNAMS issues a notification for the first MDS-MU received on behalf of this NCL process.
If supplied, it is the request identifier for an outstanding &SNAMS SEND request or the registration identifier of an application registration. Both of these identifiers are returned in the &ZSNAMID system variable after their respective &SNAMS requests.
Return Codes:
|
&RETCODE |
&ZFDBK |
Meaning |
|---|---|---|
|
0 |
0 |
Request successful |
|
4 |
0 |
Request cannot be satisfied - no outstanding request |
Notes:
This verb affects outstanding &SNAMS RECEIVE_NOTIFY requests in one of the following ways:
Thus at any instance, either multiple RECEIVE_NOTIFY requests for specific messages, or a single nonspecific RECEIVE_NOTIFY request is outstanding. When the request is satisfied the following message is placed on the request queue of the internal environment for the NCL procedure:
N00101 NOTIFY: SNAMS EVENT: RECEIVE RESOURCE: &ZSNAMID
where the value &ZSNAMID is the message identifier, that is, the request identifier for an outstanding &SNAMS SEND request, or the registration identifier of the destination application.
| Copyright © 2009 CA. All rights reserved. |
|