CI Enhancements

• There are three new CI evaluator functions - JINFO, JOBCNT and WORDCNT.

• There are five new CI variables - HPDATETIME, HPDOY, HPHHMMSSMMM, HPLEAPYEAR, HPYYYYMMDD.

• The PAUSE command allows you to select just jobs or just sessions that match "[jobname,]user.account".

• The QUOTE function, introduced late in release 5.5, has been officially removed. It was un-documented in the 6.0 base release and the function has been deleted in 6.0 Express 1. QUOTE was removed because it did not provide useful functionality, and is easy to duplicate using the existing REPL function.

• The DELIMPOS function returns the position (index) of one or more specified delimiters. A defect in DELIMPOS was corrected which could impact some existing CI scripts. Prior to 6.0 express 1, DELIMPOS treated each space in the string as a separate delimiter -- in other words, there was no 'folding' of spaces. In 6.0 express 1, DELIMPOS treats multiple spaces as a single delimiter, just as the WORD function does. In fact, DELIMPOS is consistent with WORD's "endvar" parameter for all cases, except when the string has no matching delimiter. In this situation DELIMPOS returns 0, meaning there was no match; whereas, WORD returns string length plus one.

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:

Some items have additional restrictions:

Label                  Type    Description 
--------------------   ------  -----------------------------------------------Account                string  account name. 
CIpin                  int     * PIN number for the job's usermain process,                                  typically the 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,                                   meaning no new jobs are allowed to log on                                   until disk space is recovered. 
Exist                  bool    True if the target job exists in any state. 
Exists                 bool    See 'Exist'. 
FmtIntroDate           string  formatted date job was introduced, eg. 
                               "WED, JUL 14, 1999". 
FmtIntroTime           string  formatted time job was introduced, eg. "6:21 PM". 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     See "IntIntroDate".
IntroTime              int     See "IntIntroTime".
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), 
                                 "" for jobs and local sessions. 
Job User Account       string  "[jname,]user.acct" names concatenated. 
Job User Account Group string  "[jname,]user.acct,group" names concatenated. 
JobName                string   jobname if supplied, else "". 
JobNum                 string   unique job identifier, "#J|Snnn". 
JobQ                   string   job queue name, "" for sessions 
JobSecurity            bool     ** 'LOW' or 'HIGH' depending on the JOBSECURITY                                    setting. 
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 process. 
LdevIn                 int      Input LDEV number for $STDIN. 
LdevOut                int      Output LDEV number for $STDLIST, 0 for spooled 
                                  jobs. 
LocAttr                int      * user local attributes. 
Numbered               bool     True is job file is numbered. 
Outclass               string   Outclass name for a job's STDLIST, e.g. "LP".                                 Empty ("") for sessions. 
Outpri                 int      output priority. 
PassExempt             string   ** The system's password exemption policy for                                    jobs: "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 is 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 "card". 
State                  string   see "JobState". 
StdinSPID              string   "Innn" identifier for the stdin spoolfile for                                  jobs. 
StdinSPstate           string   STDIN spoolfile state: "OPEN", "ACTIVE", "READY".                                  "" for sessions. 
StdlistDelete          bool     True if SET STDLIST=delete in effect. 
StdlistSPID            string   "Onnn" identifier for the stdlist spoolfile for                                 jobs. "" for sessions. 
StdlistSPstate         string   STDLIST spoolfile state: "CREATE", "DEFER",                                 "READY","XFER", "PRINT", "PROBLM", "DELPND",                                 "SPSAVE". 
                                Note: some of these states apply to jobs that have                                 terminated. No JINFO information is available on                                 jobs that have terminated. 
StreamedBy             string   * full identifier of the job/session that streamed                                   or initiated the target job. For example:                                   "jobname,user.account (#J123)". This is the same                                   value as seen in the HPSTREAMEDBY CI variable. StreamedByDate         int      see "IntStreamedByDate". 
StreamedByLdev         int      * Ldev of job/session that submitted the target                                   job. 
StreamedByTime         int      see "IntStreamedByTime". 
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".*  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.** indicates you must have SM or OP capabilities.