Figure 16 Sample Compare Current Devices list
Firmware The software that resides in the EPROMs in many of the AXCESS devices. This software makes these devices operate. Figure 17 Show Current Versions window

Show current versions

When this option is selected, AXCESS displays a list of the devices present in the system, along with the firmware version of the device (if applicable). An example Show Current Versions window is shown in Figure 17.

Watch variables

This option opens the Variable Watch window, which allows you to observe the contents of selected variables while the program is running. When this option is selected, AXCESS prompts you for the type of variable to watch.

Communications Menu

Press <F4> to open the Communications menu, shown in Figure 18. This menu lets you communicate directly to the Central Controller. In addition, AXCESS can be configured to fit some of your specifications, including the baud rate and the selection of communications ports and printer ports.
Figure 18 Communications menu

Terminal emulator

Dumb terminal A serial communications device. Whatever you type goes out the communications port, and whatever comes in the port is displayed on the screen.
This option puts the AXCESS system into a dumb terminal mode. Anything that is typed on the screen exits through the communications port, and anything coming in from the communications port is displayed on your monitor. This mode is used to communicate directly to the Central Controller, modems or other RS-232 devices, and to debug RS-232-controlled devices. Pressing <CTRL-T > also activates the terminal emulator command.

Configure

This option lets you choose which communications port, baud rate, and printer port you need for the AXCESS system. Select Configure to open a window listing the choices, as shown in (Figure 19). With the arrow keys, move the cursor next to the item you need to change. Pressing <Enter> selects that item. Selected items are indicated by a check mark
Figure 19 Configure window

Send file

This option is not the same as the Send option in the AX File menu. Instead, it allows you to transfer files between two computers through a connecting serial cable or modem. Both computers must be running the AXCESS program to complete the transfer.

Receive file

This option works in conjunction with the Send file option. Once two computers are connected with a serial cable or modem, select Send file on the computer that contains the file to be sent. Select Receive file on the other computer to begin transferring the data.

Pass thru

This option allows you to pass data between two of the computers communications ports. All data going in one port comes out the other, and vice versa. Immediately after you select this option, a window appears allowing you to select the two communications ports you wish to use, as shown in Figure 20.

Figure 20 Pass Thru window
When you have selected two communications ports, press <F10> to establish the pass-thru connection. A window on the screen will show the number of characters of data being received by each port. Pressing the <Esc> key quits the pass-thru.

Help Menu

Note For this menu to work, the file HELP.OVL must be present in the current directory. Figure 21 Help menu
Press <F6> to open the Help menu, shown in Figure 21. The Help menu provides brief definitions of keywords, a short sample program, a list of AXCESS cards, AXCESS boxes and AXCESS panels. The help menu also contains a list of SYSTEM_CALL s and Master (error) Messages.

Help on Help

Contains brief instructions on how to use the Help menu. Use the cursor keys to highlight a topic. Press Enter to select. Press <F10> to back up one level.

Editor

The Editor menu item contains two options in a sub-menu: Edit Concepts Contains a brief description of the text editor, and related concepts including the status bar, insert/overwrite mode, and text blocking. Refer to the Text Editor section for detailed information on the text editor. Edit Keys Contains a list of commands used in the editor. Refer to Editing commands in the Text Editor section for a list of the editor commands.

Keywords

Contains brief descriptions of all AXCESS keywords. Keywords include TIME , DATE and DAY keywords, INCLUDE_FILE and SYSTEM_CALL keywords, and VARIABLE and CONVERSION keywords. For a complete listing of AXCESS keywords, refer to Section A of the Appendix.

Sample Program

This menu item opens a sample AXCESS program. The purpose of the "Sample" program is to show the correct structure and format of a basic AXCESS program.

AXCESS Cards

Contains a list of AXCESS cards.

AXCESS Boxes

Contains a list of AXCESS boxes.

AXCESS panels &.

Contains a list of AXCESS panels.

NEW_CALLS

Contains a list of NEW_CALL s, categorized by type, as shown in Figure 22:

Figure 22

NEW_CALLS listed by type in
NEW_CALLS Generic button calls Audio Calls CAMERA Calls CASSETTE Calls CD Calls DAT Calls DVD Calls Joystick Calls LASER DISC Calls PRODIGY Calls MISCELLANEOUS Calls SLIDE Calls SCREEN Calls SWITCHER Calls VCR Calls 1-5 VCR Calls 6-10 VOLUME Calls Video Proj Calls OLD to NEW

considered to be wrong. When you define VHS2 in the appropriate section, all the other lines are correct. When the program is recompiled, those errors are repaired. You can remove the error window if you need more space on the screen, if for example there is a large number of errors in a particular section. To remove the error window, press <Ctrl-E>. This command toggles the error window on and off. Press <Ctrl-E> again to bring the error window back on the screen.

Simply the Basics

This section describes how to begin creating AXCESS programs. It covers several concepts: Basic ground rules for creating AXCESS programs The device-channel concept The different sections that comprise an AXCESS program How AXCESS executes a program Basic input and output functions Simple feedback As you progress through the sections, you will develop a simple AXCESS program that utilizes these basic features. You will continue to build on this program in later sections.
Format of the Programming Language
The AXCESS programming language is in a free format, meaning that the source code is independent of tabs and carriage returns. To take advantage of free format, you should utilize tabs and carriage returns in a consistent method of code placement, to make the code readable. In this manual, the following outline format is used:
IF (X = 1) { PUSH[PANEL,1] { Y=2 Z=3 } }
However, the above program section executes the same even if it looks like this:
IF(X = 1) {PUSH[PANEL,1] {Y = 2 Z = 3}}
The syntax is identical, but the spacing is different. The first method is recommended because it is easier to read, and adheres to AMX programming conventions.
Statements and Compound Statements
In AXCESS programming, most keywords and operators require a complete statement. A keyword is a word or series of words that signifies the operation for AXCESS to execute. That keyword and all its parameters form the statement. For example, the keyword to turn a channel on is ON , and the statement to turn on a particular channel is ON [RELAY_CARD,RELAY]. Statements can also involve mathematical or logical operations when operators are used. An operator is a character that performs a specific mathematical or relational function. For example, the operator used to set a variable equal to a value is '='. For example, the statement used to set variable X to the number 5 is X = 5. Figure 25 lists special operators.

Defining Start

DEFINE_START marks the section of programming that will be executed only once
immediately following power-up or system reset. They cannot be executed again until another AXCESS power-up. The keyword TO cannot be used in the DEFINE_START section; instead, use ON , OFF , or PULSE. For information on these keywords, refer to Changing the State of a Channel in the Using Input and Output section. When the AXCESS Control System is turned on, the program that was last loaded into the Central Controller is in operation, and is waiting for input from the user. However, you can tell AXCESS to run a series of statements immediately when the system is turned on. In your program, you may want to reset all three decks to stop (using SYSTEM_CALL s), turn on the lights, open the drapes, and raise the screen when AXCESS is powered up. Here is what the DEFINE_START section would look like:
DEFINE_START PULSE[LIGHTS,LIGHT_FULL] PULSE[RELAY,DRAPES_OPEN] PULSE[RELAY,SCREEN_UP] SYSTEM_CALL 'FUNCTION' (VCR,STOP,) SYSTEM_CALL 'FUNCTION' (CD,STOP,) SYSTEM_CALL 'FUNCTION' (CASS,STOP,)
If variables need to be reset to certain values, the statements needed to do this should be in this section. Remember, variables retain their values even if the system is powered down.
Mainline The section of the program, also known as the DEFINE_PROGRAM section, that is executed continuously by the Central Controller.

