rscadm Subcommands

help

This subcommand prints out a basic Help message including a list of rscadm subcommands and a short description of each.

date [-s] date [[mmdd]HHMM|mmddHHMM[cc]yy]][.SS]

Use the date subcommand to show the current date and time; use the -s option to synchronize RSC time to the server time. Supply a date with the subcommand to set RSC time to a time other than the server time.

See "date [[mmdd]HHMM|mmddHHMM[cc]yy][.SS] " for a description of date formats.

set variable value

Use the set subcommand to set a RSC configuration variable. See "RSC Configuration Variables" for descriptions of these variables.

You can use the null string ("") to set a variable to null. To set a variable to a string that includes spaces or UNIX shell special characters, enclose the string in double quotes. For example:

# rscadm set page_info2 ""
# rscadm set page_init1 "&F &E0"

show [variable]

Use the show subcommand to display the value of one or more RSC configuration variables. If you do not specify a variable, RSC displays all configuration variables. See "RSC Configuration Variables" for descriptions of these variables.

resetrsc [-s]

This subcommand resets RSC immediately. To terminate all connections cleanly before the reset, use the -s option. If no argument is supplied, this subcommand performs a hard reset and drops all connections.

download [boot] file

This subcommand supports downloading new firmware residing in file into RSC. If you specify boot, the contents of file will be installed in the boot section of RSC non-volatile memory. If you do not specify boot, the contents of file will be installed in the main firmware section of RSC non-volatile memory.

When the transfer completes, RSC resets itself. If the host keyswitch is in the Lock position, you cannot update RSC firmware, and an error message displays.

send_event [-c] message

Use this subcommand to enter an event into the RSC event log. Use the -c option to also send an alert message that RSC forwards according to the alert configuration. The message is an ASCII string of no more than 80 characters. To use a string that includes spaces or UNIX shell special characters, enclose the string in double quotes.

See Appendix C, Creating a Script That Sends an Alert Message or RSC Event for an example of a Perl script that uses this subcommand to send an alert.

modem_setup

Use this subcommand to change configuration of the modem connected to the RSC serial port. If the modem is properly connected, you can enter standard AT commands and see responses from the modem. At the beginning of a line, enter the escape character (~) followed by a period to exit from this subcommand. Example:

# rscadm modem_setup
AT <enter>
OK
~.
#

The escape sequence for rscadm modem_setup is always ~. The RSC console has a configurable exit character, but the escape character for rscadm modem_setup is hard-coded.

User Account Administration Subcommands

To administer user accounts from the host using rscadm, log in to the host as root and use the rscadm utility with the following subcommands:

• useradd (see "useradd username")

• userdel (see "userdel username")

• usershow (see "usershow [username] ")

• userpassword (see "userpassword username")

• usserperm (see "userperm username [c][u][a][r]")