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:
- You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
| 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 |