Defining Program

Define_Program marks the beginning of mainline, telling the compiler that the
following statements make up the actual executing program. Before you begin the main program, you must have the DEFINE_PROGRAM header. This header tells AXCESS that you are beginning the actual program at this point. It is used like this:
DEFINE_PROGRAM (* Your program starts here. *)
The DEFINE_PROGRAM header marks the start of what is called mainline. Mainline is the section of the program that actually runs while the Central Controller is operating. Mainline is the heart of the AXCESS program, and it is where you will spend most of your time while programming an AXCESS Control System. The most important feature of mainline is that it runs in a continuous loop. While most programming languages have a beginning and an end, mainline is like a circle: when the Central Controller gets to the end, it loops back to the top and passes through it again, as shown in Figure 27:
Figure 27 AXCESS continually loops through mainline

Program Name

AXCESS uses a long file name that gets embedded into the program the first time it is saved to provide a more descriptive name for AXCESS programs. This will appear in the first line of the program:

Device and channel keywords DEVICE_ID DO_PUSH DO_RELEASE GET_PULSE_TIME MASTER_SLOT SET_PULSE_TIME DEFINE_COMBINE DEFINE_LATCHING DEFINE_MUTUALLY_EXCLUSIVE DEFINE_TOGGLING

Device_ID

Every AXCESS device has a unique device ID number identifying its device type, such as an Infrared/Serial Card or a Touch Panel. The DEVICE_ID keyword returns the ID number of a specified device; if the device does not exist in the system, DEVICE_ID returns. This keyword is usually used for determining whether or not a device is present in the system. For example:
IF (DEVICE_ID(VCR)) (* If the card exists, these statements are executed *) { SEND_STRING , VCR is online, 13, 1 }
For a current list of device numbers for AXCESS devices, refer to the Deviceid.TXT text file, included on the AMX Control Disc. Deviceid.TXT is located in the AMXTools\AMXDOS\Software folder.

Do_Push

Caution This keyword is useful only in limited situations, and its use is strongly discouraged.
This keyword causes an input change from off to on to occur on a specified devicechannel without the device-channel being activated by external means. Here is the format:

DO_PUSH (device,channel)

The DO_PUSH keyword holds the PUSH for one half-second. It then releases the channel by generating another input change for the device-channel from on to off. The effect is the same as someone pressing a button on a panel for one half-second. The release can be delayed by repeating the DO_PUSH before the half-second time period elapses. This keyword is useful only in limited situations, and its use is strongly discouraged.

Do_Release

This keyword causes an input change from on to off to occur on a specified devicechannel without the device-channel being deactivated by external means. Here is the format:
DO_RELEASE (device,channel)
If a RELEASE statement corresponding to the device-channel is present in the program, it will be executed. The DO_RELEASE keyword also forces the release of a devicechannel turned on by DO_PUSH.

Get_Pulse_Time

This system variable contains the current duration of PULSE s and MIN_TO , as set by SET_PULSE_TIME. Time is measured in tenths of seconds, and the default is one halfsecond. For example:
SET_PULSE_TIME(12) P_TIME = GET_PULSE_TIME
The variable P_TIME now contains 12 , or 1.2 seconds.

Master_Slot

Note If this keyword is used in any system other than an AXF-BP (large CardFrame), MASTER_SLOT will always return to.
This system variable returns a number which represents the slot in which the Central Controller is plugged; represents slot 1, and 1 represents slot 2.

Figure 34 The value in CAM_PRESETS[3] is assigned to the variable

CAM_PRESET_1

CAM_PRESETS[3] CAM_PRESETS_1
You can place values into a storage location by setting the particular location equal to the needed value. For example, CAM_PRESETS was previously defined as having six locations. If you want the second location to hold a value of 6 you would type the following:

CAM PRESETS[2]=6

The number 6 is placed into the second location, as shown in Figure 35.
Figure 35 The storage location CAM_PRESET[2] is assigned a value of 6.

CAM_PRESETS

From now on, anytime CAM_PRESETS[2] is referenced, its value is 6. In the example program, pressing a Preset button either stores or recalls a preset. Examine the section of code that accomplishes this:
DEFINE_VARIABLE STORE_VOL_PRESET VOL_PRESETS[1] VOL_PSET DEFINE_PROGRAM PUSH[TP,32] (* STORE *) (* 1 WHEN WE STORE VOLUME PRESET *) (* 1 VOLUME PRESETS *) (* INDEX FOR ABOVE ARRAY *)
STORE_VOL_PRESET = NOT STORE_VOL_PRESET [TP,32] = (STORE_VOL_PRESET) PUSH[TP,25] PUSH[TP,26] (* PRESET 1 *) (* PRESET 2 *) (* PRESET 3 *) (* PRESET 4 *) (* PRESET 5 *) (* PRESET 6 *) (* PRESET 7 *)

Note The keyword

SEND_COMMAND sends a
PUSH[TP,27] PUSH[TP,28] PUSH[TP,29] PUSH[TP,3] PUSH[TP,31] {
string to an AXCESS device, which then interprets the string as a command for an action.
VOL_PSET = PUSH_CHANNEL - 24 IF (STORE_VOL_PRESET) VOL_PRESETS[VOL_PSET] = VOL_LEVEL ELSE SEND_COMMAND VOLUME,"'PL',ITOA(VOL_PRESETS[VOL_PSET])" OFF[STORE_VOL_PRESET] }
The first PUSH [TP,32] is the Store button, which toggles the STORE_VOL_PRESET variable using the NOT operator. The NOT operator inverts the state of whatever follows it. The PUSH statement is immediately followed by a feedback statement for the Store button.
The next seven pushes, PUSH [TP, 25] through PUSH [TP,31] , are the buttons for PRESETS 1 through 7. Inside the block is an IF statement which uses the state of the variable STORE_VOL_PRESET to determine whether to assign the volume cards level to a location in the VOL_PRESETS array, or to send a command to the volume card telling it to go to a previously stored level. To place the variable VOL_LEVEL into the array VOL_PRESETS at the correct location, 24 must be subtracted from PUSH_CHANNEL to find the index value.

Strings

In many cases you may need to transfer a series of data values at once. You can do this by using strings and string expressions. A string is a set of values grouped together with single and/or double quotes. Strings enclosed in single quotes are called string literals. Examples of strings include names and the actual command portion of SEND_COMMAND statements. Single quotes can only enclose values ranging from decimal 32 (the space character) to decimal 126 (the tilde character ~). These string literals are constant values that are set at compile time. Once loaded into the Central Controller, these strings cannot be changed, except when a new program is loaded into the Central Controller. Here is an example of a string literal assigned to an array:

