Skip to main content

Need Help Using Spok Knowledge?

Internet Explorer is not supported. Please reload in Chrome, Edge, Firefox, or Safari.
Spok

Spok Messenger Gateways: TAP

TAP Gateways are defined as sources or destinations for TAP messages, and may include hardware encoders, wide area paging carriers, or third party equipment. TAP gateways can be accessed by going to the Interfaces > TAP menu option.

 

A description of the fields is shown below:

Name

The name that appears in the Gateway port list.

Password

The six character password as defined in the TAP protocol.

Max msg length

The longest text message that can be sent to a device or contact through this gateway. If the gateway receives a longer message, it is truncated to the maximum message length, or split, depending on the Split long messages setting described below.

Max Messages

The maximum number of messages that are allowed in the queue. Please note that the maximum value for this field is 200.

Ports

Refers to the physical connections that this gateway utilizes. To add, edit, or delete an existing port from this gateway, simply select the port and use the buttons to the right of the Ports panel. Please note that configuring multiple ports to one gateway has the effect of pooling those ports, that is, the first available port is used for message delivery.

Gateway enabled

Determines whether or not the gateway is functional. It is convenient to disable this setting to temporarily stop messaging to one device.

TAP Input

Enable the TAP Input option if you would like to enable the gateway to receive incoming messages. When the TAP Input option is enabled, the gateway becomes an incoming gateway. 

Hold time

The number of seconds that normal messages are delayed before sending. This feature may be useful for modem connections, as messages may be sent in a single batch, and hence fewer telephone calls are made.

Remove Callback Metadata

Strips meta data from output messages.

Priority hold time

The number of seconds that priority messages are delayed before sending. This feature may be useful for modem connections, as messages may be sent in a single batch, and hence fewer telephone calls are made.

Phone

The telephone number to dial for access to dial up TAP equipment. It is only used if the port used for this gateway is configured for modem operation.

Message Retries

The number of attempts that should be made to deliver a message.

Abort after failed connections

The number of times an attempt to connect to a remote TAP device is performed.

Split long messages

Enable this option if you would like messages that are longer than the set number of characters to be sent as separate messages.

 

Supporting Incoming and Outgoing TAP Interfaces

Both incoming and outgoing TAP interfaces are supported. When you create a TAP gateway, the TAP input option is used to determine whether the TAP interface is incoming or outgoing:

  • Enable the TAP input option if the gateway is an incoming TAP interface.
  • Disable the TAP input option if the gateway is an outgoing TAP interface.

Adding a TAP Gateway

A single screen is provided to manage TAP Gateways.

  1. Choose Interfaces > TAP. The TAP Gateways screen displays. If a TAP gateway had been previously created, the screen is populated with information about the gateway.
  2. Click New. The fields can be edited.
  3. In the Name field, enter the name of the gateway as it should appear in the Gateway port list.
  4. In the Password field, enter the six-character password as defined in the TAP protocol.
  5. In the Max Msg Length field, enter the length of the longest text message that can be sent to a device or contact through this gateway. If the gateway receives a longer message, it is truncated to the maximum message length, or split, depending on whether the Split long messages option has been selected. If this option is selected, messages over the maximum message length are split.
  6. In the Max Messages field, enter the maximum number of messages that can be sent in one TAP login session.
  7. In the Ports window, click the Add button to add the ports (the physical connections) used by this gateway. Note that configuring multiple ports to one gateway has the effect of pooling those ports: the first available port is used for message delivery.

When adding a port, if no ports appear in the port list, you need to configure a port to use the TAP protocol in the in the Ports screen. For more information about creating a TAP port, please refer to TAP Ports.

After a port has been added, you can select the port and click Edit to edit the port configuration and click Delete to remove the port

  1. From the Port list box, select the port that you want to use for this gateway.
  2. From the Baud list box, select the baud rate for the port. The information in the Baud field sets the communication rate for serial communication.
  3. From the Data list box, select the option for the data. The information in the Data field sets the number of data bits for serial communication.
  4. From the Parity list box, select the option for the parity. The information in the Parity field sets the type of parity for serial communication.
  5. From the Stop list box, select the option for the stop bit. The information in the Stop field sets the number of stop bits for serial communication.
  6. Click OK to save the choices. The Port window is populated with the port selected.
  1. The Gateway Enabled option determines whether or not the gateway is functional. It is convenient to disable this setting to temporarily stop messaging to one device.
  2. The TAP Input option determines whether the TAP Output Settings or the TAP Input Settings section is displayed.
  3. Click Save to save the new TAP gateway.

 

Configuring an Outgoing TAP Interface

Display the TAP Output Settings section by disabling the TAP Input option. The following fields are available in the TAP Output Settings section:

Hold time

Enter the number of seconds that normal messages are delayed before sending. This feature may be useful for modem connections, as messages may be sent in a single batch, and as a result, fewer telephone calls are made.

Remove Callback Metadata

Choosing this option removes the metadata from the output messages.

Priority hold time

Enter the number of seconds that priority messages are delayed before sending. This feature may be useful for modem connections, as messages may be sent in a single batch, and as a result, fewer telephone calls are made.

Phone

Enter the telephone number to dial for access to dial up TAP equipment. It is used if the port used for this gateway is configured for modem operation.

Message Retries

The number of attempts that should be made to deliver a message.

Abort after x failed connections

Enter the number of times an attempt to connect to a remote TAP device can fail before the attempt to connect is aborted.

Split long messages

Causes messages longer than the maximum message length specified in the Max msg length field to be sent as separate sequential messages.

 

 

Configuring an Incoming TAP Interface

Display the TAP Input Settings section by selecting the TAP Input option. The General tab displays.


 

Ignore checksum

This option determines whether checksum is ignored on received TAP messages. This is used for compatibility with systems that calculate the checksum incorrectly. Choose this option to ignore checksum on received TAP messages.

Ignore login

Determines whether the login password should be ignored, which means the system does not require a log in. This is used for compatibility with systems where that password cannot be configured or the system didn’t login at all. Choose this option to ignore the password.

Verbose errors

Determines whether descriptive errors should be sent to remote devices. This is used for compatibility with systems that cannot handle descriptive errors. If not selected, descriptive errors are not sent to remote devices.

Deferred acknowledgement

Determines whether incoming requests are acknowledged as sent until the target gateway for those messages has confirmed delivery.

When this option is selected, incoming requests are not acknowledged as sent until the target gateway for those messages has confirmed delivery. When this option is not selected, incoming requests are acknowledged as sent without waiting for delivery confirmation.

Never disconnect

Determines compatibility for systems that do not log out correctly. Select this option to ensure compatibility with systems that do not log out correctly.

Disable 'ID=' every 2 seconds

When selected on an input gateway, this option prevents the server emitting the protocol's ID= string until a carriage return is received.

Disable Response Codes

Choose this option if the system is using version 1.5 or earlier of TAP.

 

Editing a TAP Gateway

An existing TAP gateway can be edited.

  1. Choose Interfaces > TAP. The TAP Gateways dialog displays.
  2. From the list of TAP gateways, select the gateway you want to change. The fields are populated with information about the selected gateway.
  3. Make the desired changes.
  4. Click Save to save your changes.

Deleting TAP Gateways

An existing TAP gateway can be deleted.

  1. Choose Interfaces > TAP. The TAP Gateways dialog displays.
  2. From the list of TAP gateways, select the gateway to be deleted.
  3. Click Delete or press the delete key on the keyboard. A confirmation dialog displays.
  4. Click Yes to delete the gateway.