JINFO


Syntax:     JINFO(jobID, item [,status])

Defn: A CI evaluator function that returns information about
the specified job or session.

Type: String, integer, or Boolean depending upon item.

Parms:

JobID: Required. String identifying the target job or session as
"[#]Jnnnn" or "[#]Snnnn", where "nnnn" is a number.
"0" indicates the target job/session is the caller.
Item: Required. String label specifying which information is to
be returned.
Status: Optional. CI variable name where a JINFO error number can be
returned. Zero indicates success. Non-zero indicates a
failure. Error values returned in 'status' are the same as
the CIERROR value when an error occurs. If the 'status'
parm is passed the CI will not set CIERROR and will not
report an error message. If 'status' is not specified the
CI performs its normal error handling.

Example: JINFO('#J15', "exists")
Result: TRUE
Example: JINFO("0", 'jobQ')
Result: HPSYSJQ
Example: JINFO(hplastjob, 'StdlistSPstate')
Result: CREATE

The following table summarizes the items of the JINFO function.
The description includes the item string, one or more aliases,
the data type, and a brief description of the item.

Item String Type * Description
------------ ---- --------------------------------------------
Account string account name
CIpin int PIN number for the job's CI
Command string * command most recently executed (lockwords
are removed)
ConnectMin int number of minutes connected
ConnectSec int number of seconds connected
Copies int number of copies for $STDLIST output
CPULimit int CPU limit in seconds, -1 is unlimited
CPUMillisec int number of milliseconds of CPU
CPUSec int number of seconds of CPU
Deferred bool True if job's inpri is <= the jobfence
DegradeMode bool *+ True if system is running in degraded
mode
Executing bool True if the target job exists and is in the
INTRO, EXEC* or EXEC states.
Exist bool True if the target job exists in any state
Exists bool Same as 'exist'
FmtIntroDate string formatted date job was introduced
FmtIntroTime string formatted time job was introduced
FmtPriority string current scheduling queue for the usermain
(CI) process, e.g. 'BS', 'CS', 'DS', 'ES'
FmtStreamedByDate string formatted date when job/session was
submitted
FmtStreamedByTime string formatted time when job/session was
submitted
Group string logon group name
HomeGroup string * home group name
Inpri int input priority
IntIntroDate int date job was introduced as a YYYYMMDD
integer
IntIntroTime int time job was introduced as a HHMMSS
integer
IntroDate int date job was introduced as a YYYYMMDD
integer
IntStreamedByDate int date job/session was submitted as a
YYYMMDD integer
IntStreamedByTime int time job/session was submitted as a
HHMMSS integer
IPAddr string ** IP address in dotted format (xx.xx.xx.xx)
Job User Account string "[jname,]user.acct" names concatenated
Job User Account string "[jname,]user.acct,group" names concatenated
Group
JobName string jobname if supplied, else ""
JobNum string unique job identifier, "#J|Snnnn"
JobQ string job queue name, "" for sessions
JobSecurity string *+ "LOW" or "HIGH" depending on the
JOBSECURITY
JobState string "INTRO", "SCHED", "WAIT", "EXEC*", "EXEC",
"SUSP"
JobType string "J" for jobs and "S" for sessions
JobUserAccount string see "Job User Account"
JobUserAccountGroup string see "Job User Account Group"
JSMAINPin int PIN number for the job's JSMAIN
LdevIn int Input LDEV number for $STDIN
LdevOut int Output LDEV number for $STDLIST, 0 for
spooled jobs
LocAttr int * user local attributes
Outpri int output priority
OutClass string Outclass name for a job's STDLIST, e.g."LP",
empty ("") for sessions
Numbered bool True is job file is numbered
PassExempt string *+ "NONE", "USER", "XACCESS", "MAX"
Priority int current priority for the usermain (CI)
process, e.g. 150, 200, etc.
Private bool * True if the job's stdlist is marked
private
Quiet bool True if set msg=off in effect
RawIntroDate int date job was introduced in CALENDAR format
RawIntroTime int time job was introduced in CLOCK format
RawStreamedByDate int date job/session was submitted in CALENDAR
format
RawStreamedByTime int time job/session was submitted in CLOCK
format
Restart bool True if ";RESTART" specified in job
Scheduled bool True if the target job exists and is in the
SCHED state.
State string see "JobState"
StdinSPID string Innn identifier for the stdin spoolfile for
jobs
StdinSPstate string STDIN spoolfile state: "OPEN", "ACTIVE",
"READY"
StdlistDelete bool True if SET STDLIST=delete in effect.
StdlistSPID string Onnn identifier for the stdlist spoolfile
for jobs
StdlistSPstate string STDLIST spoolfile state: "CREATE", "DEFER",
"READY" "XFER", "PRINT", "PROBLM", "DELPND",
"SPSAVE".
StreamedBy string * full identifier of the job/session that
streamed or otherwise initiated the target
job. The same format as the HPSTREAMEDBY variable. StreamedByDate int see "IntStreamedByDate" StreamedByLdev int * Ldev of job/session that submitted the target job StreamedByTime int see "IntStreamedByTime" Suspended bool True if the target job exists and is in the SUSP state. User string user name User Account string "user.account" names concatenated User Account Group string "user.account,group" names concatenated UserAccount string See "User Account" UserAccountGroup string See "User Account Group" Waiting bool True if the target job exists and is in the WAIT state. * indicates you must have SM or OP capabilities, or the job must be your own job, or you must have AM capability and be logged on into the same account as the target job, or you must be logged on as the same user.account as the target job and JOBSECURITY is LOW. Otherwise the item is not returned and an error is generated. *+ indicates you must have SM or OP capabilities. *+ indicates you must have one of SM,OP,NA,NM,PM capabilities.