Communicator e3000 MPE/iX Release 6.0 Express 1 (C.60.01) (30216-90286)

Chapter 3 19
Technical Articles
CI Enhancements
$STDLIST (within the definition of the HPMSGFENCE variable).
status values:
0 - success
3042 - no job or session matches the jobID
4000 - invalid syntax for the jobID, expect [#]J|Snnn
9942 - unknown JINFO item
9945 - information for the requested item is unavailable for the
target jobID.
9946 - item security violation, the user needs greater
privileges to retrieve the item
Example: :calc JINFO(‘S64’,’IPaddr’)
Result: 15.192.90.81
Example: :calc JINFO(‘J144’,’FmtPriority’,status)
Result: DQ
Example: setvar _state JINFO(hplastjob,’jobstate’,status)
while status = 0 and _state = ‘WAIT’ do
pause 20
...
setvar _state JINFO(hplastjob,’jobstate’,status)
endwhile
Example: if jobcnt(‘@J:@r.sys’,jlist) > 0 then
setvar i 0
setvar total_cpu 0
while setvar(_job, word(jlist,,setvar(i,i+1))) <> ‘’ do
if JINFO(_job,’exists’) then
setvar total_cpu total_cpu + JINFO(_job,’CPUsec’)
endif
endwhile
endif
Restrictions
Not all items listed below are available to jobs that are waiting or scheduled. For example,
JINFO is unable to return the CI PIN (‘CIpin’) if the job is waiting; however, some items,
like the job state and job queue, are returned, regardless of the state of the target job.
When a JINFO item cannot be obtained CIERR 9945 is reported. If the ‘status’ argument is
passed, it is set to 9945 and no CI error is displayed.
No special capabilities are required to get any info about your own job/session. Users with
OP or SM capability can get all items for any job/session, and may also retrieve the global
items available via JINFO.
For users lacking OP or SM capability:
• To access restricted data for a job logged on in the same “user.acct”, AM capability is
required, unless JOBSECURITY is set to LOW. If JOBSECURITY is LOW, JINFO considers
the job as if it is “you”.
• To access restricted data for a job logged on in your account but as a different user, AM
capability is required, independent of the JOBSECURITY setting.
Some items have additional restrictions:
•‘command’, any token in the command image that could be considered a lockword is
deleted.