Start Mode (STRMOD)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Start Mode (STRMOD) command starts one or all modes currently in use for an advanced program-to-program communications (APPC) remote location. The user can use STRMOD in either the reset or ended state; it is required only after an End Mode (ENDMOD) command has ended a mode. More information is in the APPC Programming book, SC41-5443.
Restriction: The user must have operational authority for the APPC device to use this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| RMTLOCNAME | Remote location | Communications name | Required, Positional 1 |
| DEV | Device | Name, *LOC | Optional, Positional 2 |
| 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 |
| Top |
| Top |
Device (DEV)
Specifies the device description name.
The possible values are:
- *LOC
- The device description is determined by the system.
- device-name
- Specify the name of the device description.
| Top |
Mode (MODE)
Specifies the mode that is to be started.
The possible values are:
- *NETATR
- The mode in the network attributes is used.
- *ALL
- All modes currently in use for the remote location are to be started.
- For a device description automatically created by the APPN support or a device description manually created with the APPN parameter specified as *YES, *ALL indicates that any modes that have been used while the remote location was active, but are not currently started, are to be started.
- For a device description manually created with the APPN parameter specified as *NO, *ALL specifies that all configured modes for the specified remote location are to be started.
- 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.
| Top |
Examples
STRMOD RMTLOCNAME(APPCRLOC) DEV(APPCDEV) MODE(APPCMODE)
RMTNETID(CHICAGO)
This command starts a mode named APPCMODE for a remote location named APPCRLOC, a device named APPCDEV, and a remote network ID of CHICAGO.
| Top |
| Top |