Cisco Nexus 5000 Series Switch CLI Software Configuration Guide, NX-OS 4.0(1a)N1 (OL-16597-01, January 2009)

Send feedback to [e-mail]
2-9
Cisco Nexus 5000 Series Switch CLI Software Configuration Guide
OL-16597-01
Chapter 2 Using the Command-Line Interface
Using CLI Variables
Using CLI Variables
The Cisco Nexus 5000 Series CLI parser supports the definition and use of variables in CLI commands.
CLI variables can be used as follows:
• Entered directly on the command line.
• Passed to the child script initiated using the run-script command.
The variables defined in the parent shell are available for use in the child run-script command
process (see the “Executing Commands Specified in a Script” section on page 2-11).
• Passed as command line arguments to the run-script command (see the “Executing Commands
Specified in a Script” section on page 2-11).
CLI variables have the following characteristics:
• You cannot reference a variable through another variable using nested references.
• You can define persistent variables that are available across switch reloads.
• You can reference only one predefined system variable, which is the TIMESTAMP variable.
User-Defined Persistent CLI Variables
You can define CLI session variables to persist only for the duration of your CLI session using the cli
var name command in EXEC mode. CLI session variables are useful for scripts that you execute
periodically.
The following example shows how to create a user-defined CLI session variable:
switch# cli var name testinterface fc 1/1
You can reference a variable using the syntax $(variable). The following example shows how to
reference a user-defined CLI session variable:
switch# show interface $(testinterface)
fc2/1 is up
Hardware is Fibre Channel, SFP is short wave laser w/o OFC (SN)
Port WWN is 20:01:00:0d:ec:0e:1d:00
Admin port mode is auto, trunk mode is on
snmp traps are enabled
Port mode is F, FCID is 0x01000b
Port vsan is 1
Speed is 2 Gbps
Transmit B2B Credit is 7
Receive B2B Credit is 16
Receive data field Size is 2112
Beacon is turned off
5 minutes input rate 256 bits/sec, 32 bytes/sec, 1 frames/sec
5 minutes output rate 256 bits/sec, 32 bytes/sec, 1 frames/sec
232692 frames input, 7447280 bytes
0 discards, 0 errors
Zone
zone name string vsan vsan-id switch(config-zone)#
Zone set
zoneset name name vsan vsan-id switch(config-zoneset)#
Table 2-3 Common Configuration Submodes (continued)
Submode Name From Configuration Mode, Enter: Submode Prompt