LOGIN

Start a secure ICOM/SCOM connection to the receiver

Platform:

OEM729, OEM7600, OEM7700, OEM7720, PwrPak7, CPT7, CPT7700, SMART7-I, SMART7-SI

When ICOM/SCOM ports have security enabled (see the IPSERVICE command), a session to the ICOM/SCOM port can be established but commands are refused until a valid LOGIN command is issued. Both the UserName and Password are required. The LOGIN command checks the supplied credentials against known UserNames/Passwords and determines if the login is successful or not. A successful login permits the secured ICOM/SCOM command interpreter to accept further commands and returns OK. An unsuccessful login does not release the secured ICOM/SCOM command interpreter and returns Login Failed.

If an incorrect password is entered more than 5 times in a row, logins are suspended for 5 seconds after an incorrect password is entered. If an incorrect password is entered more than 10 times in a row, logins are suspended for 10 seconds after an incorrect password is entered.

The consecutive incorrect password count is accumulated across all ports and all commands that use the Admin password.

Entering a LOGIN command on any command port other than the ICOM/SCOM port has no effect, regardless of whether the UserName/Password is correct. In this case, the appropriate response (OK or Login Failed) is returned, but there is no effect on the command interpreter.

When security is enabled, access to the port is restricted unless a valid name and password are supplied. It does not mean there is data encryption enabled. Username is case-insensitive and password is case-sensitive.

Message ID: 1671

Abbreviated ASCII syntax:

LOGIN [commport] UserName Password

ASCII example:

LOGIN ADMIN ADMINPASSWORD

Field	Field type	ASCII value	Binary value	Description	Format	Binary bytes	Binary offset
1	Command header	-	-	LOGIN header This field contains the command name for abbreviated ASCII or the message header for ASCII or Binary.	-	H	0
2	commport	ICOM1	23	The ICOM or SCOM port to log into. This is an optional parameter. If no value is entered, logs in to the ICOM port currently being used. (default=THISPORT)	Enum	4	H
		ICOM2	24
		ICOM3	25
		ICOM4	29
		ICOM5	46
		ICOM6	47
		ICOM7	48
		SCOM1	49
		SCOM2	50
		SCOM3	51
		SCOM4	52
3	username			Provide the user name for the login command. The user name is not case sensitive.	String [32]	variable1 In the binary case, each string field needs to be NULL terminated and additional bytes of padding added to maintain 4-byte alignment, up to the maximum defined by the string size. The next defined field starts immediately at the next 4-byte alignment following the NULL.	H+4
4	password			Provide the password for the user name. The password is case sensitive.	String [28]	variable1	variable