---
title: "Using List Variable Types"
canonical: "https://docs.infoblox.com/space/NCSG/23199834/Using%20List%20Variable%20Types"
format: markdown
---
CCS can reference lists in the NetMRI system (lists are edited and imported in the **Configuration** **Management** **–>** **Job** **Management** tab **–>** **Lists** page). The following arguments are used by CCS when declaring list variables in a Script-Variables section:

`$variableName list "list_name","key_column","key_value","returnvalue_column","default"`

The value` $variableName` is the name of the variable to which the result of the list lookup will be assigned. The `list` keyword is required. The third argument consists of the following: In the given `list_name`, in the `key_column`, look for the first match of the specified` key_value` from top to bottom of the list. If a match is found, return the value contained in the `returnvalue_column` in the same row in which the match was found, else, return the `default` response. Omitting the optional `default` argument is the same as specifying a default argument of ""; in other words, an empty string.

An example:

`$oscheck list zoneID,serveraddr,eng.corp100.com,ostype,NOMATCH`

Here, a list called **zoneID** is present (or presumed to be present) in the NetMRI **Lists** page, instructing to search in the column **serveraddr** for the key_value **eng.corp100.com**, and if a match is found, return the value found in the matching row's **ostype** column into the variable `$oscheck`. If no match occurs, the string NOMATCH is assigned to the variable `$oscheck`.

Also see the section *<span style="color: #0000ff">[The](https://infoblox-docs.atlassian.net/wiki/spaces/NCSG/pages/23199984)</span>*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCSG/pages/23199984)*<span style="color: #0000ff">[getListValue(](https://infoblox-docs.atlassian.net/wiki/spaces/NCSG/pages/23199984)</span>*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCSG/pages/23199984)*<span style="color: #0000ff">[)](https://infoblox-docs.atlassian.net/wiki/spaces/NCSG/pages/23199984)</span>*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/NCSG/pages/23199984)*<span style="color: #0000ff">[Function](https://infoblox-docs.atlassian.net/wiki/spaces/NCSG/pages/23199984)</span>* for more information about using list data in CCS scripts.