Retrieve_Log_Name (ATRIRLN, ATR4IRLN)

ATRIRLN is for AMODE(31) callers.
ATR4IRLN is for AMODE(64) callers and allows parameters in 64 bit addressable storage.

Before beginning restart, a resource manager should call the Retrieve_Log_Name service to obtain log names. In response to the call, RRS returns:

A return code
The length of the resource manager log name
The name of the resource manager log as recorded in the RRS log
The length of the RRS log name
The RRS log name

The call provides the resource manager's log name only if the resource manager, when it was running before this restart, called the Set_Log_Name service to supply the log name to RRS.

Your resource manager should save the RRS log name in its resource manager log.

Comparing log names: The resource manager compares the information RRS returns with information in its own logs:

It compares the returned resource manager log name to the name of the log the resource manager is currently using
It compares the returned RRS log name to the RRS log name the resource manager saved when it was running before this restart

If both comparisons match, the resource manager can correlate unit of recovery (UR) data it receives from Retrieve_UR_Interest calls with data from its resource manager log. Log name checks describes the comparisons and appropriate actions in more detail.