Midrange News for the IBM i Community

Posted by: Bob Cozzi
Rogue Programmer
Cozzi Productions, Inc.
SQL iQuery Documentation - UDF and UDTF
has no ratings.
Published: 17 Jun 2019
Revised: 20 Aug 2019 - 1651 days ago
Last viewed on: 25 Feb 2024 (725 views) 
  1. SQL iQuery - RUNiQRY CL Command
  2. CSV() - Read and Parse Comma Separated Values File
  3. CSV_VAL() Extract CSV Column Value
  4. CSV_XXXX() Extract CSV Column Value as xxxx
  5. CSV_COUNT - Retrieve Field Count
  6. ObjExist - Check Object Exits
  7. DTAARA - Data Area
  8. encode_URL Encode URL for the Web
  9. encode_TAG Encode HTML TAG Content
  10. FLDLIST - List the Fields of a Table
  11. FROMHEX - Fold 2-hex Chars into 1 Char
  13. MD5_HASH - UDF - Return MD5 Hash
  14. ifsStat - Get IFS File Attributes
  15. ifsExists - Check if IFS File Exists
  16. ifsFile - Query Contents of IFS Text File
  17. ifsDIR - List IFS Directory Entires
  18. DEPFILE - List Dependent Database Relations
  19. JOB - Get Job Name Component
  20. Job_ATTR - Job Attributes
  21. JOB_DATE Retrieve the Job Date
  22. JOBLOG - Write Message to Joblog
  23. Library List UDF and Procedures
  24. MBRLIST - Member List
  25. MCHINFO Machine Type and Model Number and OS version
  26. OSVER and OSVRM Get IBM i Version/Release
  27. PrintPDF - Print a PDF to a PDF Compatible Printer
  28. CPYTOPDF - Copy SPOOLED File to PDF file
  29. OBJ_LIST List Object in a Library
  30. LIB_LIST List Descriptions of Libraries on the Library List
  31. OBJ_EXPORTS List Exported Items from an Object
  32. OBJ_STRUCT Retrieve Objects Components
  33. RTVCMDD Retrieve Command Definition
  34. RTVJOBA - Retrieve Job Attributes
  35. RTVJOBD - Retrieve Job Description
  36. RTVLASTSPLF - Retrieve ID of Last SPOOLED File for this Job
  37. RTVxxx - Retrieve Various Objects Description Table Functions
  38. WATCHLIST - List Current Watches
  39. 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.

iQuery.Job - UDF Published by: Bob Cozzi on 17 Jun 2019 view comments

Retrieve Job Identity Component

The iQuery.JOB() UDF returns a component of the job name identification. Use it to return the job name, number, user profile or internal Job ID.


iQuery.job( job-component-to-retrieve varchar(10) );

The job-component-to-retrieve may be any of the following. Only that component's value is retuned.



JOBNAME Job Name The name of the job. For interactive jobs this is normally the Workstation ID generated by ACS or similar. For batch jobs it is the name specified on the SBMJOB command. You may also specify NAME to retrieve this component.
JOBUSER User Profile The user profile under which the job is running. You may also specify JOBUSR, USER, USR, or USRPRF to retrieve this component.
JOBNBR Job Number The 6-digit job number (as text). You may also specify NBR to retrieve this component.
INTJOBID Internal Job ID The internal job ID that can be use to more quickly access the job information via IBM i APIs. You may also specify INTID and ID to retrieve this component.
JOB Fully qualified job name The (up to) 28 character fully qualified job name in the 666666/USER/NAME format. You may also specify QUALJOB and QUAL to retrieve this component.

Return Value

UDF Return Type Description
JOB varchar(32) The job component is always returned as a 32-byte varchar value. See Table 2 below for details on each component.
Table 2: Component Identifiers

The Parameter options my be specified with or without a leading asterisk. Therefore JOB('*JOBNAME') and JOB('JOBNAME') return the same result. Upper/lower case is ignored.


values iQuery.job('job') into :qualJob;
values iQuery.job('*intjobid') into :intJob;


Return to midrangenews.com home page.
Sort Ascend | Descend