DEFINE_PROGRAM Identifier_1 = 'Fred' Identifier_2 = 'FRED' if (IDENTIFIER_1 = IDENTIFIER_2) { (* This will not be true because 'Fred' and 'FRED' are not the same. *) }
Note When programming, you may use whatever capitalizing scheme you wish. At AMX, as a standard, we capitalize all keywords and identifiers in the program.
Notice that the string literals FRED and Fred are not the same. However, in the case of identifiers Identifier_1 and Identifier_2 , AXCESS does not differentiate based on the case of the letters in the identifier name. Also notice that in this example the keyword if is not capitalized. This also makes no difference to the AXCESS compiler.
Setting uppercase and lowercase
In AXCESS, the lowercase letter a is not the same as the uppercase letter A. Each has its own decimal ASCII code (the code for a is 97, and the code for A is 65). This could become problematic when, for example, your program compares an incoming string ABC against another, as shown below:
IF (ABC = 'YES') { (* statement(s) *) }
If the incoming string is 'YES' , there is no problem. The statements are executed as normal. However, if ABC equals 'Yes' , since 'YES' and 'Yes' do not have the same decimal ASCII value, the statements below the IF would not be executed. The solution is to change all incoming strings to either uppercase or lowercase. The keywords that do this are UPPER_STRING and LOWER_STRING. For example, the following statement can be added before the preceding program:

ABC2 = UPPER_STRING(ABC)

The IF statement can now compare ABC2 against 'YES' , providing that the IF statement reads IF (ABC2 = YES). The string Yes is accepted since it has been converted into uppercase. Conversely, LOWER_STRING converts a string into lowercase.

Sending Strings

To send a string to the outside world, you use the SEND_STRING keyword. Here is the syntax:
SEND_STRING device,<string, variable, or string expression>
The first value after the SEND_STRING keyword is the device number or identifier to which you wish to send the string. Following that is a comma, then the string, variable (which can be either a normal variable or an array), or string expression you wish to send. When an array variable is specified, the number of characters from the array that are sent is determined by the length value for the array. Set the length value for the array with the SET_LENGTH_STRING function. For example, if you need to send the TEMP array to a card named RS232 , you would write the following line:

DEFINE_VARIABLE INTEGER CAM_PRESETS[6] (* CAMERA PRESETS *)
Note An integer array takes up twice as much AXCESS memory than would a normal array of the same storage capacity.
This declares an integer array with six locations; each location can hold values from to 65,535. There are certain limitations of integer arrays. If an integer array is assigned to a normal array, all values are truncated above 255. For more information on truncating values, refer to Defining Variables in the Definition Sections section of this manual. This also happens if an integer array is sent to a device using the keywords SEND_STRING or SEND_COMMAND. There is no problem, however, in assigning a normal array to an integer array.
Note If your array is only going to hold alphanumeric values, it is not necessary to make it an integer array.
Variable and Conversion Keywords
Variable and Conversion keywords that you can use in the AXCESS program are listed in Figure 53, and their descriptions follow.
Figure 53 Variable and Conversion keywords
Variable and Conversion keywords ATOI INTEGER ITOA ITOHEX RANDOM_NUMBER
The ATOI keyword stands for ASCII to integer. It takes a string literal, string expression, or array as a parameter, and returns a single integer as the result. Here are some examples:
DEFINE_CONSTANT STR1 = 456 STR2 = YES789GO19 DEFINE_PROGRAM NUM = ATOI('123') NUM = ATOI(STR1) NUM = ATOI(STR2) (* NUM = 123 *) (* NUM = 456 *) (* NUM = 789 *)
Note The three keywords ITOA , ITOHEX , and ATOI automatically set the length value of the resulting string.
If the string contains all non-numeric characters (such as HELLO ), ATOI returns the integer. However, if there are any numeric characters embedded in the string, ATOI returns the first complete set it comes upon, as is the case with STR2 above. Notice that only the first set of numbers from STR2 is returned.

INTEGER

This keyword can only be used in the DEFINE_VARIABLE and LOCAL_VAR sections when declaring arrays. It is placed in front of the array name to denote the array as an integer array. For more information, see the above discussion on integer arrays.
which is short for integer to ASCII, creates a string that represents the decimal value of a number. Here are some examples:
ITOA , DEFINE_CONSTANT CONST = 456 DEFINE_VARIABLE STR[5] VAR
DEFINE_PROGRAM VAR = 789 STR = ITOA(123) STR = ITOA(CONST) STR = ITOA(VAR) (* STR = 123 *) (* STR = 456 *) (* STR = 789 *)

If and the Boolean Expressions
Figure 54 The structure of a twodimensional array

Storing values

The method of storing values into a two-dimensional array is similar to that of a onedimensional array: You can assign values to individual locations You can assign one-dimensional arrays, string literals, and string expressions to one of the one-dimensional arrays inside the two-dimensional array You can assign entire two-dimensional arrays to other two-dimensional arrays For example:
DEFINE_VARIABLE NAMES[1][3] PEOPLE[8][2] ONE_NAME[3] A_VALUE DEFINE_PROGRAM A_VALUE = 1 ONE_NAME = 'EMMITT SMITH' NAMES[1][1] = 6 NAMES[1][2] = A_VALUE NAMES[2] = 'TROY AIKMAN' (* statement 5 *) (* statement 2 *) (* statement 3 *) (* statement 4 *) (* statement 1 *) (* two-dimensional array *) (* another two-dimensio nal array *) (* one-dimensional array *) (* single-value variable *)
NAMES[3] = "1,2,ONE_NAME,3" (* statement 6 *)
Figure 55 shows what the two-dimensional array NAMES will look like after this code is executed.
Figure 55 The two-dimensional array NAMES after the assignments Note In this example, 6, 10, 1, 2, and 3 are decimal values, while all of the letters are ASCII characters. Note A two-dimensional array is like an array of onedimensional arrays.
Each row in the two-dimensional array has a length value just like a one-dimensional array. When a string literal or string expression is assigned to a row of a twodimensional array, as shown in statements 5 and 6 in the above example, that row has its length value set in the same manner as a one-dimensional array does. The LENGTH_STRING and SET_LENGTH_STRING functions operate on rows in two-dimensional arrays in the same way as in whole one-dimensional arrays. Once the above example has executed, the LENGTH_STRING function returns the first three rows of NAMES :
X = LENGTH_STRING (NAMES[1]) X = LENGTH_STRING (NAMES[2]) X = LENGTH_STRING (NAMES[3]) (* X will contain *) (* X will contain 11 *) (* X will contain 15 *)

Retrieving values

Retrieving values from a two-dimensional array is done in the same way as from a one-dimensional array. There are two ways of referencing data in a one-dimensional array: referencing a single value inside the array, and referencing the entire array. When using a two-dimensional array, there are three ways of referencing the contents: By cell (single values) By row (an array of values) As a whole

Default statement A statement (or compound statement) that executes if none of the conditions being tested comes true.
A last ELSE statement (not ELSE IF ) can be placed at the end as a default statement. Then, if AXCESS does not find a true IF or ELSE IF statement, it executes the final ELSE statement. This last statement is not necessary.

Nesting

