CHGRTDA (Change RouteD Attributes)

CHGRTDA Command syntax diagram

 

Purpose

The Change RouteD Attributes (CHGRTDA) command is used to change configurable Routing Information Protocol (RIP) server attributes. The changes take effect the next time the RouteD server is started either by the Start TCP/IP (STRTCP) command or by the Start TCP/IP Server (STRTCPSVR) command.

 

Restrictions

You must have *IOSYSCFG special authority to use this command.

 

Optional Parameters

AUTOSTART

Specifies whether to automatically start the RouteD server when TCP/IP is started by the STRTCP command. When RouteD is started by the STRTCPSVR command, the AUTOSTART parameter is ignored and the RouteD server is started regardless of the value of this parameter. If STRTCPSVR *ROUTED is specified, and the RouteD server is already running, then the start request will be denied.

*SAME: The AUTOSTART value does not change if it was previously set. Otherwise, *YES is used.

*YES: Initial setup to automatically start the RouteD server.

*NO: Do not automatically start the RouteD server.

SUPPLY

Specifies whether or not RouteD should supply routing information in RIP packets over the network interfaces.

*SAME: The supply option that was previously set does not change; otherwise, a value of *NO is used.

*NO: RouteD task receives and processes RIP packets normally, but does not supply periodic RIP broadcast packets to the attached networks. This value takes precedence over any supply values that may be set in the configuration file for a particular network interface.

*YES: RouteD task supplies periodic RIP broadcast packets to the attached networks. The supply of RIP packets over a particular interface may be overridden by an entry in the configuration file specifying that the supply over a particular interface is to be turned off.

Examples for CHGRTDA

Example 1: Changing the RouteD Attributes to Automatically Start the RouteD Server when the Start TCP/IP (STRTCP) CL command is issued.

CHGRTDA  AUTOSTART(*YES)

This command indicates that the next time the STRTCP command is issued to start up TCP/IP and to automatically start the TCP/IP applications, the RouteD server will be automatically started.

Example 2: Changing the RouteD Attributes to trace key actions by the RouteD server.

CHGRTDA  TRACE(*ACTIONS)

This command indicates that the trace option is active for logging key ACTIONS taken by the RouteD server. The logfile QATORLOG will be created if it does not exist or appended to if it does exist.

Error messages for CHGRTDA

*ESCAPE Messages

CPF0011

Error detected by prompt override program.

TCP5496

Error accessing configuration attributes member.

TCP5497

File &3, library &2 not found.

TCP8050

*IOSYSCFG authority required to use &1.

TCP9503

File &3 in library &2 not available.

*STATUS Messages

CPF5001

End of file &2 detected in library &3.