Return LU6.2 Partners (QTNRTNLU) API
Optional Parameter:
1 | 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 ]