Home  |   User's Guide Archive  |   PollCat Products  |   NetReach Products  |   Contact WTI  ]

5.   Configuration



5.1.   Access to the APS Command Mode

When the APS-8M Command Mode is active, commands can be invoked to select parameters, and connect or disconnect ports.

Notes:

  1. Start your communications program (e.g. HyperTerminal) Make certain the APS and the communications program are set for the same parameters (e.g. baud rate, parity, etc.)


  2. Access command mode.


    1. Local Access:  To access the command mode from a local PC that is connected to the APS via cable, press [Enter].


      1. There must be no other characters preceding [Enter]. If you have already hit other keys, press [Enter] twice.


      2. If a password that permits Supervisor Mode has been previously defined, the password prompt will be displayed. Key in a password that permits Supervisor Mode and press [Enter].


    2. Modem Access:  To access the command mode via modem, proceed as follows:


      1. Dial the number for the APS-8M's internal modem, or (if present) for an external modem connected to one of the APS-8M's RS232 ports.


      2. If a password that permits Supervisor Mode has been previously defined, the password prompt will be displayed. Key in a password that permits Supervisor Mode and press [Enter].




5.2.   System SetUp Ports

Ports 1 and 2 are designated as System SetUp Ports, and will therefore, always permit password protected access to Supervisor Mode.

In order to ensure that access to command functions is always available, Ports 1 and 2 cannot be configured as Buffer Mode or Passive Mode Ports (Buffer Mode Ports and Passive Mode Ports are not able to access command mode.) In addition, Ports 1 and 2 always permit password protected access to Supervisor Mode; the Supervisor Mode cannot be disabled at either of these two ports.



5.3.   Password Functions

The APS-8M's password directory allows you to define up to 32 different passwords. These passwords are not only used to protect access to the APS-8M unit, but are also used to determine the type of commands that each user will be allowed to invoke, and the ports that each user will be allowed to connect. This is accomplished by either granting or denying each password's access to Supervisor Mode and specifying permitted ports via the Password Directory.

Passwords that have been granted access to Supervisor Mode are allowed to change configuration parameters and may connect to any APS-8M port. On the other hand, passwords which are denied access to Supervisor Mode are not allowed to change configuration parameters, and are restricted to the ports specifically allowed by that password. Therefore, the password entered during login determines whether or not you will be able to invoke Supervisor Mode commands, and also determines which ports you will be allowed to connect to. Note that the password directory feature is described in greater detail in Section 5.4.1.

Note that once you have defined at least one password that permits access to Supervisor Mode, the APS-8M will display a password prompt whenever you attempt to access command mode. If a valid password, which allows access to Supervisor Mode is entered, the APS-8M will then start up in Supervisor Mode. Supervisor Level commands are summarized in Section 11.3 of this User’s Guide.

Notes:

Normally, passwords that permit access to Supervisor Mode can be entered at any port in order to gain access to Supervisor command functions. Note that if you wish to completely deny a port’s access to Supervisor Mode (even with a Supervisor Password), the Port Parameters menus (/P) can be used to disable the Supervisor Mode at ports 3 through 8. The Supervisor Mode cannot be disabled at System SetUp Ports 1 and 2.



 SYSTEM PARAMETERS:

 1. Site-ID:                 (undefined)
 2. Password on Dial Back:   Off
 3. Dial Back Attempts:      3
 4. Dial Back Delay:         30 Secs
 5. Edit Password Directory


Figure 5.1:   The System Parameters Menu (/F)

5.4.   The System Parameters Menu

Before configuring individual ports, the System Parameters should be defined. The System Parameters Menu (/F) allows you to set the Site ID Message, enable/disable the Password on Dial Back Function, set the number of Dial Back Attempts, set the Dial Back Delay Value, and access the menus which are used to define passwords and access rights. All parameters that are defined via the System Parameters Menu are global, and will be applied to all APS-8M ports.

Notes:

To define System Parameters, proceed as follows:

  1. Access command mode. Type /F  [Enter] to display the System Parameters Menu (Figure 5.1.) The System Parameters Menu allows you to define the following:




