Return LU6.2 Partners (QTNRTNLU) API

Optional Parameter:

Error code

I/O

Char(*)

Default Public Authority: *USE

Threadsafe: No

The Return LU6.2 Partners (QTNRTNLU) API identifies all the LU6.2 partner logical unit (LU) names that are known to this system. The following informational message is sent to the joblog of the job issuing the API to identify each partner:

CPI83D1

Partner LU &1.&2 is known to this system.

Replacement variable &1 is the partner LU remote network identifier and &2 is the partner LU location name.

Connection problems sometimes occur after a partner LU is moved to a backup system with the same SNA configuration as the original system. The Clear LU6.2 Partners (QTNCLRLU) API can be used to correct such problems.

Authorities and Locks

Authority: *ALLOBJ special authority is required.
Locks: None.

Required Parameter

None

Optional Parameter

Error code: I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, diagnostic and escape messages are issued to the caller of the API.

Usage Notes

This API was designed so that it would be easy to use from a CL command line. The following CL command will return all the LU6.2 partners known to this system:

CALL PGM(QTNRTNLU)

Error Messages

Message ID	Error Message Text
CPF3CF1 E	Error code parameter not valid.
CPF83ED E	&1 API requires &2 special authority.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V5R3

[ Back to top | Journal and Commit APIs | APIs by category ]