Visit Azul.com Support

Formating Command Sample Options

Need help?
Schedule a consultation with an Azul performance expert.
Contact Us
Looking for Zing?
The Azul Zing Virtual Machine is now Azul Zulu Prime Builds of OpenJDK and part of Azul Platform Prime.
Learn more

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

 
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

 
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