Formating Command Sample Options

Need help?

Schedule a consultation with an Azul performance expert.

The examples in the following subsections provide sample format command options to use with Azul Zing System Tools (ZST).

Example 1: No Parameters Used, Returns the Number of Azul Zing Builds of OpenJDK (Zing) Processes.

With no parameters, zing-ps returns the number of Zing processes and memory usage for each itemized process. The -j option conditions are used as the default option for formatting the CMD field.

 $ zing-ps
Found 2 processes
USER  PID    TIME    LRSS  ZRSS Xmx    CTG   PP JSYS CMD
user1 27960 12:19:09 116  4048  10240  0     0   6  java -jar ZingJMM.jar
user2 27758 00:00:55 105  564   1024   0     0   2  java -jar be

Example 2: Comma Separated.

The –comma option includes commas as a separator between table columns. This format can be imported into CSV accepting tool, such as Excel. The option applies to all table formats. Sufficient commas are included to align all columns.

 zing-ps -s --comma

System Zing Memory reserved at process launch (reserve-at-launch)

Memory Usage Summary	Physical	Linux	Zing	Reservable	Contingency	PausePrev
Used:	61495	39343	22152	11264	0	0
Free:	83717	-	-	-	5444	5444
Total:	145212	-	22152	11264	5444	5444
UpperLimit:	-	-	108908	98020	5444	5444

 USER , PID, TIME, LRSS, ZRSS, Xmx, CTG, PP, JSYS, CMD
user1 , 27960, 12:19:09, 116, 4048, 10240, 0, 0, 6, java -cp ZingJMM.jar org.openjdk.jmh.runner.ForkedMain 127.0.0.1 39602
user2 , 27758, 00:00:55, 105, 564, 1024, 0, 0, 2, java -jar benchmarks.jar -wi 50000 -i 100000 -jvmArgs=-Xmx10g

Example 3: CMD Column Options.

Select one command (CMD) column display option at a time: -a, -c, -j, or -n.

Using the -a option displays all the arguments included in the command used to initiate the process.

 $ zing-ps -a
Found 1 processes
USER   PID  TIME    LRSS ZRSS Xmx CTG PP JSYS CMD
user2 27758 00:00:56 105 564 1024 0   0   2 <my dir>/jdk7/x86_64/product/bin/java -jar target/benchmarks.jar -wi 50000 -i 100000 -jvmArgs=-Xmx10g -XX:ARTAPort=7890

Using the -c option displays the command used to initiate the process without the command options.

 $ zing-ps -c
Found 1 process
USER  PID    TIME    LRSS ZRSS Xmx CTG PP JSYS CMD
user2 27758 00:00:57 105  564  1024  0  0   2 <my dir>/jdk7/x86_64/product/bin/java

Using the -j option displays pre-defined options from the command used to initiate the process. This is the default zing-ps return.

 $ zing-ps -j
Found 1 processes
USER   PID   TIME   LRSS ZRSS Xmx CTG PP JSYS CMD
user2 27758 00:00:57 105 564  1024  0  0   2 java -jar benchmarks.jar -wi 50000 -i 100000 -jvmArgs=-Xmx10g
Using the -n option displays only the name of the command used to initiate the process.
$ zing-ps -n
Found 1 processes
USER  PID    TIME   LRSS ZRSS Xmx CTG PP JSYS CMD
user2 27758 00:00:57 105 564 1024 0   0   2  java

Example 4: Units Displayed Options.

Select one unit display option at a time: -b, -h, or -m.

Using the -b option displays the memory values in bytes. Fund and per-process account information is in bytes by default, unless otherwise noted.

 $ zing-ps -b
Found 1 processes
USER   PID   TIME     LRSS     ZRSS         Xmx       CTG  PP     JSYS     CMD
user1 27960 12:19:11 122134528 4244316160 10737418240 0    0      6049792 java -cp ZingJMM.jar org.openjdk.jmh.runner.ForkedMain 127.0.0.1 39602

Using the -h option displays the memory values in human readable values rounded to the units as noted K=Kilo, M=Mega, G=Giga, T=Tera.
```
 $ zing-ps -h
Found 1 processes
USER    PID   TIME   LRSS   ZRSS   Xmx CTG PP JSYS   CMD
user1 27960 12:19:11 116 M 4048 M 10 G   0  0 5908 K java -cp ZingJMM.jar org.openjdk.jmh.runner.ForkedMain 127.0.0.1 39602
```
Using the -m option displays the memory values in megabytes. No suffix is included. This is the default value.

 $ zing-ps -m
