Add Service Table Entry (ADDSRVTBLE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Add Service Table Entry (ADDSRVTBLE) command is used to add a service entry to the service table. You can use the service table to manage the mapping of network services to ports and to record the protocols that the services use.
The service table is shipped with some standard port assignments. Values for common functions supported by Transmission Control Protocol/Internet Protocol (TCP/IP) 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 |
|---|---|---|---|
| SERVICE | Service | Character value | Required, Positional 1 |
| PORT | Port | 1-65535 | Required, Positional 2 |
| PROTOCOL | Protocol | Character value | Required, Positional 3 |
| TEXT | Text 'description' | Character value, *BLANK | Optional |
| ALIAS | Aliases | Single values: *NONE Other values (up to 4 repetitions): Character value, *NONE |
Optional |
| Top |
Service (SERVICE)
Specifies the network service to be added to the table. A service can be added to the table more than once. Each service must be uniquely identified by a combination of the port number and the protocol name parameters.
This is a required parameter.
- character-value
- Specify the name of the network service to be added.
| Top |
Port (PORT)
Specifies the port number to be assigned to the service.
This is a required parameter.
- 1-65535
- Specify the port number for the network service.
| Top |
Protocol (PROTOCOL)
Specifies the protocol that the service uses. You can specify a maximum of 32 characters for the protocol name. No checking is done to ensure that the protocol exists.
This is a required parameter.
- character-value
- Specify the name of the protocol that the network service uses.
| Top |
Text 'description' (TEXT)
Specifies text that briefly describes the network service 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 network service. You can specify a maximum of four aliases. No checking is done to ensure that an alias is unique.
Single values
- *NONE
- The service has no alternate name.
Other values (up to 4 repetitions)
- character-value
- Specify an alternate service name.
| Top |
Examples
ADDSRVTBLE SERVICE(FTP) PORT(21) PROTOCOL(TCP)
This command adds a service entry to the service table for the FTP network service. The service uses port 21 and the TCP protocol.
| Top |
Error messages
*ESCAPE Messages
- TCP290A
- Service entry already exists in table. Entry was not added.
- TCP2914
- Service entry contains characters that are not valid. Entry was not added.
- TCP8050
- *IOSYSCFG authority required to use &1.
| Top |