Verbs and Built-in Functions › &SNAMS DEREGISTER

&SNAMS DEREGISTER

The &SNAMS DEREGISTER verb deregisters a registered NCL application from SNAMS.

A registered NCL application uses this option to deregister itself from SNAMS. Consequently, it is no longer a valid destination for incoming MDS-MUs. Messages already received by the MDS Router on behalf of this application are discarded; the senders are not informed of this situation.

Deregistration also flushes active transactions for which the deregistered application is the responder. Partner applications are informed of this deregistration through an MDS error (sense code X'08A90003' for unit-of-work canceled).

If the application has registered interest in focal point updates with MS-CAPS (that is, it is an entry point application) or if it is registered as a focal point application, then deregistration signifies the end of such roles. Active entry point nodes are informed of the deregistration through an MDS error (sense code X'08A80003' for unknown application name).

This verb has the following format:

&SNAMS DEREGISTER 
     [ NAME=applicationname | ID=registrationid ]

Operands:

NAME=applicationname

Specifies the name of the application to deregister. The operand is not required but, if supplied, the ID= operand cannot be specified. If both NAME= and ID= operands are omitted, all applications registered by the requesting NCL process are deregistered.

Limit: 1 through 32 characters in length

ID=registrationid

Specifies the non-zero registration identifier returned in the &ZSNAMID system variable for the registered application. This operand is not required but, if supplied, the NAME= operand cannot be specified. If both NAME= and ID= operands are omitted, all applications registered by the requesting NCL process are deregistered.

Return Codes:

For &RETCODE 8, the &SYSMSG variable contains an error message.

Notes:

Deregistration can trigger the following EDS system configuration notification events:

• $$SNAMS.APPL.DEREGISTER

  This is always generated for application deregistration. The resources for this event are, respectively, the application routing name and the local node name.

• $$SNAMS.FP.INACTIVE.LOCAL

  This is generated if it was registered as a focal point application. The resources are respectively, the MS category and the focal point address.

• $$SNAMS.EP.INACTIVE

  This is generated for each entry point within the sphere of control of the local node for the MS category registered by the application. The resources are respectively the MS category and the entry point node name.

Processes that are profiled for the receipt of the events have the message N00102 queued to their response queues and accessible using the &INTREAD statement. The resources for this message are formatted as follows:

Application routing name, or MS category

Is a hexadecimal quoted string if it is an SNA-architected value, that is, a 4-byte value containing non-displayable characters (for example, '23F0F3F1'x). Otherwise, it is formatted as a text string (for example, USERAPPL).

Node name

Contains the network identifier and the NAU name, separated by a period (for example, NETID.NAUNAME).

Focal point address

Contains the network identifier, NAU name, and focal point application routing name, each separated by a period (for example, NETID.NAUNAME.'23F0F3F1'x).