Communicator e3000 MPE/iX Release 7.0 Express 1 (Software Release C.70.01) (30216-90328)

Chapter 6 153
Technical Articles
ci enhancements
ci enhancements
By Jeff Vance
CSY
enhancements summary:
• The new PINFO evaluator function returns information for a process
• The JINFO function has 4 new items and restriction changes on the IP address, CI PIN
and JSMAIN PIN items.
pinfo
Syntax: PINFO ( pin, item [,status] )
pin Required. String or integer identifying the target process or thread. The
format for pin is:
nnn or '[#P]nnn[.tid]'
where nnn is a simple number and ‘tid’ is the optional thread id. A pin
value of '0' refers to the caller's process.
item Required. String label specifying the information requested for the target
process. Only one item can be requested per call to PINFO, 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 PINFO. If passed, the variable named by this argument contains the
status of the call to pinfo: zero indicates success, non-zero indicates a
failure. When 'status' is passed and an error occurs, the CI ignores the
error. Specifically, no message is written to $STDLIST or to $STDERR,
and the CIERROR variable is not set. The PINFO function return is
always -1 when 'status' is specified and a PINFO error occurs. If this
argument is omitted and an error in PINFO occurs, a CI error message is
written to $STDLIST (within the definition of the HPMSGFENCE
variable).
status values:
0 - success
9952 - unknown PINFO item
9955 - information for the requested item is unavailable for the target
process
9956 - item security violation, the user needs greater privileges to retrieve
the item
11001 - cannot access pin
11004 - process does not exist