Once AXCESS is following a branch (for example, Statement 1 in the previous example), you can tell it to branch off again with another IF statement. This branch within a branch is called nesting. An IF can be nested within an IF within an IF, and so on. When you are nesting IF.ELSE statements, be sure to use braces. Look at the following incorrect example:
IF (X = 5) IF (Y = 1) (Statement 1) ELSE (Statement 2)
The alignment of the ELSE statement with the IF (X = 5) suggests that they should be associated. The second IF statement in this example is not intended to have an ELSE counterpart. However, AXCESS pairs the second IF statement with the ELSE , because the compiler associates the ELSE with the closest IF statement. Using braces, you can force the compiler to associate the ELSE with IF (X = 5). For example:
IF (X = 5) { IF (Y = 1) (Statement 1) } ELSE (Statement 2)
By using braces, you isolate the IF (Y = 1) statement from the IF.ELSE set of statements.
The Select.Active Statement
The SELECT.ACTIVE statement makes IF.ELSE IF nesting easier, by allowing placement of several branches from one path. This is the format:
SELECT { ACTIVE ( Boolean expression 1) : (Statement 1) ACTIVE (Boolean expression 2) : (Statement 2) ACTIVE (Boolean expression 3) : (Statement 3) (*.etc. *) }
Note If too many IF.ELSE IF statements are chained together, they could cause a run-time error.
Each one of the Boolean expressions is evaluated in order, until one is found to be true. The statements associated with that true expression are then executed, and then the path flows to the statements that follow the closing brace. Using SELECT.ACTIVE is preferable to using multiple IF.ELSE IF statements since it uses less memory, and runs faster. When using the IF.ELSE set of statements, the code following the ELSE is the default statement. If the condition of the IF is false, then the default statement following the ELSE is executed. If none of the conditions in a SELECT.ACTIVE statement are true, no code of any ACTIVE statement will be executed, since SELECT.ACTIVE has no default statement. The following example shows how to create your own default statement for a SELECT.ACTIVE :
SELECT { ACTIVE (condition) : (statement) ACTIVE (condition) : (statement) ACTIVE (condition) : (statement) ACTIVE (1) : (default statement) }

DEFINE_VARIABLE ARY[1] X

DEFINE_PROGRAM X = 11 SEND_STRING , BEFORE. ARY[X] = 123 (* This will cause an error *) SEND_STRING ,.AFTER, $D, $A
The resulting output from the Central Controller would look like this if the AMX BUG is on:
BEFORE.BAD ELEMENT ASSIGN BYTE ARRAY.AFTER
By using the SEND_STRING statements, you can determine that the array assignment is causing the run-time error message. While the error in this example is obvious, in more complex programs the error may not be so obvious. In some cases, this debugging technique can prove to be invaluable.

Viewing Variables

There are two ways to view the values in variables as a program is executed. You can use the SEND_STRING method to display a variables value at certain points in a program, or you can use the variable watch window. The variable watch window is accessed through the Diagnostics menu, and it can only be activated if there is a compiled program loaded in the computer and Central Controller. Figure 72 shows the variable watch window.
Figure 72 Variable watch window
The variable watch window allows you to view the contents of up to ten variables at a time. The window is updated after each pass through mainline. The displayed value of a variable is its value at the end of mainline. The bottom of the window lists the actions of some function keys and displays a speedometer that is updated on each pass through mainline. Here is a summary of the available functions: <F1> Adds a variable to watch. Only simple variables, one-dimensional arrays, and the rows of a two-dimensional arrays can be viewed. The <Ins> key also activates this function. <F2> Deletes the currently selected variable from the window. The <Del> key also activates this function.
Note The arrow keys move the highlight bar in the window, allowing you to select which variable to modify or delete.
<F3> Sets the viewing mode for arrays to the current length. The number of locations that are displayed is determined by the current length value of the array. <F4> Sets the viewing mode for arrays to the length defined in the definition section. All of the locations of the array are displayed, regardless of the current length value of the array. <F5> Allows you to change the value of the currently selected variable. <F7> Toggles the Step mode between run and single step mode. In run mode, the system program is executed normally in the Central Controller. In single step mode, program execution is suspended between each pass through mainline. <F8> In single step mode, this key causes mainline to be executed once. This key only functions in single step mode. <F9> Allows you to change the way the variable is displayed. This key toggles from HEX, to ASCII, to decimal format to binary to octal, depending on the type of variable that is selected. This feature is only available on Version 3.05 or newer.

A non-array variable was treated as an array.

Include file not found

An INCLUDE statement was encountered, but the specified include file could not be found.
Invalid include file name
A string literal enclosed in single quotes must follow the INCLUDE keyword.

Library file not found

The library file containing the specified SYSTEM_CALL could not be found.
Maximum string length exceeded
String literals are limited in length to 132 characters, including spaces.
Must be char array reference
An array type variable was expected in CREATE_BUFFER , CREATE_MULTI_BUFFER , or CLEAR_BUFFER.
Must be integer reference
The identifier in question must be an integer. This error occurs when the third parameter of CREATE_LEVEL is an array or array element.

Out of memory

The compiler has run out of memory. Free up memory either by removing any popup programs or drivers, by using extended memory, or by breaking your program into one or more include files.
Parameter mismatch in Call
A value or variable passed to a CALL as a parameter is of the wrong type as defined by the DEFINE_CALL statement.
Program_Name must be on line 1
Move the PROGRAM_NAME= statement to the first line of the program.
Push/Release not allowed within Push/Release
A PUSH or RELEASE statement was found within a block of code headed by a PUSH or RELEASE statement.
Push/Release not allowed within Wait Push_Channel not allowed within Wait Release_Channel not allowed within Wait Push_Device not allowed within Wait Release_Device not allowed within Wait
These keywords are not allowed in a section of code which will be executed due to a WAIT keyword.

String constant expected

A string is required for the particular operation. This error occurs if a string literal enclosed in single quotes does not follow the PROGRAM_NAME keyword.
String constant never ends, EOF encountered
A string literal is started but never ends. Add a closing single quotation mark () to the end of the string.

String literal expected

A string is required for the particular operation. This error would occur if a string literal enclosed in single quotes does not follow the #WARN keyword.
Subroutine may not call itself
A subroutine cannot call itself. It can, however, call a different subroutine.

Syntax error

A syntax error is found in an expression. In most cases, this error means that a character is out of place or something is misspelled.

Figure 80 Hexadecimal chart abbreviations Hexadecimal chart abbreviations
ACK BEL BS CAN CR DC1 DC2 DC3 DC4 DEL DLE EM ENQ EOT ESC ETB ETX
Acknowledge Bell Backspace Cancel Carriage return Device control 1 Device control 2 Device control 3 Device control 4 Delete Data link escape End of medium Enquiry End of transmission Escape End transmission block End of text
FF FS GS HT LF NAK NUL RS SI SO SOH SP STX SUB SYN US VT
Form feed File separator Group separator Horizontal tab Line feed Negative acknowledge Null Record separator Shift in Shift out Start of heading Space Start of text Substitute Synchronous idle Unit separator Vertical tab

Accessing the AMX BBS

Note This information is included on the AMX Control Disc, in the Worldgroup Readme text file.

About Worldgroup Manager

