The End Mode (ENDMOD) command ends (deactivates) a single mode or all active modes for a specific advanced program-to-program communications (APPC) remote location. The mode remains inactive until a Start Mode (STRMOD) command is run to start the mode. This command can be used to end all the sessions for a particular remote location and to cause an active switched connection to disconnect. The user can also specify how activities that have been requested on the remote system but have not yet been performed are to be handled.

The APPC Programming book, SC41-5443 has more information on the ENDMOD command.

Restriction: This command cannot be used to end (deactivate) Client Access/400 mode (QPCSUPP) at a remote location.

Parameters

Keyword	Description	Choices	Notes
RMTLOCNAME	Remote location	Communications name	Required, Positional 1
DEV	Device	Name, *LOC	Optional
MODE	Mode	Communications name, *NETATR, *ALL	Optional
LCLLOCNAME	Local location	Communications name, *LOC, *NETATR	Optional
RMTNETID	Remote network identifier	Communications name, *LOC, *NETATR, *NONE	Optional
CPLPNDRQS	Complete pended requests	*NO, *YES	Optional

Top

Remote location (RMTLOCNAME)

Specifies the remote location name for which one or more modes are to be ended.

This is a required parameter.

Device (DEV)

Specifies the device description name.

The possible values are:

*LOC

The device description is determined by the system.

device-name

Specify a device description name.

Mode (MODE)

Specifies the mode that is to be ended.

The possible values are:

*NETATR

The mode in the network attributes is used.

*ALL

All modes currently in use by the remote location are ended.

BLANK

The mode name (consisting of 8 blank characters) is used.

mode-name

Specify a mode name.

Note: SNASVCMG and CPSVCMG are reserved names and cannot be specified.

Local location (LCLLOCNAME)

Specifies the local location name.

The possible values are:

*LOC

The local location name is determined by the system.

*NETATR

The LCLLOCNAME value specified in the system network attributes is used.

local-location-name

Specify the name of your location. The local location name is specified if you want to indicate a specific local location name for the remote location.

Remote network identifier (RMTNETID)

Specifies the remote network ID used with the remote location.

The possible values are:

*LOC

The system selects the remote network ID.

*NETATR

The remote network identifier specified in the network attributes is used.

*NONE

No remote network identifier (ID) is used.

remote-network-id

Specify the name of the remote network ID used.

Complete pended requests (CPLPNDRQS)

Specifies if the remote location can complete pending work, or if the pended work should be ended before being allowed to start.

The possible values are:

*NO

The requested activities currently in progress at the remote location can complete. Activities that have been requested but not started at the remote location will not be performed.

*YES

All requested activities are allowed to complete before the mode is ended.

Examples

ENDMOD   RMTLOCNAME(APPCRLOC)  MODE(APPCMOD)

This command ends a mode named APPCMOD for remote location APPCRLOC.

Error messages

*ESCAPE Messages

CPF598B

The &1 command failed for one or more modes.