EDIT PASSWORD DIRECTORY:

1. Add Name/Password
2. Edit/Delete from List
3. Edit/Delete from Search
4. Delete Entire Directory



Enter: #<CR> to select.
       <ESC> for previous menu ...

Figure 5.2:   The Edit Password Directory Menu

5.4.1.   The Password Directory

APS-8M passwords are defined using the "Edit Password Directory" menu, which is accessed via the System Parameters menu (/F). In addition to assigning command level privileges to each password, the Edit Password Directory function also allows you to determine which ports each password will be allowed to access.  The Password Directory allows for the definition of up to 32 separate passwords.

In addition to creating, editing, and deleting passwords and assigning access rights, the Edit Password Directory function also allows you to configure several Dial Back parameters. To define new passwords, proceed as follows.  Note that the /V command can also be issued to view the Password Directory.

Note:  The Edit Password Directory menu is only available when you have logged into command mode using a password that permits access to Supervisor Mode.
  1. Access the command mode.  At the command prompt, type /F and press [Enter] to display the System Parameters Menu.


  2. At the System Parameters Menu, type 5 and press [Enter] to display the Edit Password Directory menu (Figure 5.2.)  The Edit Password Directory Menu offers the following options:


ADD NAME/PASSWORD:

1. Name:            (undefined)
2. Password:        (undefined)
3. Dial Back #:     (undefined)
4. Dial Back Mode:  Off
5. Supervisor Mode: Off
6. Port Access:     None
7. Save Entry




Enter: #<CR> to select,
       <ESC> for previous menu ...


Figure 5.3:   The Add Name/Password Menu (Defaults Shown)

  1. Adding Passwords:  From the "Edit Password Directory" menu, type 1 and press [Enter] to display the "Add Name/Password" menu shown in Figure 5.3.  The Add Name/Password Menu allows you to assign the following:


Note:  In order to access Supervisor Mode from any given port, the port at which the password is issued must also permit Supervisor Commands.

EDIT/DELETE NAME/PASSWORD:

1. Name:            test
2. Password:        (defined)
3. Dial Back #:     5556789
4. Dial Back Mode:  On
5. Supervisor Mode: On
6. Port Access:     1, 2, 3, 4, 5, 6, 7, 8
7. Save Entry
8. Delete Entry



Type: "<"<Enter> previous entry, ">"<Enter> next entry,
      <number><Enter> to selection,
      <ESC> to abort ...

Figure 5.4:   The Edit/Delete Name/Password Menu (Sample Values Shown)

  1. Editing and Deleting Passwords:  The Edit Password Directory Menu (Figure 5.2) provides two different methods for selecting the password you wish to edit or delete; by scrolling through the password list, or by search routine.


    1. From List:  To find the password from a list of all passwords, type 2, press [Enter], then follow the instructions in the resulting submenu.


    2. From Search:  To search for a specific password, type 3, press [Enter], then follow the instructions in the resulting submenu.


    3. Edit Password:  After finding the desired password, the "Edit/Delete Name/Password" Menu (Figure 5.4) will be displayed.  Items 1 through 6 are used to select and change parameters, and function identically to the corresponding items in the Add Name/Password menu. Item 7 is used to save the edited password and newly selected parameters. Note that if you exit from the menu without first saving, newly selected parameters will be discarded.


    4. Delete Password:  After finding the desired password, the "Edit/Delete Name/Password" Menu will be displayed.  To delete the password, type 8 and press [Enter].


  2. Deleting the Entire Password Directory:  To delete the Password Directory and clear all passwords, go to the "Edit Password Directory" Menu, type 4 and press [Enter].  The unit will then display a "Sure?" prompt and wait for confirmation before proceeding.


Notes:



5.4.2.   The Dial Back Function

The Dial Back Function provides an additional layer of security when callers attempt to access command mode via modem.  When this function is properly configured, callers will not be granted immediate access to command mode upon entering a valid password; instead, the unit will disconnect, and dial a user-defined number before allowing access via that number.  If desired, users may also be required to re-enter the password after the APS-8M dials back.