Worldgroup Manager is a Windows application designed to provide an intuitive, graphical user interface to the AMX BBS. The software is easily installed on your PC from the AMX Control Disc.
Installing Worldgroup Manager
Find the folder (directory) named WorldGrp on the Control Disc. Inside you will find the file, SETUP.EXE. Run this program and follow/answer the prompts to install the program.
Adding the AMX BBS to the Worldgroup Manager:
Start the Worldgroup Manager program. Create a new online service item:
a. Under the File menu, select New. b. In the New dialog, click on Online Service item. c. Click on OK.
Note For modem connection, use step 3. For internet connection, use step 4.
Set up the AMX BBS in the Online Service Properties dialog for dial-up (modem) connection.
a. Type AMX BBS in the name field b. Click Modem in the How to Connect section c. Enter (972) 97-2884 in the Phone Number field. If you need to use some access
number, like 9, make sure you enter it before the phone number. Also, make sure you include the long distance access code if you are not in Dallas, TX.
d. Click on Settings. This is where you set up your modem.
1) Click on the com port your modem is attached to. If you aren't sure

Program Port Connections and Wiring
The NXC-ME260/64 is equipped with two Program ports. One is located on the front panel and the other is on the rear for easy access. The port on the front panel is an RS232 (male) connector and the rear port is a grey 5-pin (male) connector. Use a Programming cable to connect the Program port to your PC's COM port to communicate with the Master card. Then, you can download NetLinx programs to the Master card using the NetLinx Studio 2.1 software program. Refer to the NetLinx Studio instruction manual for programming instructions.
RS232 Program port (front panel) The following table shows the front panel RS232 (DB9) Program Port connector (male), pinouts, and signals. RS232 Program Port, Pinouts, and Signals
Program Port Connector Pin Signal RX TX GND RTS CTS
5-Pin Program port (rear panel) The table below lists the pinouts and signals for the grey rear panel 5-pin 3.5 mm mini-Phoenix Program port connector. 5-Pin Program Port Pinouts and Signals
Pin 5 Signal GND RX TX CTS RTS
ICSNet RJ-45 Connections/Wiring
The following table shows the pinouts, signals, and pairing information to use for ICSNet RJ-45 connections. The ICSNet connections provide power and data to ICSNet devices. Each port provides up to 500 mA of current. ICSNet RJ-45 Signals
Pin Signal-Master TX + TX N/A GND N/A N/A RX + RX Signal-Device RX + RX N/A GND N/A N/A TX + TX -
RJ-45 Pinout Information (EIA/TIA 568 B)
Pin Wire Color Orange/White Orange Green/White Blue White/Blue Green White/Brown Brown Polarity + + + + Function Transmit Transmit Mic Ground 12 VDC Mic Receive Receive

T IA 8 B

(female) RJ-45 connector - pin configurations

(male)

Unlike the ICSNet ports, the ICSHub connections require a specific polarity. The IN/OUT configuration, on the Hub ports, was implemented to use the same cables as ICSNet, but these ports need TX and RX crossed. You must connect an OUT to an IN, or an IN to an OUT port. This is done simply to keep the polarity straight. The Hub bus is still a bus. All Hub connections are bi-directional.
ICSHub RJ-45 Connections/Wiring
The two ICSHub RJ-45 connectors on the rear of the Master card provide data to other Hubs connected to a downstream system. Hubs allow you to connect multiple NetLinx Hubs together in a daisy-chain configuration. Connect the OUT port to the IN port on the second or downstream NetLinx Hub.
Use CAT5 cables for all ICSHub connections. Do not connect the last hub in a daisy-chain configuration into the first Hub.

14. Once the particular System Master is configured for communication via an IP Address, remove the RS232 connector from the Program port on the NetLinx Master.
Installing New NetLinx Master Firmware via an IP
1. Click the OnLine Tree tab in the Workspace window to view the devices on the System. The default System value is one (1). 2. Right-click on the Empty Device Tree/System entry and select Refresh System to establish a new connection to the Systems Master and refresh the list with online system devices. 3. After the Communication Verification dialog window verifies active communication between the PC and the Master, verify the NetLinx Master appears in the OnLine Tree tab of the Workspace window (FIG. 23).
FIG. 23 Initial NetLinx Workspace window (showing the OnLine Tree tab)
4. If the firmware version is not build 130 or higher (v2_XX_130) for the NXC-ME260; locate the latest firmware file from www.amx.com > Tech Center > Downloadable Files > Firmware Files > NetLinx Masters. 5. Verify you have downloaded the latest Master firmware (KIT) file to a known location. 6. Select Tools > Firmware Transfers > Send to NetLinx Device from the Main menu to open the Send to NetLinx Device dialog (FIG. 24). Verify the targets System number matches the value listed within the active System folder in the OnLine Tree tab of the Workspace.
Selected Firmware file Description field for selected KIT file

Firmware download status

System Number must match the System value listed in the Studio Workspace window FIG. 24 Select to NetLinx Device dialog (showing Master firmware update via IP)
7. Select the Masters KIT file from the Files section (FIG. 24).
The KIT file for the ME260 begins with 2010_kit (the KIT file for the NI-Series of Master controllers begins with 2105_NI Master).
8. Enter the System number associated with the target Master (listed in the OnLine Tree tab of the Workspace window). The Device and Port fields are greyed-out. 9. Click the Reboot Device checkbox to reboot the Master after the firmware update process is complete. 10. Click Send to begin the transfer. The file transfer progress is indicated on the bottom-right of the dialog (FIG. 24).

Server Certificate Entries (Cont.)
City/Location State/Province Country Name Action Name of the city where the certificate is used. This is an alpha-numeric string (1 - 50 characters in length). Name of the state or province where the certificate is used. This is an alpha-numeric string (1 - 50 characters in length). Provides a drop-down selection with a listing of currently selectable countries. Provides a drop-down selection with a listing of available certificate options: Display Certificate - Populates the Server Certificate fields with the information from the certificate currently installed on the Master. This action is used only to display the information contained in the certificate on the target Master. Create Request - Takes the information entered into the previous fields and formats the certificate so it can be exported to the external Certificate Authority (CA) for later receipt of an SSL Certificate. This action is used to request a certificate from an external source. Self Generate Certificate - Takes the information entered into the previous fields and generates its own SSL Certificate. This action is used when no previous certificate has been installed on the target Master, or a self-signed certificate is desired. Regenerate Certificate - Takes the information entered into the previous fields and regenerates an SSL Certificate. This action changes the Master Key. This method of certificate generation is used to modify or recreate a previously existing certificate already on the Master. OK/Cancel/Delete Press OK to accept any changes made within this tab and incorporate the information into the target Master. Press Cancel to void any changes made within this tab, disable the security configuration session, void any changes made to the Master, and return you to the empty Security tab.
If a certificate has been purchased from an external CA and then installed onto a specific Master, DO NOT regenerate the certificate or alter its properties (ex: bit length, city, etc.). If the purchased certificate is regenerated, it becomes invalid.
A certificate consists of two different Keys:
Master Key is generated by the Master and is incorporated into the text string sent to the CA during a certificate request. It is unique to a particular request made on a specific Master. Public Key is part of the text string that is returned from the CA as part of an approved SSL Server Certificate. This public key is based off the submitted Master key from the original request. Regenerating a previously requested and installed certificate invalidates that certificate because the Master Key has been changed.

