Start Mode (STRMOD)

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.

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

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.

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.

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.

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.