Deployment Guide

Fabric OS Command Reference 1039

53-1003131-01

setContext

Sets the logical switch context to a specified FID.

SYNOPSIS setcontext [FID | switchname]

DESCRIPTION Use this command to set the logical switch context to a specified fabric ID (FID) or unique switch name.

The FID uniquely defines a partition as a logical switch. Use lscfg --show to display currently configured

partitions and their FIDs.

A logical switch context defines the boundaries within which a user can execute commands in a Virtual

Fabric-aware environment. In a Virtual Fabric-aware environment, all commands are context-specific.

When a user executes a switch-wide command, the command applies to the current logical switch

context.

On legacy platforms, or if a logical switch context is not set explicitly, switch commands apply to the

default logical switch context (FID 128). When the context is changed, switch-wide commands apply to

the new logical switch context.

You must have chassis permissions to access all logical switches in the chassis and to use the

setContext command to change the current context to any partition configured on the chassis. A user

without chassis permissions can change contexts only within the list of FIDs specified in the user's

access permissions. Refer to userConfig for more information.

NOTES The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in

place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for

details.

If a logical switch FID is deleted, users logged in to that switch are logged out.

OPERANDS This command has the following operand:

FID

Specifies the fabric ID of the logical switch instance for which the context is set.

switchname

Specifies the name of the logical switch for which the context is set.

EXAMPLES To change the logical switch context to FID 20:

switch:admin> setcontext 20

To change the logical switch context to switch_20:

switch:admin> setcontext switch_20