Note that a separate Dial Back Number can be defined for each password, and the feature may also be independently enabled for each password.  To enable the this function, proceed as follows:

  1. Access command mode using a port and password that permit Supervisor Mode.  At the command prompt, type /F and press [Enter] to display the System Parameters menu as shown in Figure 5.1.


  2. System Parameters Menu:  Note that dial back parameters selected via this menu are global, and will apply to all passwords.  Define the following parameters:


  3. Edit Password Directory:  From the System Parameters Menu, type 5 and press [Enter] to display the Edit Password Directory Menu (Figure 5.2.)  At this point, you may either define new passwords that use the Dial Back Function, or alter existing passwords to include the Dial Back Function.  The following parameters should be defined in the Add Name/Password Menu (Figure 5.3) or Edit/Delete Password/Name Menu (Figure 5.4):


Note:  In order for new parameters to be applied, you must save each password before leaving the menu.

Dial Back Example:  Assume that the unit is configured as follows:

System Parameters Menu:

Add Name/Password Menu:

Given this configuration, the unit would behave as follows:

  1. Password "test" Entered at Modem Port:  Unit confirms that password is valid, then disconnects.


  2. Dial Back:  Unit dials "555-1234" (the Dial Back Number) and waits for the user's remote modem to answer.


  3. Password on Dialback:  When the modem at the Dial Back Number answers, the APS-8M will prompt the user to enter the password before allowing access to command mode.


  4. Dial Back Attempts and Delays:  If the modem does not answer, the unit will then attempt to redial the number three times (Dial Back Attempts), and will pause for approximately 30 seconds (Dial Back Delay) between each redial.




5.5.   Port Configuration


5.5.1.   Configuration Conventions

When responding to prompts, invoking commands, and selecting items from the port configuration menus, note the following:



5.5.2.   Port Modes

The APS offers four different port operation modes; Any-to-Any Mode, Passive Mode, Buffer Mode, and Modem Mode.  The Port Modes function as follows:

For more information on Port Modes, please refer to Section 8.



PORT PARAMETERS #01:

 1. Port Name:              (undefined)
 2. Baud Rate:              9600
 3. Bits/Parity:            8-None
 4. Stop Bits:              1
 5. Handshake Mode:         RTS/CTS
 6. Port Mode:              Any-to-Any
    64. DTR Output:         Pulse
 7. Supervisor Mode:        Permit
 8. Logoff Character:       ^X
 9. Sequence Disconnect:    One Character Only
10. Timeout Disconnect:     Off
11. Response Type:          Verbose
12. Command Echo:           On
13. Accept Break:           Yes
14. Invalid Access Lockout: Off


Enter: "<" previous port,
       ">" next port,
       <ESC> exit ...

Figure 5.5:   Port Parameters Menu (Port 1 Shown)

5.5.3.   RS232 Port Configuration Menus

The Port Configuration Menus are used to select options for each of the APS-8M's RS232 ports. Parameters selected via these menus will stay in effect until the unit is initialized or the /P command is used to reconfigure the port. After initialization, parameters will revert to the defaults specified by the SetUp Switches.

To select port parameters, proceed as follows:

  1. Access the command mode. If the password prompt is displayed, key in a password that permits Supervisor Mode.


  2. Type /P, followed by the number of the port to be configured, and press [Enter].  For example, to configure Port 1, type /P 1  [Enter].  The Port Configuration menu will appear (Figure 5.5).


    1. If the /P Command is entered without the port number (e.g. /P [Enter]), the configuration menu for your resident port will be displayed.


    2. The /P command is only available to ports and passwords that permit access to Supervisor Mode.



