- SQL iQuery - RUNiQRY CL Command
- CSV() - Read and Parse Comma Separated Values File
- CSV_VAL() Extract CSV Column Value
- CSV_XXXX() Extract CSV Column Value as xxxx
- CSV_COUNT - Retrieve Field Count
- ObjExist - Check Object Exits
- DTAARA - Data Area
- encode_URL Encode URL for the Web
- encode_TAG Encode HTML TAG Content
- FLDLIST - List the Fields of a Table
- FROMHEX - Fold 2-hex Chars into 1 Char
- GET CPUCNT, CURLIB, ENV, SRLNBR, SYSNAME
- MD5_HASH - UDF - Return MD5 Hash
- ifsStat - Get IFS File Attributes
- ifsExists - Check if IFS File Exists
- ifsFile - Query Contents of IFS Text File
- ifsDIR - List IFS Directory Entires
- DEPFILE - List Dependent Database Relations
- JOB - Get Job Name Component
- Job_ATTR - Job Attributes
- JOB_DATE Retrieve the Job Date
- JOBLOG - Write Message to Joblog
- Library List UDF and Procedures
- MBRLIST - Member List
- MCHINFO Machine Type and Model Number and OS version
- OSVER and OSVRM Get IBM i Version/Release
- PrintPDF - Print a PDF to a PDF Compatible Printer
- CPYTOPDF - Copy SPOOLED File to PDF file
- OBJ_LIST List Object in a Library
- LIB_LIST List Descriptions of Libraries on the Library List
- OBJ_EXPORTS List Exported Items from an Object
- OBJ_STRUCT Retrieve Objects Components
- RTVCMDD Retrieve Command Definition
- RTVJOBA - Retrieve Job Attributes
- RTVJOBD - Retrieve Job Description
- RTVLASTSPLF - Retrieve ID of Last SPOOLED File for this Job
- RTVxxx - Retrieve Various Objects Description Table Functions
- WATCHLIST - List Current Watches
- Polymorphic Qualified Name Syntax
Using IBM i? Need to create Excel, CSV, HTML, JSON, PDF, SPOOL reports? Learn more about the fastest and least expensive tool for the job: SQL iQuery.
Query Contents of IFS File
The iQuery.ifsFile() UDF reads the specified IFS text file and returns one row for each "record" in the Text file. The basic output is similar to the DSPF CL command, but can be queried and re-directed to other formats.
The returned value is always a varchar(8192) value and my be re-cast using CAST or by wrapping the result in VARCHAR() with a different result column width. If the resulting text data is longer than 8192 characters, it is truncated.
Parameters
iQuery.ifsFile( 'IFS text file name and path' )
The IFS Text File Name and Path parameter identifies the IFS text file to be queried. This can be a plain text file, CSV file, JSON, etc. If the file is from Microsoft Windows and it contains a BOM (Byte Order Mark) IFSFILE will attempt to detect the BOM and continue to render the rest of the file normally.
ResultSet Columns
| Column Name |
System Column Name |
Data Type | Description |
| TEXTDATA | TEXTDATA | varchar(8192) | The IFS text file data from the IFS file. One row is returned for each "line" in the text file. |
The UDTF reads IFS text files as rows or lines. A line is everything up until a CR/LF or LF/CR pair. In addition, it also supports lines that end with a signel LF or CR symbol. Each line is returned as one row in the resultSet.
Example
In this example, our sample COUNTRY.TXT file that contains a list of all countries followed by their abbreviation (separated by a semicolon) is queried using SQL iQuery IFSFILE() UDTF and is returned.
select * table(iQuery.ifsFile('/home/cozzi/country.txt')) text;
TEXTDATA
COUNTRY;ABBR
AFGHANISTAN;AF
ÅLAND ISLANDS;AX
ALBANIA;AL
ALGERIA;DZ
AMERICAN SAMOA;AS
ANDORRA;AD
ANGOLA;AO
ANGUILLA;AI
ANTARCTICA;AQ
ANTIGUA AND BARBUDA;AG