Previous Topic

Next Topic

Display a list of variables (directory/variable or lsvar)

The DIRECTORY command is used to display the directory of variables and to display the value of the variables. The evaluated result of a variable expression can also be displayed using the qualifier.

Windows/OpenVMS Format:

directory/variable variable [/qualifiers]

UNIX/Linux Format:

lsvar variable [-qualifiers]

Qualifier Summary

/columns or -columns=number

/hostname or -node =hostname

/noheading or -noheading

/notrailing or -notrailing

/now or -now=projected_time

/output or -output=output_file

/type or -type=var_type

/symbol or -symbol[= prefix_string,format] (default = sv)

/template or -template=prefix_string

Examples

Windows/OpenVMS:

Schedule> directory/variable/full tomorrow
Comment = "Displays tomorrow's date"
Type = Expression
Value = ""TODAY" + 1 DAY"
Result = "August 11, 2013, 0:00"

UNIX/Linux:

Schedule> lsvar -value maycheck
Variable Directory /davis
  maycheck           "NO"
Total of 1 variable

Qualifiers

/columns or -columns=number

The COLUMNS qualifier specifies how many columns to use when listing just the item name. The default is four columns.

/comment or -comment

The COMMENT qualifier is the comment that is associated with a variable.

/hostname or -node =hostname

The qualifier specifies what node (either local or remote) you want the operation performed on.

/full or -full

The FULL qualifier displays any comments, a variable's value and its type. In the case of a variable expression, it displays the resulting value when the expression is evaluated.

/noheading or -noheading

The NOHEADING removes the heading information from the directory listing.

/notrailing or -notrailing

The NOTRAILING removes the trailing information from the directory listing.

/now or -now=projected_time

The NOW qualifier displays the resulting value of the evaluation takes place in the time designated (Expression variables only).

/output or -output=output_file

The OUTPUT option sends all output to a text file. Output can be printed or displayed as needed.

/symbol or -symbol[=prefix_string]

The SYMBOL command requests that all job information be output to environmental variables. The environmental variable is constructed by prefixing the field name with the provided string. If none is provided a default value of SV is used. To display the environmental variables output from the /symbol qualifier use:

The format defines the way that symbols are output. The default output specification is: "$ %s=\" %s\" "" which produces the following format style.

SV_TYPE = "String"

Alternate output styles may be created by changing the format field.

/template=<schedule_directory>template_db.schedule

The TEMPLATE command formats the directory output as it is defined in the template file. This output can be used for a variety of reasons and can be output to a file using the OUTPUT . The supplied template file extracts all database information into a format suitable for insertion if desired.

/type or -type

The type qualifier is the type of the variable. The two types are "string" for a string variable and "expression" for a variable expression.

/value or -value

The VALUE qualifier is used to display the contents of the variable. This value can be any alphanumeric characters up to 256 characters long.

See Also

VARIABLE commands

Copy a variable (copy/variable or cpvar)

Create a variable (create/variable or mkvar)

Delete a variable (delete/variable or rmvar)

Modify a variable (modify/variable or chvar)

Rename a variable (rename/variable or mvvar)