Visit Azul.com Support

Formating Command Sample Options

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 Zulu Prime System Tools (ZST).

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

With no parameters, zing-ps returns the number of Azul Zulu Prime JVM 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