Add Protocol Table Entry (ADDPCLTBLE)

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

The Add Protocol Table Entry (ADDPCLTBLE) command is used to add a protocol entry to the protocol table. You can use the protocol table to manage a list of protocols used in the Internet. The Internet is a collection of networks functioning as a single, cooperative, and virtual network using Transmission Control Protocol/Internet Protocol (TCP/IP) to support peer-to-peer connectivity.

The protocol table is shipped with a list of some valid protocols. Current protocol values are available to the Internet community in the assigned numbers RFC (Request for Comments) document, a formal specification of proposals and standards for a portion of TCP/IP.

Restrictions:

Top

Parameters

Keyword Description Choices Notes
PROTOCOL Protocol Character value Required, Positional 1
PCLNBR Protocol number Integer Required, Positional 2
TEXT Text 'description' Character value, *BLANK Optional
ALIAS Aliases Single values: *NONE
Other values (up to 4 repetitions): Character value, *NONE
Optional
Top

Protocol (PROTOCOL)

Specifies the protocol to be added to the table. A protocol can be added to the table only once.

character-value
Specify the protocol name.
Top

Protocol number (PCLNBR)

Specifies the number that represents the protocol.

integer
Specify the protocol number.
Top

Text 'description' (TEXT)

Specifies text that briefly describes the protocol entry.

*BLANK
Text is not specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.
Top

Aliases (ALIAS)

Specifies the alternate name for the protocol. You can specify a maximum of 4 aliases. No checking is done to ensure that an alias is unique.

Single values

*NONE
The protocol has no alternate name.

Other values (up to 4 repetitions)

character-value
Specify an alternate protocol name.
Top

Examples

ADDPCLTBLE   PROTOCOL(TCP)  PCLNBR(6)

This command adds an entry for the TCP protocol to the protocol table. The protocol number for the TCP entry is 6.

Top

Error messages

*ESCAPE Messages

TCP290B
Protocol entry already exists in table. Entry was not added.
TCP2915
Protocol entry contains characters that are not valid. Entry was not added.
TCP8050
*IOSYSCFG authority required to use &1.
Top