apmproclist
- Organization of this page
Format
-
Windows
apmproclist
-
UNIX
apmproclist [-e | -c | -ec | -cx | -ecx]
Function
The apmproclist command displays all processes running on the executing computer in a list of monitoring process names recognized by APM in the standard output. The output information is different between Windows and UNIX. The following table lists information displayed for each platform:
|
Description |
Windows |
UNIX |
Explanation |
|---|---|---|---|
|
Process ID |
Y |
Y |
Process ID of the target process |
|
Parent Process ID |
Y |
Y |
Process ID of the parent process of the target process |
|
Executable file name |
Y |
Y |
Name of the executable file of the target process. In Windows, the name is displayed without the file extension. |
|
Command line name |
N |
Y |
Command line used for starting the target process |
- Legend:
-
Y: Output available
N: Output not available
Option
-
Windows
None
-
UNIX
-e
Displays the executable file name.
-c
Displays the command line name.
-ec
Displays both the executable file and command line names.
-ex
Displays the executable file name. This option is valid in HP-UX(IPF) only. The maximum length of the command line name is 1,020 bytes.
-ecx
Displays both the executable file and command line names. This option is valid in HP-UX(IPF) only. The maximum length of the command line name is 1,020 bytes.
Usage example
In Windows
![[Figure]](GRAPHICS/SS060345.GIF)
Process information is displayed after the header row. For process information, the process ID and process name are displayed by separating them with a tab.
In UNIX (the -e option):
![[Figure]](GRAPHICS/SS060346.GIF)
Process information is displayed after the header row. For process information, the process ID, parent process ID, and process name (executable file name) are displayed in this order by separating each with one or more spaces. The number of digits in the PID and PPID columns will be the maximum digit count among all process PIDs and PPIDs, respectively. The information displayed in the PID and PPID columns is right-aligned.
In UNIX (the -c option):
![[Figure]](GRAPHICS/SS060347.GIF)
Process information is displayed after the header row. For process information, the process ID, parent process ID, and process name (command line name) are displayed in this order by separating each with one or more spaces. The number of digits in the PID and PPID columns will be the maximum digit count among all process PIDs and PPIDs, respectively. The information displayed in the PID and PPID columns is right-aligned.
In UNIX (the -ec option):
![[Figure]](GRAPHICS/SS060348.GIF)
Process information is displayed after the header row. For process information, the process ID, parent process ID, process name (executable file name), and process name (command line name) are displayed in this order by separating each with one or more spaces. The PID and PPID columns are displayed in the same way as for apmproclist -e. The number of digits in the executable file name column will be the character count of the longest character string of all executable file names. The information displayed in the column is left-aligned.
Display of the command usage
![[Figure]](GRAPHICS/SS060350.GIF)
Return values
|
0 |
Normal termination |
|
1 |
Execution error. A standard error message is output. |
Notes
Use this command as a user belonging to the Administrators group. This command is available regardless of whether the APM services are running or stopped.