STRDMTCP - Start CDC Replication TCP/IP communications

Use this command when you want CDC Replication to start the TCPLISTEN listener job. TCPLISTEN is the job running on the target and waits for incoming communication requests.

This must be started before communications can be made with the target using TCP/IP. Even though multiple TCPLISTEN listener jobs can be started on the same server, only one TCPLISTEN listener job can be running at any point in time within the same subsystem. You can issue this command once in each library containing a job description that refers to a unique subsystem. To run TCPLISTEN listener jobs concurrently on the same server, separate installations of CDC Replication are required. You can also use this command to enable auto-discovery. Auto-discovery is a way for an 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. This command can automatically start the UDPLISTEN listener job, which is used for autodiscovery.

You can issue the STRDMUDP command to start the UDPLISTEN listener job.

Applies To—Target

Parameters

Table 1. Supported keywords
Keyword	Description	Choices	Notes
SERVICE	Service table entry name	‘dmirror', `Name`	Optional
JOBD	Job description name	LIBL, CURLIB	Optional
HOST	Host name	' ', `Name`	Optional
AUTODISCOV	Auto-discovery status	NO, YES	Optional
ACPORT	Port number	10101, `Number`	Optional

Service table entry name (SERVICE)

The TCP/IP service table entry name that is used by CDC Replication for TCP/IP communications. This service table entry must not be used by another job. The TCPLISTEN listener job listens on the port that is associated with this entry in the TCP/IP service table. You must allocate an entry and unique port number in the TCP/IP service table before invoking this command. 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'.

Job description name (JOBD)

The name of the job description that you want to associate with both the TCPLISTEN and UDPLISTEN listener jobs.

The default setting is DMCJOBD.

You also need to specify the library where the job description resides. The library where the job description resides must precede the job description specification.

Specify the name of a library or one of the following values:

*LIBL: Specifies the set of libraries in your library list. The libraries are searched in order for the first occurrence of the specified job description.; This is the default setting.
*CURLIB: Specifies the current library.

Host name (HOST)

The host name or full IP address of the server where CDC Replication is running.

Name: Specifies the host name or full IP address.; The default setting is ‘ ‘ (a single blank character which indicates the local server)

Auto-discovery status (AUTODISCOV)

Indicates if autodiscovery is enabled or disabled.

You can also use this command to enable 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 auto-discovery is disabled.; This is the default setting.
*YES: Specifies that auto-discovery is enabled.; If you specify *YES, then a UDPLISTEN listener job with the same service name as the TCPLISTEN listener job is started. In the TCP/IP service table, you can distinguish between them by examining the protocol type setting (UDP versus TCP).; If you specify *YES, you then need to specify the ACPORT parameter.

Port number (ACPORT)

The port number on an Access Server that is used to receive broadcasts from the UDPLISTEN listener job.

This parameter is applicable only when the AUTODISCOV parameter is set to *YES. If you change the Access Server port numbers, you need to change this parameter setting as well.

Number: Specifies the port number.; The default setting is 10101.

Result

Messages are placed in the Event Log.

Examples

STRDMTCP

The TCP/IP service table entry for CDC Replication is dmirror. The job description for both the TCPLISTEN and UDPLISTEN listener jobs is the first occurrence of the CDC Replication job description (DMCJOBD) in the library list. This command starts the TCPLISTEN listener job on the local server.

STRDMTCP SERVICE(‘tsmir')
JOBD(SUBLIB/JOBD1) HOST(‘ ‘) AUTODISCOV(*YES) ACPORT(12121)

The TCP/IP service table entry for CDC Replication is tsmir. The job description for both the TCPLISTEN and UDPLISTEN listener jobs is JOBD1 in library SUBLIB. This command starts both the TCPLISTEN and UDPLISTEN listener jobs on the local server. The port number on the Access Server that is used to receive UDPLISTEN broadcasts is 12121.

STRDMTCP
JOBD(*CURLIB/JOBD1) HOST(SYS1) AUTODISCOV(*NO)

The TCP/IP service table entry for CDC Replication is dmirror. The job description for both the TCPLISTEN and UDPLISTEN listener jobs is JOBD1, which is located in the current library. This command starts the TCPLISTEN listener job on server SYS1.