11. Choose Self Generate Certificate from the drop-down list. When this request is submitted, the
certificate is generated and installed into the Master in one step.
12. Click OK to save the new encrypted certificate information to the Master or click Cancel to void any changes made within this tab and exit without making changes to the target Master.
ONLY use the Regenerate certificate option when you have Self Generated your own certificate. DO NOT regenerate an external CA-generated certificate.
13. Click the Security tab > Enable Security link to return to the Enable Security page. 14. Place a checkmark into the SSL Enable selection box to enable the SSL security feature on the target Master. Activating this option creates a secure connection to and from the target Master. It is recommended that a secure connection to the target Master be used when importing a CA server certificate. Creating a Request for a SSL Server Certificate 1. Click on the Security tab. Refer to the Security tab - SSL Server Certificate page section on page 47 for more detailed descriptions on the security configuration options. 2. Click the Server Certificate link (on the left of the browser window) to display the Security tab with the fields necessary for generating a new certificate. 3. Click the down arrow from the Bit length field to open a drop-down listing of available public key lengths.
The three available public key lengths are: 512, 1024, and 2048. Higher selected key lengths result in increased certificate processing times. A longer key length results in more secure certificates.
4. Enter the used Domain Name.
Example: If the address being used is www.amxuser.com, that must be the Common name and format used in the Common Name field. This string provides a unique name for the desired user. This domain name must be associated to a resolvable URL Address when creating a request for a purchased certificate. The address does not need to be resolvable when obtaining a free certificate.
5. Enter the name of the business or organization into the Organization Name field. This is an alpha-numeric string (1 - 50 characters in length). 6. Enter the name of the department using the certificate into the Organizational Unit field. This is an alpha-numeric string (1 - 50 characters in length). 7. Enter the name of the city where the certificate will reside into the City/Location field. This is an alpha-numeric string (1 - 50 characters in length). 8. Enter the name of the state or province where the certificate will reside into the State/Province field. This is an alpha-numeric string (1 - 50 characters in length). The state/province name must be fully spelled out. 9. Click the down arrow from the Country Name field to open a drop-down listing of listing of currently selectable countries.

10. Click the down arrow from the Action field to open a drop-down listing of available certificate generation options. 11. Choose Create Request from the drop-down list. 12. Click OK to accept the information entered into the above fields and generate a certificate file. Refer to the Security tab - Export Certificate Request page section on page 49.
This refreshed the Server Certificate page and if the certificate request was successful, displays a "Certified request generated" message.
13. Click the Export Certificate Request link (on the left of the browser window) to display the certificate text file. 14. Place your cursor within the certificate text field. 15. Press the Ctrl + A keys simultaneously on your keyboard (this selects all the text within the field).
YOU MUST COPY ALL OF THE TEXT within this field, including the -----BEGIN CERTIFICATE REQUEST----- and the -----END CERTIFICATE REQUEST-----. Without this text included in the CA submission, you will not receive a CA-approved certificate.
16. Press the Ctrl + C keys simultaneously on your keyboard (this takes the blue selected text within the field and copies it to your temporary memory/clipboard). 17. Paste this text into your e-mail document and then send that information to a CA with its accompanying certificate application.
When a certificate request is generated, you are creating a private key on the Master. YOU CAN NOT REQUEST ANOTHER CERTIFICATE UNTIL THE PREVIOUS REQUEST HAS BEEN FULFILLED. Doing so will void any information received from the previously requested certificate and it will be nonfunctional if you try to use it.
18. Once you have received the returned CA certificate, follow the procedures outlined in the following section to import the returned certificate, over a secure connection, to the target Master. Importing a CA certificate to the Master over a secure SSL connection Before importing a CA server certificate, you must:
First, have a self-generated certificate installed onto your target Master. Secondly, enable the SSL security feature from the Enable Security page, to establish a secure connection to the Master prior to importing the encrypted CA certificate. Refer to the Security tab - Enable Security page section on page 38 for more information about enabling SSL security.
1. Take the returned certificate (signed by the CA and encrypted with new information which makes it different from the text string that was previously sent) and copy it into your clipboard. Refer to the Security tab - Import Certificate page section on page 49. 2. Click the Import Certificate link to open the empty Import Certificate window. 3. Place your cursor within the empty window and paste the raw text data (in its entirety) into the field.

4. Click OK to enter the new encrypted certificate information and save it to the Master or click Cancel to void any changes made within this tab and exit without making changes to the target Master.
Once a certificate has been purchased from an external CA and then installed onto a specific Master, DO NOT regenerate the certificate or alter its properties (example: bit length, city, etc.).If the purchased certificate is regenerated, it becomes invalid.
Master Key is generated by the Master and is incorporated into the text string sent to the CA during a certificate request. It is specific to a particular request made on a specific Master. Public Key is part of the text string that is returned from the CA as part of an approved SSL Server Certificate. This public key is based off the submitted Master key from the original request. Regenerating a previously requested and installed certificate, invalidates the previously purchased certificate because the Master Key has been changed.
5. Use the Display Certificate option to confirm that the new certificate was imported properly to the target Master. Display SSL Server Certificate Information 1. Click on the Security tab (FIG. 45 on page 62). Refer to the Security tab - SSL Server Certificate page section on page 47 for more detailed descriptions on the security configuration options. 2. Click the Server Certificate link (on the left of the browser window) to populate the Security tab.
By default, the Display Certificate Action is selected and these fields are populated with information from an installed certificate. If the Master does not have a previously installed certificate, these fields are blank.
3. Click the down arrow from the Action field to open a drop-down listing of available certificate generation options. 4. Choose Display Certificate from the drop-down list. 5. Click OK to accept the action and populate the fields with the certificate information. Regenerating an SSL Server Certificate Request 1. Click on the Security tab. Refer to the Security tab - SSL Server Certificate page section on page 47 for more detailed descriptions on the security configuration options. 2. Click the Server Certificate link (on the left of the browser window) to display the Security tab with the fields necessary for developing a new certificate.

2. Enter in the company information, such as: name, e-mail, address, state, and country. 3. Agree to any licensing agreements and continue to the next part of the registration process.
4. Enter the name of the server being used (this is the Master).
The server name is the name as it shows up in the URL of the Master you are securing with this server certificate. For example, if the URL of the Master will be https://www.myNetLinxMaster.com/, then enter the server name as www.myNetLinx Master.com.
5. Send the CA the text created by your certificate request through the Master. Refer to the Creating a Request for a SSL Server Certificate section on page 63 for the procedures necessary to generate the certificate text file. 6. Place your cursor within the certificate text field of the Export Certificate window of the Security tab. 7. Press the Ctrl + A keys simultaneously on your keyboard (this selects all the text within the field).
YOU MUST COPY ALL OF THE TEXT within this field, including the -----BEGIN CERTIFICATE REQUEST----- and the -----END CERTIFICATE REQUEST-----. Without this text included in the CA submission, you will not receive CA approved certificate.
8. Press the Ctrl + C keys simultaneously on your keyboard (this takes the blue selected text within the field and copies it to your temporary memory/clipboard). 9. Paste this text into the Submit Request field on the CAs Retrieve Certificate web page. 10. Choose to view the certificate response in raw DER format. 11. Note the Authorization Code and Reference Number (for use in the e-mail submission of the request). 12. Submit the request. 13. Paste this certificate text field (copied from steps 7 & 8 above) into your e-mail document and then send that information to a CA with its accompanying certificate application. 14. Complete the certificate installation procedures outlined in the Creating a Request for a SSL Server Certificate section on page 63.
Accessing an SSL-Enabled Master via an IP Address
1. Enter the IP Address of the target Master (example: 198.198.99.99) into the web browser Address field. 2. Press the Enter key on your keyboard to begin the communication process between the target Master and your computer. 3. The user is then presented with a Security Alert popup window and Certificate information (FIG. 46).
FIG. 46 Security Alert and Certificate popups
The above alert will only appear if an SSL Server Certificate has been installed on the target Master, the SSL Enable options has been enabled, from within the Enable Security window of the Security tab, and there is a problem with the sites certificate.

