End Mode (ENDMOD)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
Examples
ENDMOD RMTLOCNAME(APPCRLOC) MODE(APPCMOD)
This command ends a mode named APPCMOD for remote location APPCRLOC.
| Top |
| Top |