Previous Topic: &SMFWRITE

Next Topic: &SNAMS DEREGISTER


&SNAMS CANCEL

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:

ID=requestid

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.