Table 1. General Control Commands
| Command |
Summary Description |
| close |
Closes the currently opened controller |
| exit |
Closes the currently opened controller and exits the CLI |
| help, ? |
Invokes general or topical help |
| history_size |
Sets the size of the history buffer |
| open |
Opens access to a controller |
| reset_window |
Resets the window |
| toggle_more |
Turns on or off the <Press any key to continue> functionality |
The CLI general control commands are discussed in alphabetical order and use the following syntax:
command [subcommand] [/switch{=value}] [parameter]
close
To close the currently opened controller when all access is completed, use the close command.
The close command is not available in the FAST application's Command Prompt window. To close the currently opened controller from the FAST application's Command Prompt window, select Close from the Controller menu. To close the FAST application's Command Prompt window (without closing the controller), select Close from the window's menu.
Syntax
close
exit
To close the currently opened controller and exit the CLI, use the exit command.
The exit command is not available in the FAST application's Command Prompt window. To close the currently opened controller and exit the CLI from the FAST application's Command Prompt window, select Close from the Controller menu.
Syntax
exit
help, ?
To invoke general or topical Help commands, use the help command or the ? (question mark).
Syntax
? [{command}]
{command} ?
help [/full] [{command}]
help [/full} {command subset}
Parameters
- If the command has more subcommands,
help lists the subcommands and their functions. If a complete command is used, such as container list, the CLI help displays all possible switches.
Switches
/full
- Displays all relevant commands along with the command format and all command switches.
history_size
To set the size of the history buffer, use the history_size command.
Command Availability
This command is supported only on UNIX.
Syntax
history_size {buffer_size}
Parameters
{buffer_size}
Specifies the size of the history buffer. The default size is 200.
open
To open a controller, use the open command. The open command prepares a particular controller for access by the CLI. If you specify this command when another controller is open during a particular command session, the CLI closes the currently opened controller and then opens the specified controller.
This command is not available in the FAST application's Command Prompt window.
Syntax
open [/readonly{=boolean}] [/domain{=string}]
[/netware{=boolean}] {string}
Parameters
{string}
- Specifies the computer name and the controller you want to open. For the string, use the standard format
\\nodename\AFAn, where n is the controller number.
- For local controllers, you can omit the
\\nodename in the string specification.
- If the computer name has a dash (-) in the name (for example, proj-athena), enclose the entire string within quotes. For example:
"\\proj-athena\afa0"
Switches
/readonly{=boolean}
- Specifies whether to open the controller for read-only access. A value of
TRUE indicates the CLI opens the controller for read-only access.
- If you do not specify this switch, it defaults to
/readonly=FALSE (which means the CLI opens the controller for read/write access).
- Note that if you open the controller with read-only access, you can use only the commands that do not change the controller configuration.
/netware{=boolean}
- Specifies whether to open the controller on a NetWareTM server. A value of
TRUE indicates the CLI opens the controller for access on a NetWare server. Typically, you use this switch if you want to open a controller that resides on a NetWare system from a Windows NT/Windows 2000 (basic disk only) system.
- If you do not specify this switch, it defaults to
/netware=FALSE (which means the CLI does not open the controller for access on NetWare).
- This switch is supported on the following operating systems:
- Windows NT
- Windows 2000 (basic disk only)
/domain{=string}
- Specifies the domain (the local domain or a trusted domain) in which the specified computer that contains the controller resides. If you do not specify this switch, the CLI assumes the local domain.
- This switch is supported on the following operating systems:
Examples
The following example opens controller 0 read-write on the local computer bulldog:
FASTCMD>open \\bulldog\afa0
The following example opens controller 0 read-only on the remote computer morticia, which resides in the domain DOGBERT:
AFA0>open /readonly=TRUE /domain=DOGBERT \\morticia\afa0
To open controllers that reside on computers in a remote domain you must first use the remote scan command (Windows NT/Windows 2000 (basic disk only) systems only). The remote scan command updates the network connection database for a specified domain. The following example scans a remote domain:
AFA0> remote scan dogbert
"Executing: remote scan "dogbert"
Related Information
remote Commands:
reset_window
To reset the window, use the reset_window command.
Command Availability
This command is supported only on UNIX.
Syntax
reset_window
toggle_more
To turn on or off the <Press any key to continue> functionality, use the toggle_more command.
The toggle_more command is not available in the FAST application's Command Prompt window.
After you type toggle_more on the NetWareTM console, the command displays an appropriate message indicating whether the <Press any key to continue> functionality is on or off.
Command Availability
This command is supported only on NetWare.
Syntax
toggle_more
Back to Contents Page
Note:
You can open controllers for read-write access in any
GUI or CLI session only once per controller. Thereafter, you
(and other users) can open and access the previously
opened controller only in read-only mode.