INSTANCE parameter supported on the Start TCP/IP Server (STRTCPSVR) and End TCP/IP Server (ENDTCPSVR) commands for SERVER(*ONDMD) at server version 8.4.0.3

Technote (FAQ)


Question

Can you use the INSTANCE parameter on the Start TCP/IP Server (STRTCPSVR) and End TCP/IP Server (ENDTCPSVR) commands to start and end IBM Content Manager OnDemand servers for Common Server?

Answer

As of Content Manager OnDemand server version 8.4.0.3, the INSTANCE parameter of the Start TCP/IP Server (STRTCPSVR) and End TCP/IP Server (ENDTCPSVR) commands is supported when you specify SERVER(*ONDMD). The 8.4.0.3 server PTFs for Content Manager OnDemand for i5/OSversion 6.1 are SI34061, SI34058, and SI34057 or their superseding PTFs.
STRTCPSVR

Previously, when the STRTCPSVR SERVER(*ONDMD) command was issued, all instances that were set to autostart were started. (Note that an instance is set to autostart if the ars.cfg file for that instance contains ARS_AUTOSTART_INSTANCE=1.) After you install the 8.4.0.3 server PTFs, the INSTANCE parameter allows the special values *DFT, *ALL, *AUTOSTART, or the specification of the name of an instance.

The default value for the INSTANCE parameter is *DFT. The 8.4.0.3 server PTFs also provide the option of creating a data area to further control the behavior of the STRTCPSVR command. The following table shows the specific behavior of the command based on the value you specify and whether or not the optional data area exists.



STRTCPSVR
SERVER(*ONDMD)

INSTANCE(*DFT)

INSTANCE(*ALL)

INSTANCE
(*AUTOSTART)

INSTANCE
(instancename)

Without the data area

All instances set to autostart are started

All instances configured on the system are started

All instances set to autostart are started

The named instance is started

With the data area

Only the instance named in the data area is started

All instances configured on the system are started

All instances set to autostart are started

The named instance is started

Without the data area

Without the data area, the values of *DFT and *AUTOSTART work identically, namely, all instances that are set to autostart are started. If you use the special value *ALL, all instances that are configured on the system will start. You can also specify the name of a single instance to start. For example, you can use: STRTCPSVR SERVER (*ONDMD) INSTANCE(ONDTEST) to start an instance named ONDTEST.

With the data area

With the data area, the value of *DFT will only start the instance that is named in the data area. The data area must be named STRTCPSVR and located in library QUSRRDARS. The data area should be a character (*CHAR) type data area with a length of 10. To create the data area, use the command:
CRTDTAARA DTAARA (QUSRRDARS/STRTCPSVR) TYPE(*CHAR) LEN(10) VALUE(instancename) TEXT('Autostart instance name for STRTCPSVR *ONDMD *DFT')  where instancename is the name of the instance you want to start when you use *DFT.

The special values *ALL and *AUTOSTART and specifying an instance name work the same with the data area as without the data area.

Which instances autostart?

How can you tell which instances will be started when STRTCPSVR SERVER(*ONDMD) INSTANCE(*AUTOSTART) is run? If ARS_AUTOSTART_INSTANCE=1 in the ars.cfg file for the instance, the instance will automatically start. But, if you would rather not have to view the ars.cfg file for every instance, you can use the grep command in QSHELL to search the contents of all the ars.cfg files for the string ARS_AUTOSTART_INSTANCE=1.

Start QSHELL with the qsh command on the command line. Then, issue the grep command as shown in the first line of the following sample.

$
grep -n 'ARS_AUTOSTART_INSTANCE=1' /qibm/userdata/ondemand/*/ars.cfg
/qibm/userdata/ondemand/ONDDEMO/ars.cfg:53:ARS_AUTOSTART_INSTANCE=1
/qibm/userdata/ondemand/ONDDEU/ars.cfg:53:ARS_AUTOSTART_INSTANCE=1
/qibm/userdata/ondemand/ONDENU/ars.cfg:53:ARS_AUTOSTART_INSTANCE=1
/qibm/userdata/ondemand/QUSROND/ars.cfg:53:ARS_AUTOSTART_INSTANCE=1
$

From the output of this command, you can determine that instances ONDDEMO, ONDDEU, ONDENU, and QUSROND will be started when STRTCPSVR SERVER(*ONDMD) INSTANCE(*AUTOSTART) is executed.


ENDTCPSVR

Previously, when the ENDTCPSVR SERVER(*ONDMD) command was issued, all instances that were active were ended. After you install the 8.4.0.3 server PTFs, the INSTANCE parameter allows the special values *DFT, *ALL, or the name of an instance.

The default value for the INSTANCE parameter is *DFT. The server upgrade PTFs also provide the option of creating a data area to further control the behavior of the ENDTCPSVR command. The following table shows the specific behavior of the command, based on the value you specify and whether or not the optional data area exists.



ENDTCPSVR
SERVER(*ONDMD)

INSTANCE(*DFT)

INSTANCE(*ALL)

INSTANCE
(instancename)

Without the data area

All active instances are ended

All active instances are ended

The named instance is ended

With the data area

Only the instance named in the data area is ended

All active instances are ended

The named instance is ended


Without the data area

Without the data area, the values of *DFT and *ALL work identically, namely, all instances that are active are ended. You can also specify the name of a single instance to end. For example, you can enter ENDTCPSVR SERVER(*ONDMD) INSTANCE(ONDTEST) to end an instance named ONDTEST.

With the data area

With the data area, the value of *DFT will only end the instance that is named in the data area. The data area must be named STRTCPSVR and located in library QUSRRDARS. See the preceding section for the specifics of the data area and an example command to create it. 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.

Rate this page:

(0 users)Average rating

Document information


More support for:

Content Manager OnDemand for i
Common Server

Software version:

6.1

Operating system(s):

i5/OS

Reference #:

1372886

Modified date:

2009-03-19

Translate my page

Machine Translation

Content navigation