- 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.
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.
Parameters
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.
|
Parameter |
Value |
Description |
| 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.
Example
values iQuery.job('job') into :qualJob;
values iQuery.job('*intjobid') into :intJob;