The Port Configuration menu offers the following options:

  1. Port Name:  (Up to 16 characters) Assigns a name to the port. (Defaults: Ports 1 through 7 = undefined; Port 8 = "Internal_Modem".)


  2. Baud Rate:  Selects the baud rate for the port.  Can be set to any standard rate from 300 bps to 115.2K bps. (Default = Selected By SetUp Switches 1, 2, and 3.)


  3. Bits/Parity:  (Default = 8-None.)


  4. Stop Bits:  (Default = 1.)


  5. Handshake Mode:  Selects the handshake format for this port; XON/XOFF, RTS/CTS (hardware), Both, or None. (Default = RTS/CTS.)


  6. Port Mode:  Defines the operation mode for this port. (Default: Ports 1 through 7 = Any-to-Any Mode; Port 8 = Modem Mode).


Notes:


    When Any-to-Any, Passive, or Buffer Mode is selected, the unit will display the DTR Output prompt (item 64) as shown in Figure 5.5. The DTR Output prompt is not displayed when Modem Mode is selected.

    1. DTR Output:  Determines how DTR will react when this port disconnects. DTR can be held low, held high, or pulsed for 0.5 seconds and then held high. In the default state, DTR will pulse for 0.5 seconds and then remain high. For more information on hardware lines, please refer to Appendix A. (Default = Pulse.)


PORT PARAMETERS #03:

 1. Port Name:              (undefined)
 2. Baud Rate:              9600
 3. Bits/Parity:            8-None
 4. Stop Bits:              1
 5. Handshake Mode:         RTS/CTS
 6. Port Mode:              Modem
    61. Reset String:       ATZ
    62. Init String:        AT&C1&D2S0=1
    63. Hang-Up String:     (undefined)
 7. Supervisor Mode:        Permit
 8. Logoff Character:       ^X
 9. Sequence Disconnect:    One Character Only
10. Timeout Disconnect:     15 Min
11. Response Type:          Verbose
12. Command Echo:           On
13. Accept Break:           Yes
14. Invalid Access Lockout: Off


Enter: "<" previous port,
       ">" next port,
       <ESC> exit ...

Figure 5.6:   Port Parameters Menu; Modem Mode (Port 3 Shown)

    When the Port Mode is set to Modem Mode, the menu will include additional prompts (see Figure 5.6), which are used to define the following:

    1. Reset String:  If necessary, this prompt can re-define the modem reset string, which is sent prior to the Initialization string. (Up to 48 Chars., Default = ATZ.)


    2. Initialization String:  Defines a command string that can be sent to initialize a modem to settings required by your application. (Up to 48 Characters, Defaults: Port 1 through 7 = AT&C1$D2S0=1; Port 8 =ATM0&C1$D2S0=1.)


    3. Hang-Up String:  Although the APS will pulse the DTR line to hang-up an attached modem, the Hang-Up string is often useful for controlling modems that do not use the DTR line. (Up to 48 Characters, Default = undefined.)


Notes:

  1. Supervisor Mode:  Permits or denies access to Supervisor Mode at this port. When enabled (Permit), and a password that permits Supervisor Mode is entered, the port will allow access to Supervisor Mode commands. When disabled (Deny), the port will not enter Supervisor Mode, even when a password that normally permits access to Supervisor Mode is entered. (Default = Permit.)


