&ZSNAMID

Returns an integer when using the &SNAMS verbs.

The integer returned is in the range 1 to 2,147,483,647 and is set following a successful &SNAMS REGISTER or &SNAMS SEND request.

It can subsequently be used on an &SNAMS RECEIVE request to indicate that only messages associated with that particular identifier (that is, the previous application registration, or the previous solicitation request) should satisfy the receive operation.

Its value is set following successful completion of various &SNAMS requests:

&SNAMS REGISTER: The integer returned is the registration identifier of the indicated application. This value is used on a subsequent &SNAMS DEREGISTER request to deregister the application. It may also be used on &SNAMS RECEIVE and RECEIVE_NOTIFY requests to target messages designated for the registered application.
&SNAMS SEND: &SNAMID is set only if the MDS-MU sent is a solicited request expecting one or more MDS-MU replies. The integer returned represents the request identifier. It may be used on subsequent &SNAMS_RECEIVE and RECEIVE_NOTIFY requests to correlate received responses.
&SNAMS RECEIVE: The integer returned is the message identifier. If the message received is a response to an outstanding request, it corresponds to the request identifier of the initial MDS request. Otherwise it is the registration identifier of the destination application.

Example: &ZSNAMID

&SNAMS REGISTER APPL=USERAPPL        -* Register an MS application
&APPLID=&ZSNAMID                     -* Save its registration ID 
&SNAMS SEND MU=query                 -* Send an MDS request 
&REQID=&ZSNAMID                      -* Save the request ID 
&SNAMS RECEIVE MU=response ID=&REQID -* Receive the response
&SNAMS RECEIVE MU=MSU ID=&APPLID     -* Receive an MDS-MU targeted
                                        at the registered application