Remove SMTP List Entry (RMVSMTPLE)

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

The Remove SMTP List Entry (RMVSMTPLE) command is used to remove elements from SMTP configuration lists. These lists may be enabled or disabled using the Change SMTP Attributes (CHGSMTPA) command or from the SMTP Properties panel in IBM i Navigator. The changes take effect the next time the SMTP server is started either by the Start TCP/IP (STRTCP) command or by the Start TCP/IP Server (STRTCPSVR) command.

Restrictions:

Top

Parameters

Keyword Description Choices Notes
TYPE List type *ACCEPT, *REJECT, *NEAR, *DOMAIN, *SVRBIND, *CLTBIND, *ETRNSVR, *FTRSUBJECT, *FTRORIGIN, *FTRFILNAME, *FTRTYPE, *HOSTAUTH, *ACCEPTIP6, *REJECTIP6, *DOMAINIP6, *SVRBNDIP6, *CLTBNDIP6 Required, Positional 1
INTNETADR Internet address Character value Optional
SUBNETMASK Subnet mask Character value, '255.255.255.255' Optional
HOSTNAME Host name Character value Optional
FTRDATA Filter data Character value Optional
IP6PFX IPv6 prefix Character value Optional
IP6NETADR IPv6 address Character value Optional
Top

List type (TYPE)

Specifies which list to remove the element from.

*ACCEPT
Removes the selected IPv4 item from the Accept Relay list. Parameters valid with this value are INTNETADR and SUBNETMASK.
*REJECT
Removes the selected IPv4 item from the Reject Relay list. Parameters valid with this value are INTNETADR and SUBNETMASK.
*NEAR
Removes the selected item from the Near Domain list. Parameter valid with this value is HOSTNAME.
*DOMAIN
Removes the selected IPv4 item from the Domains list. Parameters valid with this value are HOSTNAME, and INTNETADR.
*SVRBIND
Removes the selected IPv4 item from the Server Bind list. Parameter valid with this value is INTNETADR.
*CLTBIND
Removes the selected IPv4 item from the Client Bind list. Parameter valid with this value is INTNETADR.
*ETRNSVR
Removes the selected item from the ETRN Server list. Parameter valid with this value is HOSTNAME.
*FTRSUBJECT
Removes the selected item from the Subject comparison list. Parameter valid with this value is FTRDATA.
*FTRORIGIN
Removes the selected item from the Originator's address comparison list. Parameter valid with this value is FTRDATA.
*FTRFILNAME
Removes the selected item from the Filename / extension comparison list. Parameter valid with this value is FTRDATA.
*FTRTYPE
Removes the selected item from the Type / subtype comparison list. Parameter valid with this value is FTRDATA.
*HOSTAUTH
Removes the selected item from the Host logon comparison list. Parameter valid with this value is HOSTNAME.
*ACCEPTIP6
Removes the selected IPv6 item from the Accept Relay list. Parameter valid with this value is IP6PFX.
*REJECTIP6
Removes the selected IPv6 item from the Reject Relay list. Parameter valid with this value is IP6PFX.
*DOMAINIP6
Removes the selected IPv6 item from the Domains list. Parameters valid with this value are IP6NETADR and HOSTNAME.
*SVRBINDIP6
Removes the selected IPv6 item from the Server Bind list. Parameter valid with this value is IP6NETADR.
*CLTBINDIP6
Removes the selected IPv6 item from the Client Bind list. Parameter valid with this value is IP6NETADR.
Top

IPv4 address (INTNETADR)

Specifies the internet address to remove from the specified list. This address should be in dotted decimal format. Up to 15 characters can be specified.

Top

Subnet mask (SUBNETMASK)

Specifies the mask to use with the internet address.

255.255.255.255
This value selects only a single address value.
subnet-mask
The mask to use with the internet address. Up to 15 characters can be specified. Valid mask values are 128.0.0.0 - 255.255.255.255
Top

Host name (HOSTNAME)

Specifies the host name to remove from the list. Up to 255 characters can be specified.

Top

Filter data (FTRDATA)

Specifies the data to remove from matching when filtering. Up to 512 characters can be specified.

Top

IPv6 prefix (IP6PFX)

Specifies the IPv6 internet address or a IPv6 prefix to add to the specified list. This address should be in IPv6 network format. Up to 44 characters can be specified.

Top

IPv6 address (IP6NETADR)

Specifies the IPv6 internet address to add to the specified list. This address should be an IPv6 address and not a network. Up to 40 characters can be specified.

Top

Examples

Example 1: Removing an Element from the Accept Relay List

RMVSMTPLE   TYPE(*ACCEPT)  INTNETADR('1.2.3.4')

This command removes the address 1.2.3.4 with netmask 255.255.255.255. This means that this address can NOT be used to connect to the SMTP server to relay mail to another server.

Example 2: Removing an Element from the Subject Filter List

RMVSMTPLE   TYPE(*FTRSUBJECT)  FTRDATA('Love you.')

This command removes an element from the Subject Filter list. Mail will NOT be checked for the subject 'Love you.'

Example 3: Removing an Element from the Host Authentication List

RMVSMTPLE   TYPE(*HOSTAUTH)  HOSTNAME('xyz.com')

This command removes an element from the Host logon list. The SMTP server will not be able to logon to the host 'xyz.com'.

Example 4: Removing a single IPv6 Element from the Accept Relay List

RMVSMTPLE   TYPE(*ACCEPTIP6)  IP6PFX('2001:DB8::1')

This command removes the IPv6 address 2001:DB8::1 from the accept relay list.

Example 5: Removing a IPv6 prefix Element from the Accept Relay List

RMVSMTPLE   TYPE(*ACCEPTIP6)  IP6PFX('2001:DB8::/32')

This command removes the IPv6 prefix 2001:DB8::/32 from the accept relay list.

Example 6: Removing a IPv6 address Element from the Server Bind List

RMVSMTPLE   TYPE(*SVRBINDIP6)  IP6NETADR('2001:DB8::1')

This command removes the IPv6 address 2001:DB8::1 from the server bind list.

Top

Error messages

*ESCAPE Messages

TCP1901
Internet address &2 not valid.
TCP1903
Specified host name not valid.
TCP264F
SUBNETMASK parameter value &2 not valid.
TCP265F
INTNETADR parameter value &2 not valid.
TCP8050
*IOSYSCFG authority required to use &1.
TCP96AD
Entry not found in SMTP list type &1.
CPF9847
Error occurred while closing file &1 in library &2.
CPF9848
Cannot open file &1 in library &2 member &3.
CPF9849
Error while processing file &1 in library &2 member &3.
Top