Note:  The Supervisor Mode cannot be disabled at Ports 1 or 2.
  1. Logoff Character:  Defines the Logoff Character for this port.  The Logoff Character determines the command(s) or character(s) that must be issued at this port in order to disconnect from a second port (Resident Disconnect).  (Default = ^X ([Ctrl] plus [X].)


Note:  When redefining the Logoff Character, make certain to select a character that does not normally occur in your data.
  1. Sequence Disconnect:  Enables/Disables and configures the Resident Disconnect command. This prompt offers the option to either disable the Sequence Disconnect, or select a one character format or a three character format. (Default = One Characters.) Note the following:


  2. Timeout Disconnect:  Enables and selects the Timeout Period for this port.  If enabled, and the port does not receive or transmit data for the specified Timeout Period, the port will disconnect. In Any-to-Any Mode, Passive Mode, or Buffer Mode, the default setting for this item is "OFF". When the port is set for Modem Mode, the default setting for this item is 15 minutes.


Notes:

  1. Response Type:  Selects the type of messages that this port will send in response to commands.  The user can select Verbose (English Text), Terse (Numeric / Abbreviation), or Quiet Mode (No Response). (Default = Verbose.)


  2. Command Echo:  Enables or Disables the command echo for this port. (Default = On.)


  3. Accept Break:  Determines whether the port will accept breaks received from the attached device, and pass them along to a connected port. When enabled, breaks received at this port will be passed to any port that this port is connected to, and sent along to the device connected to the other port. When disabled, breaks will be refused at this port, and hence, not sent to the other port. (Default = Yes.)


  4. Invalid Access Lockout:  Enables/Disables the Invalid Access Lockout feature as described in Section 5.5.4. Briefly, the Invalid Access Lockout feature can be used to automatically disable a port when a user-defined number of invalid access attempts are detected. (Default = Off.)




5.5.4.   The Invalid Access Lockout Feature

When properly configured and enabled, the Invalid Access Lockout feature will watch all login attempts made at a given port.  If the port exceeds the selected number of invalid attempts, then that port will be automatically disabled for a user-defined length of time.

Note that when an Invalid Access Lockout occurs, you can either wait for the Lockout Duration period to elapse, or issue the /UL command to instantly unlock all ports.

Note:  The Invalid Access Lockout feature can be individually enabled/disabled at each port.

The Invalid Access Lockout Feature is configured and enabled using the Port Parameters Menu for the desired port.  When "Invalid Access Lockout" is selected, the APS-8M will display a submenu which allows you to configure the following parameters:



COPY PORT PARAMETERS:

 1. Port Name:
 2. Baud Rate:
 3. Bits/Parity:
 4. Stop Bits:
 5. Handshake Mode:
 6. Port Mode:
    64. DTR Output:
 7. Supervisor Mode:
 8. Logoff Character:
 9. Sequence Disconnect:
10. Timeout Disconnect:
11. Response Type:
12. Command Echo:
13. Accept Break:
14. Invalid Access Lockout:

(note: ports 1 & 2 will NOT have restricted values changed.)
Enter: parameter # <CR> to define parameter value to copy to all ports,
       -<CR> to remove all values set,
       X<CR> to exit WITHOUT copy,
       <ESC> to copy to ports and exit ...

Figure 5.7:   The Copy Port Parameters Menu

5.6.   Copying Parameters to All Ports

The /CP command (Copy Port Parameters) provides a convenient means for selecting similar parameters for all APS RS-232 ports.

When the /CP command is invoked, the unit will display a menu which allows you to select port communication parameters, then copy them to all APS RS-232 ports. The Copy Port Parameters menu can be used to set all parameters for all RS-232 Ports, or define only a select group of parameters and then copy them to all ports.

Notes:

To select common parameters for all APS RS-232 ports, proceed as follows:

  1. Access the command mode. If the password prompt is displayed, key in a password that permits Supervisor Mode.


  2. At the command prompt, type /CP and press [Enter], the menu shown in Figure 5.7 will be displayed.


  3. Selecting Parameters:  To select parameters to be copied, key in the number for the desired parameter, press [Enter], and then follow the instructions in the submenu. Note that it is not necessary to define all port parameters, for example, the /CP command could be used to select only the Baud Rate for all ports.


  4. Clear Menu:  After defining several parameters, if you wish to clear the /CP menu and start again, type - (dash) and press [Enter], the menu will be reset.


  5. Exit Without Copy: To exit from the Copy Parameters menu without copying selected parameters to all RS232 ports, type X and then press [Enter]. The APS will exit from the Copy Parameters menu and return to the command prompt.


  6. Copy Parameters:  When you have finished selecting parameters, press [Esc] to copy the selected parameters to all APS RS-232 Ports and exit from the Copy Port Parameters menu. Note that the APS will display a "Sure" prompt before copying parameters to other ports.




5.7.   Save User Selected Parameters

Although this step is optional, it is strongly recommended to save all user-defined parameters to an ASCII file. This will allow quick recovery in the event of accidental deletion or reconfiguration of port parameters. Section 9 describes the procedure for saving configuration parameters to an ASCII file.