Found 2 processes
USER   PID     TIME LRSS ZRSS Xmx  CTG PP JSYS CMD
user1 27960 12:19:11 116 4048 10240 0  0    6 java -cp ZingJMM.jar org.openjdk.jmh.runner.ForkedMain 127.0.0.1 39602
user2 27758 00:00:58 105 564 1024   0  0    2 java -jar benchmarks.jar -wi 50000 -i 100000 -jvmArgs=-Xmx10g

Sample using -h with -s options.
```
 zing-ps -s -h
```

Memory Usage Summary	Physical	Linux	Zing	Reservable	Contingency	PausePrev
Used:	60 G	39 G	22 G	11 G	0	0
Free:	82 G	-	-	-	5444 M	5444 M
Total:	142 G	-	22 G	11 G	5444 M	5444 M

Memory Usage Summary

Physical

Linux

Zing

Reservable

Contingency

PausePrev

Used:

60 G

39 G

22 G

11 G

Free:

82 G

5444 M

Total:

142 G

22 G

11 G

5444 M

 Found 2 processes
USER    PID    TIME   LRSS ZRSS    Xmx CTG PP JSYS    CMD
user1 27960 12:19:11 116 M 4048 M 10 G   0  0 5908 K java -cp ZingJMM.jar org.openjdk.jmh.runner.ForkedMain 127.0.0.1 39602
user2 27758 00:00:58 105 M 564 M 1024 M  0  0 1664 K java -jar benchmarks.jar -wi 50000 -i 100000 -jvmArgs=-Xmx10g

Example 5: Details of Specific Process by Process ID (PID).

Using the -p [PID] option lists the memory information for the specified process only.

 $ zing-ps -p 27960
Found requested process 27960
USER   PID    TIME  LRSS ZRSS Xmx  CTG PP JSYS CMD
user1 27960 12:19:11 116 4048 10240 0   0  6   java -cp ZingJMM.jar org.openjdk.jmh.runner.ForkedMain 127.0.0.1 39602

Example 6: Advanced Usage Information for Processes.

Using the -x option gives extended information about process zing memory usage, which include peak and limit for contingency, pause prevention and Java system memory.

 $ zing-ps –x

Found 2 processes
USER   PID    TIME  LRSS ZRSS Xmx  CTG CPK CMX PP PPK PMX JSYS JSPK JSMX CMD
user1 27960 12:19:12 116 4048 10240 0   0  5444 0  0  5444 6    6    616 java -cp ZingJMM.jar org.openjdk.jmh.runner.ForkedMain 127.0.0.1 39602
user2 27758 00:00:58 105 564 1024   0   0  5444 0   0 5444 2    6    62  java -jar benchmarks.jar -wi 50000 -i 100000 -jvmArgs=-Xmx10g

Example 7: Details of Specific Zing Partition.

Using the -partition <Partition> option gives memory usage and process information for specified partition.

Partition 1: Zing Memory reserved at process launch (reserve-at-launch)

Partition 1 Summary	Physical	Linux	Zing	Reservable	Contingency PausePrev
Used:	N/A	N/A	0	0	0
0	Free:	N/A	N/A	-	-
0	0	Total:	N/A	N/A	-
0	0	0	UpperLimit:	N/A	N/A

 Partition 1: Found 1 process
USER   PID    TIME   LRSS ZRSS Xmx CTG PP CMD
user1 33996 13:56:04 727   904 1024 0   0 java -tiered -jar start.jar

Example 8: Details of Best Effort Account.

Using the -e option gives memory usage information for best effort account.
```
 zing-ps -s -h -e –x
```

System Zing Memory reserved at process launch (reserve-at-launch)

Memory Usage Summary	Physical	Linux	Zing	Reservable	Contingency	PausePrev
Used:	41 G	2129 M	39 G	30 G	8668 M	0
Free:	101 G	-	-	-	200 M	200 M
Total:	142 G	-	39 G	30 G	8868 M	200 M
UpperLimit:	-	-	128 G	121 G	71 G	71 G

Memory Usage Summary

Physical

Linux

Zing

Reservable

Contingency

PausePrev

Used:

41 G

2129 M

39 G

30 G

8668 M

Free:

101 G

200 M

Total:

142 G

39 G

30 G

8868 M

200 M

UpperLimit:

128 G

121 G

71 G

 Found 1 process
USER   PID    TIME   LRSS ZRSS Xmx CTG CPK CMX PP PPK PMX JSYS JSPK JSMX BE BEPK BER BEMX CMD
root 27130 00:01:45 140 M  33 G 30 G 0   0 - 0 0 - 3300 K 8192 K 1844 M 8078 M 8078 M 8668 M 51 G java -cp ALF-ALL.jar:. BEE_Test_Runtime 92000 -f zingps.log

Where:

BEPK = Best Effort Memory peak
BER = Best Effort Memory reserved
BEMX = Best Effort Memory limit
BE = Best Effort contigency