DROP command
Use the Drop Connection dialog to invoke the following z/OS Communications Server command: and receive output:
VARY TCPIP,tcpip_jobname,CMD=DROP,CONNECTION=connection_numberWhere tcpip_jobname is the TCP/IP subnode specified in the navigator view and connection_number is the unique hexadecimal number that identifies the connection with the TCP/IP stack. tcpip_jobname is determined from the context in which the command was issued (the selected TCP/IP subnode in the navigator view). The connection_number field is prefilled with the value specified for the Hex Connection Number attribute.
The z/OS(R) Communications Server drop command terminates a specific TCP/IP socket endpoint. When a drop command is issued against a socket endpoint, any outstanding or following socket calls that refer to the socket that is being dropped terminate with a negative return code. The socket endpoint that you drop can be a listening TCP server socket endpoint, a fully connected TCP socket (either server or client connection endpoint), or a UDP socket endpoint.
When you drop a TCP connection or UDP endpoint, the associated socket does not close. The application that owns the associated socket is responsible for closing the socket.
You will not be able to issue this command if your security access facility (SAF) program
(RACF(R), for example) has not been configured to grant your Tivoli Enterprise Portal
user ID access to the resources you are trying to DROP. For more information, see the section on
Loading the runtime libraries and completing the configuration
in the IBM® Z OMEGAMON® AI for Networks: Planning and Configuration
Guide.
This dialog has two areas: a command input area where you specify the characteristics of the command you want to issue and the command output area where the results of the command are displayed.
The fields in this dialog box are prefilled with the default values when the dialog is initialized. You can change the value of any modifiable field before invoking the command. Field-level validation is performed before command execution. You are prompted by the dialog to correct invalid data.
Click OK to issue the drop command for this subnode. Click Cancel to close the drop dialog. Click Help to invoke the online help.