Problems with the certificate can result from:
A self generated and self-signed certificate that hasnt been approved by a CA. The self-generated certificate is not part of that computers web browser list of trusted sites. This changes after the certificate is installed into the users browser list of trusted sites. The date period given to the certificate has expired. CA-approved certificates typically come with a 2 year window of validity. Self generate certificates come defaulted with a 30 year window of validity (see FIG. 46). The name on the security certificate site information doesnt match the domain name of the target Master.
4. Click the View Certificate button on the Security Alert popup to view more detailed information about the certificate. A secondary Certificate popup window is then displayed. 5. Review the information presented within the certificate and if you trust that both the site and certificate information are correct, click the Install Certificate button to begin installing the certificate into computers web browser list of trusted sites.
6. The user is then presented with a Certificate Import Wizard that begins the process of adding the certificate (FIG. 47).
FIG. 47 Certificate Import Wizard
7. Click Next to proceed with the certificate store process.
FIG. 48 Certificate Import Wizard- storing the certificate
8. Click Next to automatically use the default certificate store settings and locations (FIG. 48). 9. Click Finish button to finalize the certificate installation process. 10. Click Yes, from the next popup window to ".ADD the following certificate to the Root Store?". After a successful importing of the certificate into Internet Explorers list of trusted sites, another popup window appears to inform you of the success. 11. Click OK from the Import was successful popup window. 12. To close the still open Certificate popup window click OK. 13. To close the still open Security Alert popup window, click Yes. 14. From the Network Password window, click the down arrow from the user name field to select a user name. 15. Enter a valid password into the password field. 16. Click the save password check mark field if you want to have your web browser remember this password during consecutive login sessions. 17. Click OK to access the target Master.
18. The first tab displayed within your open browser window is WebControl. Using your NetLinx Master to control the G4 panel Refer to the specific panel instruction manual for detailed information on configuring and enabling WebControl. Once the Masters IP Address has been set through NetLinx Studio (version 2.1 or higher): 1. Launch your web browser.
In order to fully utilize the SSL encryption, your web browser should incorporate the an encryption feature. This encryption level is displayed as a Cipher strength.
2. Enter the IP Address of the target NetLinx Master (example: 198.198.99.99) into your web browsers Address field. 3. Enter a valid user name and password into the fields within the Enter Network Password dialog. 4. Click OK to enter the information and proceed to the Masters WebControl tab. 5. Press the Enter key on your keyboard to begin the communication process between the target Master and your PC.

If a Security Alert window appears on your computer screen, refer to the specific NetLinx Master Instruction Manual for detailed information regarding this popup window. These steps are based on a Master with proper security and SSL encryption enabled.
6. This tab (FIG. 25) displays links to both G3 web panel pages downloaded to the target Master and G4 panels running the latest G4 Web Control feature.
FIG. 49 WebControl Tab (populated with panels)
7. Click on the G4 panel name link associated with the target panel. A secondary web browser window appears on the screen (FIG. 50).
FIG. 50 WebControl VNC installation and Password entry screens
8. Click Yes from the Security Alert popup window to agree to the installation of the G4 WebControl application on your computer. This application contains the necessary Active X and VNC client applications necessary to properly view and control the panel pages from your computer.
The G4 WebControl application is sent by the panel to the computer that is used for communication. Once the application is installed, this popup will no longer appear. This popup will only appear if you are connecting to the target panel using a different computer.
9. If a WebControl password was setup on the G4 WebControl page, a G4 Authentication Session password dialog box appears on the screen within the secondary browser window. 10. Enter the WebControl session password into the Session password field (FIG. 50). 11. Click OK to send the password to the panel and begin the session. The secondary window then becomes populated with the same G4 page being displayed on the target G4 panel. A small circle appears on the G4 panel page and corresponds to the location of the mouse cursor. A left-mouse click on the computer-displayed panel page equates to an actual touch on the target G4 panel page. Using your NetLinx Master to control the G3 panel Refer to the specific panel instruction manual for detailed information on configuring and enabling WebControl. Before being able to access a G3 panel (with SSL enabled) through the WebControl tab, you must first download the Java Virtual Machine software from Sun Micro Systems to install a Sun Java applet on your computer.
You must install the Sun Java Web Start application. Using the default Microsoft Java applet (when SSL is enabled) can cause some G3 panels not to open or be viewed properly.
Once the Masters IP Address has been set through NetLinx Studio (version 2.1 or higher): 1. Navigate to the Java Web Start Application from http://java.sun.com/products. 2. Click on the Download Java Web Start > Download Java Web Start 1.4.2 link to begin the download of the application to your hard drive and follow the installation procedures recommended by the application.
3. Restart your computer and launch your browser. 4. Repeat steps 1 - 5 from the previous section to launch the WebControl tab associated with your Master. 5. Click on the G3 panel name link associated with the target panel. 6. A secondary web browser window appears on the screen to notify you that the computer is Loading the Java Virtual Machine.

What to do when a Certificate Expires
Self-generated certificates have a duration period of approximately 30 years. Most externally requested CA certificates are generally valid for a period of approximately 1 - 5 years. The only way to avoid a CA certificate becoming invalid due to a time expiration is to request a new certificate from your current CA. Refer to the Creating a Request for a SSL Server Certificate section on page 63 for more information on how to request an externally generated certificate.
NetLinx Security with a Terminal Connection
NetLinx Masters (version 2.10.80 or later) have built-in security capabilities. It will require a valid user name and password to access the NetLinx Systems Telnet, HTTP and FTP servers. The security capabilities are configured and applied via a Telnet connection or the NetLinx Masters RS-232 terminal interface (the RS232 Program port).
Always use the RS232 Program port when entering potentially sensitive security information. The Telnet server interface exposes this security information to the network in clear text format, which could be intercepted by an unauthorized network client. By using the RS232 Program port, there is security during the configuration of the database due to the physical proximity of the user to the system.
NetLinx Security Features
NetLinx security allows you to define access rights for users or groups.
A "User" represents a single potential client of the NetLinx Master, while a "Group" represents a logical collection of users. Any properties possessed by groups (i.e., access rights, directory associations, etc.) are inherited by all the members of the group.
The following table lists the NetLinx features that the administrator (or other 'qualified' user) may grant or deny access to. NetLinx Security Features
NetLinx Master Security Configuration The user has access to the security configuration commands of the Master. Only those users with security configuration access rights granted will have access to the security configuration commands. Telnet Security Terminal (RS232 Program port) Security HTTP (web server) Security FTP Security The user has access to the Telnet server functionality. All basic commands are available to the user. The user has access to the Terminal (RS232 Program port) server functionality. All basic commands are available to the user. The user has access to the HTTP server functionality. Directory associations assign specific directories/files to a particular user. The user has access to the FTP server functionality. Only the administrator account has access to the root directory; all other 'qualified' clients are restricted to the /user/ directory and its 'tree'.

