Stopping the servers

About this task

Servers are stopped using the ENDTCPSVR *ONDMD command. The instance parameter of the STRTCPSVR *ONDMD command supports the special values of *DFT and *ALL, as well as the specification of the name of an instance. The default value for the INSTANCE parameter is *DFT. You also have the option of creating a data area named STRTCPSVR to further control the behavior of the ENDTCPSVR command. Create the data area as previously described. See the Content Manager OnDemand for i: Common Server Administration Guide for more details about the data area. Note that, even though the data area is named STRTCPSVR, it controls both the STRTCPSVR and ENDTCPSVR commands. This is by design, so that *DFT starts and ends the same instance.

Without the STRTCPSVR data area, the values of *DFT and *ALL work identically. All instances that are active are ended. You can also specify the name of a single instance to end, for example: ENDTCPSVR SERVER(*ONDMD) INSTANCE(ONDTEST).

With the data area, the value of *DFT ends only the instance named in the data area. The data area must be named STRTCPSVR and located in library QUSRRDARS.

The following table summarizes the behavior of the ENDTCPSVR command with and without the STRTCPSVR data area.

Table 1. ENDTCPSVR command with and without STRTCPSVR data area
  *DFT *ALL Named instance
Without the data area, ENDTCPSVR ends: All active instances All active instances The named instance
With the data area, ENDTCPSVR ends: Only the instance named in the data area All active instances The named instance