N1 Grid Service Provisioning System 5.0 Command-Line Interface Reference Manual

udb.sv: Managing Session Variables

You can use the udb.sv commands to manage session variables.

Table 13–17 Summary of udb.sv Commands


Command Name	Description
udb.sv.add	Adds a new session variable.
udb.sv.del	Deletes a session variable.
udb.sv.fl	Flushes all of a user's session variables.
udb.sv.la	Lists all session variables.
udb.sv.lo	Retrieves information about the session variable.
udb.sv.mod	Modifies the specified session value.
udb.sv.re	Reencrypts all of a user's session variables.

udb.sv.add

This command adds a new session variable (a password must be set using the -p parameter if variables are to be persisted).

Note –

If you are logged in to the HTML user interface and you add a session variable through the CLI, the session variable name will display without the value when you refresh the list of variables. To display the new session variable's value, log out of the HTML user interface and log back in.

Table 13–18 Arguments and Result for the udb.sv.add Command


Argument		Syntax	Description
name	[R]	String	The new session variable name
secure	[O]	Boolean	Whether or not the value should be displayed; true means no; default false
desc	[O]	String	The new session variable value description
value	[R]	String	The new session variable value for this user. If the value for the variable is an empty string, enter: `- value ""`
result		SessionVariable	The new session variable

udb.sv.del

This command deletes a session variable.

Table 13–19 Arguments for the udb.sv.del Command


Argument		Syntax	Description
name	[R]	String	The name of the session variable to delete

udb.sv.fl

This command flushes all of a user's session variables.

Table 13–20 Arguments for the udb.sv.fl Command


Argument		Syntax	Description
u	[R]	String	The name of the user
p	[R]	String	The password for the user

udb.sv.la

This command lists all session variables.

Table 13–21 Argument and Result for the udb.sv.la Command


Argument/Result		Syntax	Description
result		SessionVariableSet	The variables available to this user

udb.sv.lo

This command retrieves the specified session variable

Table 13–22 Argument and Result for the udb.sv.lo Command


Argument/Result		Syntax	Description
name	[R]	String	The name of the session variable to show
result		SessionVariable	The session variable

udb.sv.mod

This command modifies a session variable; a password must be set using the -p parameter if variables are to be persisted.

Table 13–23 Argument/Result for the udb.sv.mod Command


Argument/Result		Syntax	Description
name	[R]	String	The name of the session variable to modify
secure	[O]	String	Whether or not the value should be displayed; true means no; default false
desc	[O]	String	The new session variable description
value	[O]	String	The new session variable value for this user
result		SessionVariable	The new session variable

udb.sv.re

This command reencrypts all of a user's session variables.

Table 13–24 Arguments for the udb.sv.re Command


Argument		Syntax	Description
u	[R]	String	The name of the user
p	[R]	String	The password for the user
op	[R]	String	The old password used to encrypt these variables