RMVCMNE (Remove Communications Entry)

RMVCMNE Command syntax diagram

 

Purpose

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

 

Restrictions

  1. The user of this command must have object operational and object management authorities for the specified subsystem description.

  2. All jobs that are active through the communications entry being removed must be ended before this command can be run.

  3. A communications entry cannot be removed from an active subsystem while there are active jobs associated with it.

 

Required Parameters

SBSD
Specifies the qualified name of the subsystem description from which the communications device entry is being removed.

The name of the subsystem description can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

subsystem-description-name: Specify the name of the subsystem description.

DEV
Specifies the name of the device description or the type of the device for which a communications device entry is being removed from the subsystem description.

Note: The DEV parameter and the RMTLOCNAME parameter are mutually exclusive.

*ALL: The *ALL communication entry is removed.

*APPC: The advanced program-to-program communications device entry is removed.

*ASYNC: The asynchronous communications device entry is removed with this communications entry. This value is valid only when MODE(*ANY) is specified.

*BSCEL: The binary synchronous equivalency link communications device entry is removed. This value is valid only when MODE(*ANY) is specified.

*FINANCE: The FINANCE communications device entry is removed. This value is valid only when MODE(*ANY) is specified.

*INTRA: The INTRA communications device entry is removed. This value is valid only when MODE(*ANY) is specified.

*RETAIL: The RETAIL communications device entry is removed. This value is valid only when MODE(*ANY) is specified.

*SNUF: The SNA upline facility communications device entry is removed. This value is valid only when MODE(*ANY) is specified.

device-name: Specify the device description name or the type of device to use with this communications device entry. The name specified on the CRTDEVxxx command associated with this device description name is used.

generic*-device-name: Specify the generic device description used with this remove communications device entry. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. For more information on the use of generic names, refer to generic names.

RMTLOCNAME
Specifies the name of the remote location that is used with this object.

Note: The remote location name specified on the CRTDEV command can be used. Validity checking is not done on the remote location name.

 

Optional Parameters

MODE
Specifies the name of the mode of the device specified by the DEV parameter or the remote location specified by the RMTLOCNAME parameter from which the communications device entry is removed.

*ANY: The communications device entry which has a value of *ANY for the device is removed.

mode-name: Specify the name of the mode entry of the communications device or remote location from which the communications device entry is removed.

Example for RMVCMNE 

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.

Error messages for RMVCMNE

*ESCAPE Messages

CPF1619
Subsystem description &1 in library &2 damaged.
CPF1691
Active subsystem description may or may not have changed.
CPF1697
Subsystem description &1 not changed.