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

18 Chapter3

Technical Articles

CI Enhancements

by Jeff Vance,

Commercial Systems Division

Enhancements Summary

MPE/iX Release 6.0 Express 1 contains the following CI enhancements:

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

• There are ﬁve 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 ofﬁcially 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 speciﬁed 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.

JINFO

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

jobID Required. String identifying the target job or session that information is

being requested for. Format is “[#]J|Snnn”,or“0”, indicating the current

job or session.

item Required. String label specifying the information requested for the target

job or session. Only one item can be requested per call to JINFO, although

some of the items below return multiple pieces of information.

status Optional. An unquoted CI variable name to hold the integer status value

for JINFO. If passed, the variable named by this argument contains the

status of the call to jinfo: zero indicates success, non-zero indicates a

failure. When ‘status’ is passed and an error occurs, the CI ignores the

error. Speciﬁcally, no message is written to $STDLIST or to $STDERR, and

the CIERROR variable is not set. The JINFO function return is always -1

when ‘status’ is speciﬁed and a JINFO error occurs. If this argument is

omitted and an error in JINFO occurs, a CI error message is written to