ENDDMTCP - End CDC Replication TCP/IP communications

Use this command to end a specific CDC Replication listener job.

You must issue this command from the same library that the Start CDC Replication (STRDMTCP) was issued to start the CDC Replication listener (TCPLISTEN) job. The CDC Replication listener serves all the incoming network requests from other servers running CDC Replication and from client workstations running Management Console applications.

Applies To—Target

Parameters

Table 1. Supported keywords
Parameter Description Choices Notes
ENDTYP End type *CNTRLD, Required
SERVICE Service table entry name ‘dmirror', Name Required
AUTODISCOV Auto-discovery status *NO, *YES Optional
JOBD Job description name *LIBL, *CURLIB Optional

End type (ENDTYP)

Indicates how you want CDC Replication to end TCP/IP communications.
*CNTRLD
Specifies that CDC Replication end the TCPLISTEN listener job after all current requests have been processed. This is the recommended setting for this parameter.
This is the default setting.

Service table entry name (SERVICE)

The name of the TCP/IP service table entry that CDC Replication uses for the TCPLISTEN listener job. CDC Replication stops the TCPLISTEN listener job on the port reserved by the TCP/IP service table entry. The service name is case-sensitive and must be enclosed in single quotation marks.
Name
Specifies the TCP/IP service table entry name.
The default setting is ‘dmirror'.

Auto-discovery status (AUTODISCOV)

Indicates if CDC Replication ends or continues with the UDPLISTEN listener job that terminates autodiscovery. Autodiscovery is a way for Access Server 10.2.1 and earlier to recognize, upon startup, all available replication agents on the local network so that you do not need to create each agent manually in Access Manager.
*NO
Specifies that CDC Replication continues the UDPLISTEN listener job and auto-discovery.
This is the default setting.
*YES
Specifies that CDC Replication ends the UDPLISTEN listener job and disables auto-discovery.

Job description name (JOBD)

The name of the job description that you want CDC Replication to associate with both the TCPLISTEN and UDPLISTEN listener jobs, and all jobs started by TCPLISTEN. By default, CDC Replication uses the job description DMCJOBD. You must specify the name of the library before the name of the job description.

Specify the library name or one of the following values:

*CURLIB
Specifies the current library.
*LIBL
Specifies the set of libraries in your library list. CDC Replication searches libraries in order of first occurrence of the specified job description.
This is the default setting.

Result

Messages are placed in the Event Log.

Examples

ENDDMTCP

CDC Replication stops the TCPLISTEN listener job in a controlled manner and uses the default settings for the TCP/IP service table entry, autodiscovery, and job description.

ENDDMTCP ENDTYP(*CNTRLD) SERVICE(‘tsmir') AUTODISCOV(*YES) JOBD(LIB1/JOB1)

CDC Replication stops TCPLISTEN listener job in a controlled manner. This job was using tsmir as the TCP/IP service table entry. CDC Replication also disables auto-discovery by stopping the UDPLISTEN listener job. Both listener jobs are using the job description JOB1 in the library LIB1.