Stopping TCP/IP/NJE Network Server *CANCEL,ntsvname

Function

Use the *CANCEL,ntsvname to cancel a Network Server (Netserv).

Note: You can also use the MVS™ CANCEL command (C ntsvname) to cancel a Netserv, but the JES3 cancel command is preferred. You should use the MVS command only when you cannot use the JES3 command.

Syntax


>>-+-*CANCEL-+--ntsvname---------------------------------------><
   '-*C------'

Parameters

ntsvname: Specifies the name of the Netserv to be canceled.

Rules

The Netserv must be defined and active.

Results

Both the TCP DSP and the Netserv address space are canceled.
Any sockets that were active on this Netserv are marked inactive. Server sockets, which are named @nnnnnnn, are automatically deleted when they become inactive.
Any sockets that were active on Netservs running on remote nodes, which were connected to this node, are also marked inactive. Server sockets on the remote node are also automatically deleted when they become inactive.
Any nodes connected by sockets to this Netserv are signed off and marked inactive.

Example

Issue the following command on NODE1:

*c jes3s1

The following response is received on NODE1:

SY1 IEESYSAS  IAZ0536I JES3S1 NJETCP SERVER RECEIVED A PURGE REQUEST
SY1 IEESYSAS  IAZ0543I JES3S1 S3 TCP/IP connection with IP Addr: alps4238.pok.ibm.com Port: 175 ended 
due to subtask goaway post
SY1 IEESYSAS  IAZ0543I JES3S1 S4 TCP/IP connection with IP Addr: alps4197.pok.ibm.com Port: 175 ended 
due to subtask goaway post
SY1 IEESYSAS  IAT9305 NODE NODE3    SIGNED OFF NETSERV JES3S1   SOCKET S3
SY1 IEESYSAS  IAT9305 NODE NODE4    SIGNED OFF NETSERV JES3S1   SOCKET S4
SY1 IEESYSAS  IEF404I IEESYSAS - ENDED - TIME=10.51.38
IAT9302 TCP DSP FOR SERVER JES3S1   HAS ENDED DUE TO ADDRESS SPACE END
IAT7450 JOB TCP      (JOB00738) PURGED
IAT7450 JOB IEESYSAS (JOB00739) PURGED

The following response is received on NODE3:

SY1 IEESYSAS  IAT9305 NODE NODE1    SIGNED OFF NETSERV JES3S3   SOCKET @0000001
SY1 IEESYSAS IAZ0544I JES3S3 NJE connection with IP Addr: alps4066.pok.ibm.com Port: 1029 ended 
on receiving a Signoff record from the remote node
SY1 IEESYSAS  *IAZ0537I JES3S3 NJETCP SERVER WAITING FOR WORK

The following response is received on NODE4:

SY1 IEESYSAS  IAT9305 NODE NODE1    SIGNED OFF NETSERV JES3S4   SOCKET @0000001
SY1 IEESYSAS IAZ0544I JES3S4 NJE connection with IP Addr: alps4066.pok.ibm.com Port: 1029 ended 
on receiving a Signoff record from the remote node
SY1 IEESYSAS  *IAZ0537I JES3S4 NJETCP SERVER WAITING FOR WORK