The &SNAMS CANCEL verb cancels an outstanding MDS request. Effectively, an MDS error message is generated and sent to the responder, indicating that the requester no longer requires a reply.
All MDS replies already received by SNAMS on behalf of the canceled request are discarded. The senders of these messages are not informed of this situation.
This verb has the following format:
&SNAMS CANCEL ID=requestid
Operands:
Specifies the identifier of the outstanding request to cancel. Its value was returned in the &ZSNAMID variable when the outstanding MDS request was issued using the &SNAMS SEND verb.
Return Codes:
|
&RETCODE |
&ZFDBK |
Meaning |
|---|---|---|
|
0 |
0 |
Request canceled, no MDS replies |
|
|
1 |
Request canceled, MDS replies discarded |
|
4 |
0 |
Not an outstanding request, no MDS replies |
|
|
1 |
Not an outstanding request, MDS replies discarded |
For &RETCODE 0, an MDS error is sent to the responder.
| Copyright © 2009 CA. All rights reserved. |
|