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

Teradata® Unity™ User Guide

Product
Continuous Availability
Teradata Unity
Release Number
17.00
Published
September 2020
Language
English (United States)
Last Update
2020-09-15
dita:mapPath
fmz1594836948704.ditamap
dita:ditavalPath
qqk1595871525984.ditaval
dita:id
B035-2520
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