Change Mode Name (QNMCHGMN) API

Required Parameter Group:

1	Handle	Input	Binary(4)
2	Mode name	Input	Char(8)
3	Error code	I/O	Char(*)

Default Public Authority: *USE

Threadsafe: No

The Change Mode Name (QNMCHGMN) API, an SNA/Management Services Transport API, sets the APPC mode name used when sending requests.

When a specific mode name is specified, direct routing is used. The result is a direct session from the source system to the target system.

Data sent using the system mode name SNASVCMG is sent at network priority, which means that data specifying this mode flows before any other data. Setting the mode to something other than SNASVCMG can lessen the effect on network performance and allow bulk data transfer. If large amounts of data are to be sent relative to the speed of the communications medium, then consider another mode. A mode object specified by its name in the mode name parameter must exist at the time this API is called.

Authorities and Locks

None.

Required Parameter Group

Handle

INPUT; BINARY(4)

The unique identifier for this application, which was returned by the Start Application (QNMSTRAP) API.

Mode name

INPUT; CHAR(8)

The APPC mode name used on subsequent requests. Special values are:

*NETATR

The current default mode name specified in the network attributes.

*DFTRTG

A CPSVCMG session is used between end nodes and network nodes, and an SNASVCMG session is used between network nodes. CPSVCMG may not be specified. *DFTRTG is the default value, and it may require multiple APPN sessions to transport the data. In this case, the network node server performs SNA/Management Services routing for all end node traffic. This results in fewer sessions in the network and a slower response time.

Note: Some products other than System i™ only support *DFTRTG.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

Message ID	Error Message Text
CPF24B4 E	Severe error while addressing parameter list.
CPF3C90 E	Literal value cannot be changed.
CPF3CF1 E	Error code parameter not valid.
CPF7AE2 E	Handle &1 not found.
CPF7AE4 E	Mode name &3 not valid.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V2R2

[ Back to top | Network Management APIs | APIs by category ]