Remove Communications Entry (RMVCMNE)

The Remove Communications Entry (RMVCMNE) command removes a communications entry from an existing subsystem description.

Restrictions:

To use this command, you must have:
- object operational (*OBJOPR), object management (*OBJMGT), and read (*READ) authority to the specified subsystem description and execute (*EXECUTE) authority to the library containing the subsystem description.
All jobs that are active through the communications entry being removed must be ended before this command can be run.

Parameters

Keyword	Description	Choices	Notes
SBSD	Subsystem description	Qualified object name	Required, Positional 1
	Qualifier 1: Subsystem description	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
DEV	Device	Generic name, name, ALL, APPC, ASYNC, BSCEL, INTRA, RETAIL, FINANCE, SNUF	Optional, Positional 2
RMTLOCNAME	Remote location	Communications name	Optional
MODE	Mode	Name, *ANY	Optional

Top

Subsystem description (SBSD)

Specifies the name and library of the subsystem description from which the communications entry is being removed.

This is a required parameter.

Qualifier 1: Subsystem description

name

Specify the name of the subsystem for the communications entry that is being removed.

Note: The following IBM-supplied objects are not valid on this parameter:

QSYSSBSD

Qualifier 2: Library

*LIBL: All libraries in the thread's library list are searched until a match is found.
*CURLIB: The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.

name: Specify the name of the subsystem description's library for the communications entry that is being removed.

Device (DEV)

Specifies the name of the device description, or the type of the device, for which the communications entry is being removed.

Note: You must specify a value on either this parameter or the Remote location (RMTLOCNAME) parameter but not for both.

*ALL: The *ALL communications entry is removed.
*APPC: The *APPC communications entry is removed.
*ASYNC: The *ASYNC communications entry is removed. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
*BSCEL: The *BSCEL communications entry is removed. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
*FINANCE: The *FINANCE communications entry is removed. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
*INTRA: The *INTRA communications entry is removed. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
*RETAIL: The *RETAIL communications entry is removed. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
*SNUF: The *SNUF communications entry is removed. This value is valid only when *ANY is specified on the Mode (MODE) parameter.
generic-name: Specify the name of the generic communications entry being removed.
name: Specify the name of the device description for which the communications entry is being removed.

Remote location (RMTLOCNAME)

Specifies the name of the remote location for which the communications entry is removed.

Note: You must specify either this parameter or the Device (DEV) parameter, but not both.

communications-name: Specify the name of the remote location used with this communications entry.

Mode (MODE)

Specifies the name of the mode of the device specified on the Device (DEV) parameter or the remote location specified on the Remote location (RMTLOCNAME) parameter for which the communications entry is removed.

*ANY: The communications device or remote location name with a mode name of *ANY is to be removed.
name: Specify the name of the mode entry of the communications device or remote location name for which the communications entry is to be removed.

Examples

RMVCMNE   SBSD(LIB2/SBS1)  DEV(COMDEV)

This command removes the communications device entry for the device COMDEV from the subsystem description SBS1 in library LIB2.