{"id":7757,"date":"2021-03-24T16:51:26","date_gmt":"2021-03-24T20:51:26","guid":{"rendered":"https:\/\/www.redline13.com\/blog\/?p=7757"},"modified":"2022-05-23T16:49:22","modified_gmt":"2022-05-23T20:49:22","slug":"accessing-jmeter-properties-set-as-command-line-options","status":"publish","type":"post","link":"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/","title":{"rendered":"Accessing JMeter Properties set as Command Line Options"},"content":{"rendered":"

\"Apache<\/a><\/p>\n

One area where JMeter certainly excels is in its seeming infinite extensibility, including a dizzying array of plugins and multiple scripting options on top of an already versatile test designer. Along these lines, here we will be discussing how to set properties as command line options through the Redline13 user interface. Ultimately, these will be passed to load agents running JMeter, but the hard parts will be managed by the RedLine13 service.<\/p>\n

As a standalone tool, JMeter<\/a> extends the ability to import a collection of name-value<\/em> pairs independent of the actual test plan file. This can be particularly useful when we already have a developed test plan, but perhaps wish to change host targets or request options without rewriting the core test architecture each time. Similar to our hypothetical example described below, you may find it necessary to change HTTP request parameters from one test set to the next. Rather than modifying and uploading a new test plan for each run, we can reuse a previous test plan provided that it is somehow configurable. JMeter properties set as command line options are an excellent way to achieve this, simplifying test plan administration and facilitating reuse.<\/p>\n

Among the key benefits of using RedLine13 is the ability to abstract away the burdens of administering JMeter execution on distributed load agents, synchronizing their activity, and monitoring for results. This same level of abstraction forgoes the versatility of the command line. However, RedLine13 has provided a convenient way to specify these options when creating new tests. Due to the very specific syntax (a JMeter requirement) we have assembled some brief instructions on how to accomplish this.<\/p>\n

<\/h3>\n

Part 1.\u00a0 Specifying custom properties<\/strong><\/h3>\n

As specified in the documentation<\/a>, JMeter options when specified from the command line take the following form:<\/p>\n\n\n\n
\n
 -J[prop_name<\/em>]=[value<\/em>] <\/strong><\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Such is, that if we wanted to declare a property named \u201cemail<\/em>\u201d with a value of \u201cjohndoe@redline13.com<\/em>\u201d, we would specify this in the following form:<\/p>\n\n\n\n
\n
 -Jemail=johndoe@redline13.com <\/strong><\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Furthermore, to illustrate specifying multiple options together, we can declare:<\/p>\n\n\n\n
\n
 -Jemail=johndoe@redline13.com -Jcompany=RedLine13 <\/strong><\/span><\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Note that each key-value pair is preceded by the \u201c-J\u201d prefix without<\/em> any separation between the property name.\u00a0 Also note that each name-value pair is<\/em> delimited by a space. You may continue this convention to specify as many options as necessary for your unique test scenario. When using the RedLine13 user interface to start a load test, we have conveniently provided a special input area under \u201cAdvanced JMeter Test Options<\/em>\u201d to specify the entire JMeter option string:<\/p>\n
\"The<\/p>\n
Subsequently on completed load tests, you may view which JMeter options have been set under the \u201cTest Opts<\/em>\u201d heading which is listed under \u201cDetails<\/em>\u201d on the results page.<\/p>\n
Part 2.\u00a0 Accessing custom properties within JMeter test plans<\/strong><\/h3>\n
Now that we have covered how to set<\/em> custom properties, we will need to reference those properties in order to use them within our actual JMeter test plan. Just as with specifying these properties at the command line, there is a specialized syntax for reading them into JMeter.<\/p>\n
As an introduction, there is a built-in JMeter function \u201c__P()<\/strong><\/span>\u201d which is documented here<\/a>. By referring to this function in your test plan, you can directly access predefined properties that have been specified at the command line via the manner outlined above. Typically this call is wrapped in ${…}<\/strong><\/span> so that it can be referenced from fields which normally contain literals. (In another post<\/a>, we also outline accessing properties for a different purpose.) For example, the following value will pull a property declared as \u201cemail\u201d into a request string of an HTTP Request<\/a> sampler:<\/p>\n
http:\/\/www.domain.com\/page?account=${__P(email)}<\/strong><\/span><\/pre>\n
From within JMeter this can be set up as follows:<\/p>\n
\"Setting<\/a><\/p>\n
The end result is that you are now able to construct generic test plans, and easily modify them from the RedLine13 user interface. This makes it possible to tailor them to specific use cases without the need to change the test plan itself. Of course, these are simple examples designed to illustrate the basic concepts. However, by building upon this using more complex test elements and scripting, the possibilities are practically endless. Try this for yourself today with a free RedLine13<\/a> trial account.<\/p>\n","protected":false},"excerpt":{"rendered":"
One area where JMeter certainly excels is in its seeming infinite extensibility, including a dizzying array of plugins and multiple scripting options on top of an already versatile test designer. Along these lines, here we will be discussing how to set properties as command line options through the Redline13 user interface. Ultimately, these will be passed to load agents running JMeter, but the hard parts will be managed by the RedLine13 service. As a standalone tool,Read More →<\/a><\/p>\n","protected":false},"author":1,"featured_media":7763,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2,7],"tags":[135,283,293,424],"class_list":{"0":"entry","1":"post","2":"publish","3":"author-user","4":"post-7757","6":"format-standard","7":"has-post-thumbnail","8":"category-blog","9":"category-jmeter","10":"post_tag-command-line","11":"post_tag-jmeter","12":"post_tag-jmeter-properties","13":"post_tag-redline13"},"yoast_head":"\nAccessing JMeter Properties set as Command Line Options - RedLine13<\/title>\n<meta name=\"description\" content=\"Make your tests more versatile and reusable with JMeter properties referenced inside your test plan, while RedLine13 abstracts away command line woes.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Accessing JMeter Properties set as Command Line Options - RedLine13\" \/>\n<meta property=\"og:description\" content=\"Make your tests more versatile and reusable with JMeter properties referenced inside your test plan, while RedLine13 abstracts away command line woes.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/\" \/>\n<meta property=\"og:site_name\" content=\"RedLine13\" \/>\n<meta property=\"article:published_time\" content=\"2021-03-24T20:51:26+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2022-05-23T20:49:22+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.redline13.com\/blog\/wp-content\/uploads\/2021\/03\/JMeter-options-art.png\" \/>\n\t<meta property=\"og:image:width\" content=\"740\" \/>\n\t<meta property=\"og:image:height\" content=\"384\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"RedLine13\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"RedLine13\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/\"},\"author\":{\"name\":\"RedLine13\",\"@id\":\"https:\/\/www.redline13.com\/blog\/#\/schema\/person\/4acbcdcb8a9c72ec5a274e69c0ebea28\"},\"headline\":\"Accessing JMeter Properties set as Command Line Options\",\"datePublished\":\"2021-03-24T20:51:26+00:00\",\"dateModified\":\"2022-05-23T20:49:22+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/\"},\"wordCount\":685,\"publisher\":{\"@id\":\"https:\/\/www.redline13.com\/blog\/#organization\"},\"keywords\":[\"command line\",\"JMeter\",\"JMeter properties\",\"RedLine13\"],\"articleSection\":[\"Blog\",\"JMeter\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/\",\"url\":\"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/\",\"name\":\"Accessing JMeter Properties set as Command Line Options - RedLine13\",\"isPartOf\":{\"@id\":\"https:\/\/www.redline13.com\/blog\/#website\"},\"datePublished\":\"2021-03-24T20:51:26+00:00\",\"dateModified\":\"2022-05-23T20:49:22+00:00\",\"description\":\"Make your tests more versatile and reusable with JMeter properties referenced inside your test plan, while RedLine13 abstracts away command line woes.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.redline13.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Accessing JMeter Properties set as Command Line Options\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.redline13.com\/blog\/#website\",\"url\":\"https:\/\/www.redline13.com\/blog\/\",\"name\":\"RedLine13\",\"description\":\"(Almost) Free Load Testing in the Cloud\",\"publisher\":{\"@id\":\"https:\/\/www.redline13.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.redline13.com\/blog\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.redline13.com\/blog\/#organization\",\"name\":\"RedLine13\",\"url\":\"https:\/\/www.redline13.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.redline13.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.redline13.com\/blog\/wp-content\/uploads\/2013\/06\/cropped-rl13-header-logo.jpg\",\"contentUrl\":\"https:\/\/www.redline13.com\/blog\/wp-content\/uploads\/2013\/06\/cropped-rl13-header-logo.jpg\",\"width\":300,\"height\":68,\"caption\":\"RedLine13\"},\"image\":{\"@id\":\"https:\/\/www.redline13.com\/blog\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.redline13.com\/blog\/#\/schema\/person\/4acbcdcb8a9c72ec5a274e69c0ebea28\",\"name\":\"RedLine13\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.redline13.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514?s=96&d=mm&r=g\",\"caption\":\"RedLine13\"},\"sameAs\":[\"http:\/\/127.0.0.1\"],\"url\":\"https:\/\/www.redline13.com\/blog\/author\/user\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Accessing JMeter Properties set as Command Line Options - RedLine13","description":"Make your tests more versatile and reusable with JMeter properties referenced inside your test plan, while RedLine13 abstracts away command line woes.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/","og_locale":"en_US","og_type":"article","og_title":"Accessing JMeter Properties set as Command Line Options - RedLine13","og_description":"Make your tests more versatile and reusable with JMeter properties referenced inside your test plan, while RedLine13 abstracts away command line woes.","og_url":"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/","og_site_name":"RedLine13","article_published_time":"2021-03-24T20:51:26+00:00","article_modified_time":"2022-05-23T20:49:22+00:00","og_image":[{"width":740,"height":384,"url":"https:\/\/www.redline13.com\/blog\/wp-content\/uploads\/2021\/03\/JMeter-options-art.png","type":"image\/png"}],"author":"RedLine13","twitter_card":"summary_large_image","twitter_misc":{"Written by":"RedLine13","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/#article","isPartOf":{"@id":"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/"},"author":{"name":"RedLine13","@id":"https:\/\/www.redline13.com\/blog\/#\/schema\/person\/4acbcdcb8a9c72ec5a274e69c0ebea28"},"headline":"Accessing JMeter Properties set as Command Line Options","datePublished":"2021-03-24T20:51:26+00:00","dateModified":"2022-05-23T20:49:22+00:00","mainEntityOfPage":{"@id":"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/"},"wordCount":685,"publisher":{"@id":"https:\/\/www.redline13.com\/blog\/#organization"},"keywords":["command line","JMeter","JMeter properties","RedLine13"],"articleSection":["Blog","JMeter"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/","url":"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/","name":"Accessing JMeter Properties set as Command Line Options - RedLine13","isPartOf":{"@id":"https:\/\/www.redline13.com\/blog\/#website"},"datePublished":"2021-03-24T20:51:26+00:00","dateModified":"2022-05-23T20:49:22+00:00","description":"Make your tests more versatile and reusable with JMeter properties referenced inside your test plan, while RedLine13 abstracts away command line woes.","breadcrumb":{"@id":"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.redline13.com\/blog\/2021\/03\/accessing-jmeter-properties-set-as-command-line-options\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.redline13.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Accessing JMeter Properties set as Command Line Options"}]},{"@type":"WebSite","@id":"https:\/\/www.redline13.com\/blog\/#website","url":"https:\/\/www.redline13.com\/blog\/","name":"RedLine13","description":"(Almost) Free Load Testing in the Cloud","publisher":{"@id":"https:\/\/www.redline13.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.redline13.com\/blog\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.redline13.com\/blog\/#organization","name":"RedLine13","url":"https:\/\/www.redline13.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.redline13.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.redline13.com\/blog\/wp-content\/uploads\/2013\/06\/cropped-rl13-header-logo.jpg","contentUrl":"https:\/\/www.redline13.com\/blog\/wp-content\/uploads\/2013\/06\/cropped-rl13-header-logo.jpg","width":300,"height":68,"caption":"RedLine13"},"image":{"@id":"https:\/\/www.redline13.com\/blog\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/www.redline13.com\/blog\/#\/schema\/person\/4acbcdcb8a9c72ec5a274e69c0ebea28","name":"RedLine13","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.redline13.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514?s=96&d=mm&r=g","caption":"RedLine13"},"sameAs":["http:\/\/127.0.0.1"],"url":"https:\/\/www.redline13.com\/blog\/author\/user\/"}]}},"_links":{"self":[{"href":"https:\/\/www.redline13.com\/blog\/wp-json\/wp\/v2\/posts\/7757","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.redline13.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.redline13.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.redline13.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.redline13.com\/blog\/wp-json\/wp\/v2\/comments?post=7757"}],"version-history":[{"count":1,"href":"https:\/\/www.redline13.com\/blog\/wp-json\/wp\/v2\/posts\/7757\/revisions"}],"predecessor-version":[{"id":9669,"href":"https:\/\/www.redline13.com\/blog\/wp-json\/wp\/v2\/posts\/7757\/revisions\/9669"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.redline13.com\/blog\/wp-json\/wp\/v2\/media\/7763"}],"wp:attachment":[{"href":"https:\/\/www.redline13.com\/blog\/wp-json\/wp\/v2\/media?parent=7757"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.redline13.com\/blog\/wp-json\/wp\/v2\/categories?post=7757"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.redline13.com\/blog\/wp-json\/wp\/v2\/tags?post=7757"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}