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

154 Chapter6
Technical Articles
ci enhancements
... and various SHOWPROC CIERROR values.
Example 6-2. :calc PINFO('#P123','IPaddr')
Result: 15.192.90.81
Example: :calc PINFO(0,'ExecState')
Result: READY
Example: :calc PINFO(263,'NumProcesses')
Result: 8, $8, %10
Example: :calc PINFO('263','children')
Result: 8/277 281 290 155 120 311 296 315
Example: :calc PINFO( decimal( JINFO( '#J123' , 'CIpin'),'NumOpenFiles')
Result: 10, $A, %12
Example: setvar i HPPIN
(walk up while PINFO( i ,'ProcType') <> 'JSMAIN' do
process setvar i PINFO( i, 'parent')
tree) endwhile
restrictions
PINFO does not allow users to access process data if the same user cannot issue the
SHOWPROC command against the target PIN. Thus, SHOWPROC access rules are
enforced by PINFO. Specifically, the user must have SM or OP capability, or the user must
have AM capability and the target process has the same 'user.account', or the process'
'user.account' matches the user's and JOBSECURITY is low, or the target PIN is actually
the user's PIN. Furthermore, certain items have additional restrictions: to obtain the IP
address the user needs to posses one of: SM, OP, NM, NA or PM capbilities, which are the
same rules enforced by the SHOWCONN utility. To retrieve the program name or the info=
string the user needs full access to the PIN. The info= string has any text that resembles a
lockword blanked out. Enter ':help showproc all' for more details on access and security
rules.
pinfo item values and descriptions
Label Type Description
-------------- ------ --------------------------------------------------
Alive bool True if pin is alive (not dead)
Boosted bool True if pin's priority has been boosted
BoostReason string 'NO BOOST','OWNS PRI SEMA','OWNS SIR','LONG SYS
TRANS','BREAK','BLOCKED UNPREEMPTABLE','IPC SERV
CONTENTION',LONG USER TRANS','OWNS PRI SEMA PORT',
'PRI OSCILLATION'