Retrieve Mode Name (QNMRTVMN) API

Required Parameter Group:

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

Default Public Authority: *USE

Threadsafe: No

The Retrieve Mode Name (QNMRTVMN) API, an SNA/Management Services Transport API, retrieves the APPC mode name currently being used for the purpose of sending requests. The mode name retrieved is the one currently associated with the application identified by the handle.

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

OUTPUT; CHAR(8)

The APPC mode name that is used when a request is sent. The special value is:

*DFTRTG

A CPSVCMG session is used between end nodes and network nodes, and a SNASVCMG session is used between network nodes. *DFTRTG is the default parameter, 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 total sessions in the network and a slower response time.

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.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V2R2

Top | Network Management APIs | APIs by category