Option 1 - Set system security options for NetLinx Master (Security Options Menu) Type 1 and <ENTER> at the Security Setup prompt (at the bottom of the Main Security Menu) to display the Security Options Menu. The Security Options Menu sets the "global" options for the NetLinx Master. It is accessed by the Set Security system options of the Main Security Menu. This first thing that will happen is you will be asked one of two questions. If NetLinx Master security is enabled, you will see the following:
NetLinx Master security is Enabled Do you want to keep NetLinx Master security enabled? (y or n): !
If you answer y for yes, security will remain enabled and you will be taken to the Security Options Menu. If you answer n for no, all security settings (except FTP security) will be disabled and you will be taken back to the Main Security Menu.
If NetLinx Master security is not enabled, you will see the following:
NetLinx Master security is Disabled Do you want to enable security for the NetLinx Master? (y or n): !
If you answer y for yes, security will be enabled and you will be taken to the Security Options Menu. If you answer n for no, all security settings (except FTP security) will remain disabled and you will be taken back to the Main Security Menu.
The Security Options Menu is displayed as follows:
Select to change current security option 1) Terminal (RS232) Security. Enabled 2) HTTP Security.. Enabled 3) Telnet Security.. Enabled 4) Security Configuration Security. Enabled Or <ENTER> to return to previous menu Security Options ->
The selection listed will display what the current settings. To change an option, select the number listed next to the option. For example, if selection 2) is selected, HTTP Security will be disabled. The menu will then be displayed again as follows:
Select to change current security option 1) Terminal (RS232) Security. Enabled 2) HTTP Security.. Disabled 3) Telnet Security.. Enabled 4) Security Configuration Security. Enabled Or <ENTER> to return to previous menu Security Options ->
Each selection simply toggles the security setting selected. Press <ENTER> to exit the menu and return to the Main Security Menu.
Changes made to the target Master from within the Terminal window are not reflected within the web browser, until the Master is rebooted and the web browser connection is refreshed. Any changes made to the Master, from within the web browser are instantly reflected within the Terminal session without the need to reboot.
The items in the Security Options Menu are described below: Security Options Menu

Select from the following list of enrolled users: 1) administrator 2) Fred 3) Betty 4) Bilbo Select User:
2. Select the user account (1-X) that you want to edit, and press <ENTER> to display the Edit User Menu (described below). Any changes made via the Edit User menu will affect the selected user account. Edit User Menu The Edit User Menu is accessed whenever you enter the Add user, or Edit user selections from the Main Security Menu. The Edit User Menu is displayed as follows:
Please select from the following options: 1) Change User Password 2) Change Inherits From Group 3) Add Directory Association 4) Delete Directory Association 5) List Directory Associations 6) Change Access Rights 7) Display User Record Contents Or <ENTER> to return to previous menu Edit User ->
Each selection (1-7) accesses the named option. Press <ENTER> by itself to exit the menu and return to the Main Security Menu.
The Edit User Menu options are described in the following table: Edit User Menu
Command 1) Change User Password Description This selection prompts you to enter the new password (twice) for the user. Once the new password is entered, the user must use the new password from that point forward. This selection will display the current group the user is assigned to (if any). It will then display a list of current groups and prompts you to select the new group. This selection will display any current Directory Associations assigned to the user, and then will prompt you for a path for the new Directory Association. Refer to Directory Associations on page 35 for details.
2) Change Inherits From Group
3) Add Directory Association
4) Delete Directory Association This selection will display any current Directory Associations assigned to the user, and then will prompt you to select the Directory Association you want to delete. 5) List Directory Associations 6) Change Access Rights This selection will display any current Directory Associations assigned to the user. This selection will display access the Access Rights Menu for the user, which allows you to set the rights assigned to the user.
7) Display User Record Contents This selection will display the group the user is assigned to and the current Access Rights assigned to the user.
Access Rights Menu The Access Rights Menu is accessed whenever you select Change Access Rights from the Edit User Menu, or Change Access Rights from the Edit Group Menu. The Access Rights Menu is displayed as follows:
Select to change current access right 1) Terminal (RS232) Access.. Disabled 2) Admin Change Password Access. Disabled 3) FTP Access.. Disabled 4) HTTP Access.. Enabled 5) Telnet Access.. Enabled 6) Security Configuration Access. Enabled Or <ENTER> to return to previous menu Set Rights ->

>SET DATE Enter Date: (mm/dd//yyyy) ->

SET DATE

Displays the current time on the Master Card. Example:

>TIME 13:42:04

SET TIME
Prompts you to enter the new time for the Master Card. When the time is set on the Master Card, the new time will be reflected on all devices in the system that have clocks (i.e. touch panels). By the same token, if you set the time on any system device, the new time will be reflected on the systems Master, and on all connected devices. This will not update clocks on devices connected to another Master (in Master-to-Master systems). Example:
>SET TIME Enter Date: (hh:mm:ss) ->
DEVICE STATUS <D:P:S> Displays a list of all active (on) channels for the specified D:P:S. Enter
DEVICE STATUS without the D:P:S variable, the Master Card displays ports, channels, and version information. Displays status of the specified Master. Example (on a local Master):
>DEVICE STATUS [0:1:0] Device 0 AMX Corp.,Master,v2.10.75 contains 1 Ports. Port 1 - Channels:256 Levels:8 MaxStringLen=64 Types=8 bit MaxCommandLen=64 Types=8 bit The following input channels are on:None The following output channels are on:None The following feedback channels are on:None Level 1=0 Supported data types=UByte,UInt Level 2=0 Supported data types=UByte,UInt Level 3=0 Supported data types=UByte,UInt Level 4=0 Supported data types=UByte,UInt Level 5=0 Supported data types=UByte,UInt Level 6=0 Supported data types=UByte,UInt Level 7=0 Supported data types=UByte,UInt Level 8=0 Supported data types=UByte,UInt

DNS LIST <D:P:S>

Displays: Domain suffix Configured DNS IP Information Example:
>DNS LIST [0:1:0] Domain suffix:amx.com The following DNS IPs are configured Entry 1-192.168.20.5 Entry 2-12.18.110.8 Entry 3-12.18.110.7
Command Description Displays the total bytes of free space available on the Master Card's compact Flash memory. Example:
>DISK FREE The disk has 2441216 bytes of free space.

DISK FREE

GET IP <D:P:S>
Displays the Master Card's D:P:S, Host Name, Type (DHCP or Static), IP Address, Subnet Mask, Gateway IP, and MAC Address. Example:
>GET IP [0:1:50] IP Settings for 0:1:50 HostName MLK_INSTRUCTOR Type DHCP IP Address 192.168.21.101 Subnet Mask 255.255.255.0 Gateway IP 192.168.21.2 MAC Address 00:60:9f:90:0d:39