SETRRS ARCHIVELOGGING command

RRS writes to the archive log stream for each completed UR. RRS never uses the information written to the RRS archive log; the information is intended for the installation to use if a catastrophic problem occurs. Because of the severe performance impact of running RRS with the archive log stream, customers want to run without it. This can be accomplished by deleting the archive log before starting any RRS image in the logging group or when RRS is operational, the SETRRS ARCHIVELOGGING system command can be used. Issuing the ARCHIVELOGGING,DISABLE command should be done during a lull in transaction processing to prevent damage to chained sysplex cascaded records. If the overall goal is to delete the archive log, the DISABLE command can be issued at anytime.

SETRRS ARCHIVELOGGING|,DISABLE|ENABLE|

The options are:

DISABLE: Indicates the system is to disable the RRS archive logging for the subsequent transactions. RRS will stop writing the transaction completion records to the archive log and disconnect from the archive log stream.
ENABLE: Indicates the system is to enable the RRS archive logging for the subsequent transactions. RRS will connect to the archive log stream and start writing the transaction completion records to the archive log. The ENABLE request is done by asynchronous processing and might take as long as 15 seconds before the Archive Log Stream is connected and the enable message (ATR175I) is issued.

Observations:

Disable/Enable is a flag setting within RRS and does not represent the actual state of the Archive Log Stream. A Disable setting indicates that RRS on that system will not connect to or use the log, but the log stream might still be present. Conversely, starting RRS with an Enable setting and a deleted Archive Log Stream will cause RRS to try and connect to the log stream which will fail resulting in message:
- ATR132I RRS LOGSTREAM CONNECT HAS FAILED FOR OPTIONAL LOGSTREAM ATR.PLEX1.ARCHIVE. RC=00000008, RSN=0000080B
To find the current status of the Archive Log Stream, use command:
```
D LOGGER,CONNECTION,JOBNAME=RRS,LSNAME=ATR.groupname.ARCHIVE
```
Where:
- groupname is the RRS logging group name
This will show the log streams currently connected to RRS on that system. The Archive log will only appear in the list when it's connected. Other Display Logger commands like:
```
D LOGGER,LOGSTREAM,LSNAME=ATR.groupname.ARCHIVE
```
will show the connection anyplace in the sysplex. So if SY1 is disconnected and SY2 is connected to the log stream, the command when issued on SY1 will show a status of "IN USE" because it is "IN USE" on SY2. The message text will also indicate those systems connected to the log stream.