Retrieves job-process information
| Language element: |
function
|
| Category: |
general-purpose OpenVMS
|
| OpenVMS specifics: |
All aspects are
host-specific
|
- jpi-item
- is a character variable that contains any
item accepted by the F$GETJPI lexical
function, for example, a user process name. For more information about the F$GETJPI lexical
function, see OpenVMS DCL Dictionary.
- pid
- can be either character (process-name variable)
or numeric (process-ID variable). If the PID parameter is a character variable,
GETJPI looks up information for a process whose name matches the value of
the character variable. However, because of the way in which character variables
are passed to functions, the GETJPI function must trim trailing blanks from
the character variable. For this reason, you cannot use character variables
to specify a process name if the process name itself contains trailing blanks.
Instead, you should either use a numeric value to specify the process ID,
or you should omit the trailing blanks from the name of the desired process.
If you do not specify this argument, the current process is used.
The GETJPI function
returns the job-process information as a character string. If the job-process
information string is longer than the length of the target variable, it is
truncated.
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.
