Change RouteD Attributes (CHGRTDA)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

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.

Top

Parameters

Keyword Description Choices Notes
AUTOSTART Autostart *SAME, *YES, *NO Optional
SUPPLY Supply *SAME, *YES, *NO Optional
Top

Autostart (AUTOSTART)

Specifies whether to automatically start the RouteD server when TCP/IP is started by the STRTCP command or STRTCPSVR SERVER(*AUTOSTART). When RouteD is started by the STRTCPSVR command, but the SERVER(*AUTOSTART) parameter is omitted, the AUTOSTART parameter is ignored and the RouteD server is started regardless of the value of this parameter.

The possible values are:

*SAME
The AUTOSTART value does not change if it was previously set. Otherwise, it defaults to *NO.
*NO
Do not automatically start the RouteD server.
*YES
Start the RouteD server automatically.
Top

Supply (SUPPLY)

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

The possible values are:

*SAME
The supply option that was previously set does not change; otherwise, *NO is used.
*NO
The RouteD task receives and processes RIP packets normally, but does not supply periodic RIP broadcast packets over any of the attached network interfaces. This effectively puts the RouteD server into "listen mode."
*YES
The 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.
Top

Examples

Example 1: 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.

Top

Error messages

*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.
Top