IBM Support

Copying the BRMS Flight Recorder to a Text File

Troubleshooting


Problem

This document explains how to copy the BRMS flight recorders to a text file so it can be displayed on a PC.

Resolving The Problem

To copy the BRMS flight recorders to a text file so they can be viewed with Notepad or WordPad, do the following:

CPY OBJ('/QIBM/UserData/BRMS/logs/flightrec') TOOBJ('/QIBM/UserData/BRMS/logs/flightrec.txt') TOCCSID(*PCASCII) DTAFMT(*TEXT)

CPY OBJ('/QIBM/UserData/BRMS/logs/flightrec.bku') TOOBJ('/QIBM/UserData/BRMS/logs/flightrecbku.txt') TOCCSID(*PCASCII) DTAFMT(*TEXT)


The CCSID of the .txt file must be 37 to be viewable on the PC. The following must be performed after the copy:
CHGATR OBJ('/QIBM/UserData/BRMS/logs/flightrec.txt') ATR(*CCSID) VALUE(37)

CHGATR OBJ('/QIBM/UserData/BRMS/logs/flightrecbku.txt') ATR(*CCSID) VALUE(37)
Optional: ZIP the .txt file
  • NOTE:  For customers that are not on the March 2020 BRMS PTF flightrec data will be in folder '/TMP/BRMS' instead of '/QIBM/UserData/BRMS/logs'.

    The flightrec.txt file can be zipped to reduce the size to approximately 10% of the original if Qshell is installed on the system (57xxSS1 Option 30).

    Start the Qshell interpreter with command QSH and execute the following command to zip the file:

    jar cfM /QIBM/UserData/BRMS/logs/flightrec.txt.zip /QIBM/UserData/BRMS/logs/flightrec.txt

    Note: The zip is complete when a $ is returned.

    This will create the flightrec.txt.zip file in directory /QIBM/UserData/BRMS/logs/.


FTP or use Operations Navigator to drag and drop it to a folder on a PC. The file can then be attached to an e-mail.
You can also send the file using QMGTOOLS: QMGTOOLS: FTP Data to IBM

Gathering the entire BRMS Flight Recorder (FR) directory
 
If you are asked to gather the entire BRMS FR directory, you can compress the directory to a ZIP file by running the collowing comand from QSH:

jar cfM /QIBM/UserData/BRMS/BRMSFR.zip /QIBM/UserData/BRMS/logs/*.*
Then transfer the zip file to your PC through the ACS > Integrated File System, and upload it to your case.

Notes:
  1. It may be necessary to open the file with WordPad first and save it before being able to see the formatted version of the file using Notepad.
  2. Any stream file (STMF) can be copied in this way.

[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CKTAA2","label":"Backup Recovery Install Migration-\u003EBRMS"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0;and future releases"}]

Historical Number

361965232

Document Information

Modified date:
12 June 2025

UID

nas8N1015780