Search Scan Replace text in IFS files on IBM i using QSH – iSeries AS400

  • Home
  • /
  • Blog
  • /
  • Search Scan Replace text in IFS files on IBM i using QSH – iSeries AS400

November 8, 2017

This morning I wanted to find a quick and dirty way to “Scan Replace text in IFS” files without writing a program to do it…. SPOILER ALERT – it’s really really insanely simple using JAVA QSHELL and the SED command

So, before I start into techno-babble mode, here is some background of why I’m looking for IFS SCAN REPLACE


I’ve just finished writing a software install script which does all kinds of digital shenanigans and ends up saving a library to a SaveFile (*SAVF) and creating an installer script (Dos Batch File) on the IFS to automate the installation of that save file when it lands on the end clients machine. The idea is that we can simply zip it up, email it to the customer and they can simply unzip it and run the batch file which will do all the uploading, restoring and configuring for them.

note to self – put this script into a blog and share it with other IBM i folks that are equally annoyed by the repetitive FTP, BIN, NAMEFORMAT, UPLOAD nonsense


  • The batchfile is a generic installer so parameters like SAVE FILE and LIBRARY name will be changing for each install.
  • The batchfile is copied from a master copy (in the change management store) into a folder on the IFS for this particular distribution.
  • We then have a manual step that says “edit script file and update name of save-file and library to match those being distributed”

Now, I don’t know about you but I hate manual steps in the steps if there is an easy way to automate them.

Luckily there is.


Use the SED UNIX utility which lives in JAVA on our machine: Sed is a powerful tool to do some text manipulations in a file.

Stands for: Stream editor
Function: Stream editor for filtering and transforming text

SED lets us quickly replace text in a string – or an IFS FILE 🙂

echo 'I like beer'  
  I like beer

if we SED it:

echo 'I like beer' | sed "s/beer/sausages/"  
  I like sausages

Now we can do that same scan/replace in an IFS file by piping in an input and an output file.

Lets say we had an IFS file that contained the word “beer” and we want to scan for it and replace with word “sausages”

Search Scan Replace text in IFS files on IBM i using QSH - iSeries AS400 1

I’ve typed this into a file called test.bat in folder litten and will scan it, replacing beer for sausages (sacrilege!) and output the result to a file called result.bat in the same folder:

STRQSH CMD('sed "s/beer/sausages" /littenn/test.bat > /littenn/result.bat')

and boom it does it!

this replaces the first occurrence and if we wanted to scan the entire file we would just add the ‘/g’ switch (NOTE: must be lower case)

STRQSH CMD('sed "s/beer/sausages/g" /littenn/test.bat > /littenn/result.bat')

Search Scan Replace text in IFS files on IBM i using QSH - iSeries AS400 2

Search Scan Replace text in IFS files on IBM i using QSH - iSeries AS400 3

It’s neat and simple isn’t it?


IBM i Software Developer, Digital Dad, AS400 Anarchist, RPG Modernizer, Shameless Trekkie, Belligerent Nerd, Englishman Abroad and Passionate Eater of Cheese and Biscuits. Nick Litten Dot Com is a mixture of blog posts that can be sometimes serious, frequently playful and probably down-right pointless all in the space of a day. Enjoy your stay, feel free to comment and remember: If at first you don't succeed then skydiving probably isn't a hobby you should look into.

Nick Litten

related posts:

  • I love the idea behind this tool But i cant figure out how to keep the file in tact. I have created a file homeFileA.csv that I created from CPYTOIMPF. I can view it in Notepad or Excel. Once i perform the Command QSH CMD(‘sed ”s/|/,/g” /home/FileA.csv > /home/FileB.csv’ i can not display this new file. I can open it but it is garbage in notepad. I can view it in WRKLNK, but i need to send this to a user to be opened in Excel. What am i doing wrong?

  • {"email":"Email address invalid","url":"Website address invalid","required":"Required field missing"}

    Start your
    7-day free trial

    Take This Course with ALL ACCESS

    Unlock your Learning Potential with instant access to every course and all new courses as they are released.
     [ For Serious Software Developers only ]

    IBM i Training For Technology Experts


    Successfully Work Remote 

     $ 129.00  $59.00

    By adding new skills in information technology, employers will be confident that you have the necessary skills and tools needed to successfully work remotely


    Snug CBD

     20% Discount

    I have partnered with SNUG CBD givING you Organic CBD
    20% discount code "NL20"