STRDMUDP - Start UDP Listener

Use this command to start the UDP listener job (UDPLISTEN). The UDPLISTEN listener job supports auto-discovery.

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. The UDPLISTEN listener job responds to communications from Access Server.

You can start the UDPLISTEN listener job together with the TCPLISTEN listener job using the STRDMTCP command.

Applies To—Source and Target

Parameters

Table 1. Supported keywords
Keyword	Description	Choices	Notes
UDPSERVICE	Service name	‘dmirror', `Name`	Optional
TCPSERVICE	Service name	`Name`	Optional
ACPORT	Port number	10101, `Number`	Optional
JOBD	Job description	LIBL, CURLIB	Optional

Service name (UDPSERVICE)

The name of the service that was defined in the TCP/IP service table for the UDPLISTEN listener job.

The default setting is ‘dmirror'.

Name: Specifies the service name.; This parameter is case-sensitive and must be enclosed in single quotation marks.; The default setting is ‘dmirror'.

Service name (TCPSERVICE)

The name of the service that was defined in the TCP/IP service table for the TCPLISTEN listener job.

Name: Specifies the service name.; This parameter is case-sensitive and must be enclosed in single quotation marks.

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 in a STRDMTCP command invocation is set to *YES.

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

Job description (JOBD)

The name of the job description that you want to associate with the UDPLISTEN listener job and all jobs started by the UDPLISTEN listener job. The job description that you specify is used only if you are using this command to start the UDPLISTEN listener job. If you use the STRDMTCP command to start the UDPLISTEN listener job, then the value that you specified for the JOBD parameter in the STRDMTCP command is used instead.

The default setting is DMCJOBD

Job Description Library The name of the library where the job description is located 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.

Result

Messages are placed in the Event Log.

Examples

STRDMUDP

The TCP/IP service table entry for the TCPLISTEN and UDPLISTEN listener jobs is dmirror. The port number on the Access Server that is used to receive UDPLISTEN broadcasts is 10101. The job description for the UDPLISTEN listener job is the first occurrence of the CDC Replication job description (DMCJOBD) in the library list.

STRDMUDP ACPORT(45454)
JOBD(*CURLIB/JOBD1)

The TCP/IP service table entry for the TCPLISTEN and UDPLISTEN listener jobs is dmirror. The port number on the Access Server that is used to receive UDPLISTEN broadcasts is 45454. The job description for the UDPLISTEN listener job is JOBD1, which is located in the current library.

STRDMUDP UDPSERVICE(‘tsmir')
TCPSERVICE('srvc1') ACPORT(10101) JOBD(SUBLIB/JOBD1)

The TCP/IP service table entry for the UDPLISTEN listener job is tsmir. The TCP/IP service table entry for the TCPLISTEN listener job is srvc1. The port number on the Access Server that is used to receive UDPLISTEN broadcasts is 10101. The job description for the UDPLISTEN listener job is JOBD1 in library SUBLIB.