ENDPOINT DISALLOW NEW CONNECTIONS Command | unityadmin | Teradata Unity - ENDPOINT DISALLOW NEW CONNECTIONS - Teradata Unity

Teradata® Unity™ User Guide

Product
Teradata Unity
Release Number
16.51
Published
May 2020
Language
English (United States)
Last Update
2020-06-01
dita:mapPath
oic1588030762460.ditamap
dita:ditavalPath
ft:empty
dita:id
B035-2520
lifecycle
previous
Product Category
Analytical Ecosystem

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