Sun Remote System Control (RSC) User's Guide

rscadm Error Messages

This section offers further explanation of error messages received from the rscadm utility. The last 12 messages are usage error messages.


Passwords didn't match, try again

During execution of the userpassword subcommand, you enter the password twice. If passwords do not match, you are prompted to enter again.


rscadm: all user slots are full

This error occurs if you try to add a user account when RSC already has four accounts configured; RSC supports only four user accounts. You must delete an account before you can add another.


rscadm: command line too long

Check for an extremely long command line.


rscadm: command unknown

You used an invalid rscadm subcommand.


rscadm: could not connect to modem

During execution of the modem_setup subcommand, RSC could not connect to the RSC modem. Is the modem connected? Perhaps the modem is currently being used by the paging subsystem, or RSC is connected to another modem.


rscadm: could not disconnect from modem

During execution of the modem_setup subcommand, RSC refused to disconnect from the modem.


rscadm: could not read date from RSC

An undefined error in RSC firmware occurred when trying to get the RSC date.


rscadm: could not send alert

During execution of the send_event subcommand, RSC firmware couldn't send event.


rscadm: could not set date on RSC

RSC detected an internal error while trying to set the date.


rscadm: couldn't add user

RSC encountered an internal error when trying to add a user account. The RSC SEEPROM may be faulty.


rscadm: couldn't change password

RSC encountered an internal error when trying to change a user password. The RSC SEEPROM may be faulty.


rscadm: couldn't change permissions

RSC encountered an internal error when trying to change user permissions. The RSC SEEPROM may be faulty.


rscadm: couldn't create thread

During execution of the modem_setup subcommand, a thread create call failed.


rscadm: couldn't delete user

RSC encountered an internal error when trying to delete a user account. The RSC SEEPROM may be faulty.


rscadm: couldn't get information on user

RSC encountered an internal error when trying to access user information during a usershow subcommand. The RSC SEEPROM may be faulty.


rscadm: download failed, RSC reported erase error

During execution of the download subcommand, RSC reported a hardware problem when trying to program the RSC EEPROM.


rscadm: download failed, RSC reported int_wp error

During execution of the download subcommand, RSC reported a hardware problem when trying to program the RSC EEPROM.


rscadm: download failed, RSC reported range error

During execution of the download subcommand, RSC reported a hardware problem when trying to program the RSC EEPROM.


rscadm: download failed, RSC reported verify error

During execution of the download subcommand, RSC reported a hardware problem when trying to program the RSC EEPROM.


rscadm: download failed, RSC reported vpp error

During execution of the download subcommand, RSC reported a hardware problem when trying to program the RSC EEPROM.


rscadm: download failed, RSC reported wp error

During execution of the download subcommand, RSC reported a hardware problem when trying to program the RSC EEPROM.


rscadm: download rejected, keyswitch in secure mode?

You cannot execute the download subcommand when the server keyswitch is in the Lock position.


rscadm: either the RSC hardware was not detected or a lock file was found. Only one instance of rscadm can run at a given time.

As stated.


rscadm: Error downloading file

An internal error occurred during execution of the download subcommand.


rscadm: ERROR, callback init failed

An internal error occurred during execution of the download subcommand.


rscadm: ERROR, passwords didn't match

During execution of the userpassword subcommand, you enter the password twice. If passwords do not match, you are prompted to enter again. If they do not match again, the subcommand fails.


rscadm: ERROR, unable to set up message queue

An internal error occurred during execution of the download subcommand.


rscadm: event message can't exceed 80 characters

The message for the send_event subcommand cannot exceed 80 characters.


rscadm: file could not be opened

During execution of the download subcommand, could not open the file specified on the command line.


rscadm: file not a valid s-record

During execution of the download subcommand, the file to download is not a valid s-record file.


rscadm: INTERNAL ERROR in set date

This is an internal rscadm software error.


rscadm: INTERNAL ERROR, overflow in callback

An internal error occurred during execution of the download subcommand.


rscadm: invalid variable

During execution of the set subcommand, you entered an invalid variable. See "RSC Configuration Variables" for correct values.


rscadm: invalid variable or value

During execution of the set subcommand, you entered an invalid variable or value. See "RSC Configuration Variables" for correct values.


rscadm: malformed password

You entered an invalid password. A valid password has between 6 and 8 characters, at least two of which are alphabetic characters, and at least one of which is a numeric or special character.


rscadm: malformed username

You entered invalid characters in a username.


rscadm: maximum username length is - 8

The username you entered exceeded eight characters; the maximum length for username is eight characters.


rscadm: RSC did not respond during boot initialization

An internal error occurred during execution of the download subcommand.


rscadm: RSC failed to respond during download

During execution of the download subcommand, RSC did not enter boot mode correctly.


rscadm: RSC firmware not responding

RSC main firmware is not responding. Perhaps RSC is booting, main firmware is corrupt, or RSC has a hardware problem.


rscadm: RSC not responding to requests

The response expected from RSC was not sent. Is RSC working?


rscadm: RSC returned fatal error

During execution of the download subcommand, RSC returned an undocumented error.


rscadm: RSC returned garbage

This error can occur in various situations; as stated.


rscadm: RSC returned unknown error

During execution of the download subcommand, RSC returned undocumented status (neither success nor failure).


rscadm: RSC returned wrong response

RSC returned an invalid response during a user* subcommand. This is considered an internal error in RSC or rscadm.


rscadm: RSC unable to free up memory

This message can occur in various situations. The rscadm utility was unable to free the received message from the RSC firmware.


rscadm: Unable to reset RSC hardware

During execution of the resetrsc subcommand, an attempt to hard reset RSC failed.


rscadm: unable to send data to RSC

RSC did not acknowledge sent data. Is RSC working?


rscadm: Unable to send modem data to RSC

RSC did not acknowledge data sent to it. Is RSC working?


rscadm: user already exists

The user you are trying to add already has an RSC account on this server.


rscadm: username did not start with letter or did not contain lowercase letter

You used an invalid username format when trying to add an RSC user account.


rscadm: username does not exist

The username you specified is not associated with an RSC account on this server.


This program MUST be run as root

As stated.


USAGE: rscadm <command> [options]

For a list of subcommands, type rscadm help.


USAGE: rscadm date [-s] | [[mmdd]HHMM | mmddHHMM[yyyy]][.SS]

Date parameters have the following ranges:

  • 01 <= mm <= 12

  • 01 <= dd <= 31

  • 01 <= HH <= 23

  • 00 <= MM <= 59

  • 19 <= cc <= 22

  • 00 <= yy <= 99

  • 00<= SS <= 59


USAGE: rscadm download [boot] <file>


USAGE: rscadm resetrsc [-s]


USAGE: rscadm send_event [-c] "message"


USAGE: rscadm set <variable> <value>


USAGE: rscadm show [variable]


USAGE: rscadm useradd <username>


USAGE: rscadm userdel <username>


USAGE: rscadm userpassword <username>


USAGE: rscadm userperm <username> [cuar]

The user you are trying to add already has an RSC account on this server.


USAGE: rscadm usershow [username]