ENDMOD (End Mode)

ENDMOD Command syntax diagram

 

Purpose

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, APPN and HPR topic in the Information Center 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.

 

Required Parameters

RMTLOCNAME

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

 

Optional Parameters

DEV

Specifies the device description name used with the remote location.

*LOC: The device associated with the remote location is used. If several devices are associated with the remote location, the system determines which device is used.

device-name: Specify the name of the device for which one or more modes are being ended.

MODE

Specifies the mode that is ended.

*NETATR: The mode name specified in the network attributes is used.

*ALL: All modes currently active by the remote location are ended.

BLANK: The mode name consisting of 8 blank characters is used.

mode-name: Specify a mode name for the device.

LCLLOCNAME

Specifies the local location name.

*LOC: The device associated with the remote location is used. If several devices are associated with the remote location, the system determines which device is used.

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

local-location-name: Specify the local location name.

RMTNETID

Specifies the remote network ID used with the remote location.

*LOC: The remote network identifier (ID) associated with the remote location is used. If several remote network IDs are associated with the remote location, the system determines which remote network ID is used.

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

*NONE: No remote network identifier (ID) is used.

remote-network-ID: Specify the name of the remote network ID used.

CPLPNDRQS

Specifies how the remote location processes all pending user work before ending the mode.

*NO: 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.

Example for ENDMOD

ENDMOD  RMTLOCNAME(APPCRLOC)  MODE(APPCMOD)

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

Error messages for ENDMOD

*ESCAPE Messages

CPF598B

The &1 command failed for one or more modes.