Purpose
Prevents a new session connection to an Endpoint. The command requires that you specify the name of the Endpoint to which new connections are disallowed. This command operation is asynchronous.
Syntax
ENDPOINT DISALLOW NEW CONNECTIONS endpoint_name ;Parameters
- endpointname
- Name of the Endpoint process.
Usage Considerations
This ENDPOINT DISALLOW NEW CONNECTIONS command instructs the specified Endpoint to stop listening for new connections. You can use the ENDPOINT STATUS command to view the status of global listeners on an Endpoint before disallowing connections. When you disallow connections, the Endpoint stops listening for default listeners and any defined SIP listeners. The command does not affect connections that are already open. When you are ready, use the ENDPOINT ALLOW NEW CONNECTIONS command to change the Endpoint status to receiving new connections again.
Example
This example command prevents any new sessions on the Endpoint named region1_ept.
unityadmin> ENDPOINT DISALLOW NEW CONNECTIONS region1_ept;
Request successfully sent to endpoint
Use the 'endpoint status' command to check the endpoint's status
unityadmin> ENDPOINT STATUS;
---------------------------------------------
Endpoint : region1_ept
Connected : yes
Global listen status : Listening disallowed
Listeners :
Host:Port : any:1025
Is SIP : no
Associated region : region1 (1)
State (Current) : Not Listening
State (Wanted) : Not Listening