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

22 Chapter3
Technical Articles
CI Enhancements
Type: Integer
Parms
Job_match: Required. String identifying the target jobs and/or sessions.
Supported formats:
“@” - all jobs and sessions
“@J” - all jobs
“@S” - all sessions
“user.acct” - all job/sessions matching “user.acct”
“jobname,user.acct” - all job/sessions matching
“jobname,user.acct”
“@J:[jobname,]user.acct” - all jobs-only matching
“[jobname,]user.acct”
“@S:[jobname,]user.acct” - all sessions -only matching
“[jobname,]user.acct”
NOTE “jobname”, “user” and “acct” may be wildcarded.
“,user.acct” (empty ‘jobname’) can be passed to specify that only jobs or
sessions without job names are desired. If ‘jobname’ is specified then only
job/sessions with job names are considered.
Joblist_var: Optional. An unquoted name of a CI variable that holds the job/session
numbers that match the ‘job_match’ argument. Each job/session number
is separated by a single space. For example:
“J2 S34 S36 J12 J31 S44”
NOTE It is possible that more jobs match than will fit in the CI variable. In this
event, the variable is filled to capacity without reporting an error. The caller
can detect this condition by comparing the number of jobs matching against
the number of tokens in the ‘joblist_var’ variable.
Example: :calc JOBCNT(“@S”) # find all sessions
Result: 12
Example: :calc JOBCNT(“@J:@.sys”) # find all jobs in SYS account
Result: 4
Example: setvar x JOBCNT(‘@’, jlist) # find all jobs/sessions
if x <> wordcnt(jlist) then
# not all matching job/sessions fit into var
...
Example: :calc JOBCNT(“@!hpjobtype:!hpjobname,!hpuser.!hpaccount”)
Result 1 # find all jobs or sessions logged
# on exactly as “you”