Table of Contents Index NMS Glossary Previous Page Next Page Version


Appendix F

Sub-Addressing


About Sub-Addressing
Using Sub-Addressing

About Sub-AddressingTop of Page

The optional sub-addressing signal allows you to transmit or receive fax routing information during a fax session. The server can use the additional information to determine which extension should receive the fax. The SUB signal indicates that the following facsimile information field (FIF) information is sub-addressed in the called subscriber's domain. It can not be used to provide additional routing information in the facsimile procedure. SUB is only sent if bit 49 in the digital identification signal/digital transmit command (DIS/DTC) is sent.

The T.30 protocol recommends that the SUB signal contain 20 numeric digits. The least significant bit of the least significant digit is the first bit transmitted. Fill the unused octets in the information field with space characters, and right justify the information.

Sub-address information is available in the remoteSUB field of the NFX_FAX_STATUS structure. The sub-sent flag indicates if the sub-address string was sent. This flag is set only when sub-address information is sent.


typedef struct 
{
 DWORD size;
 DWORD rate; 
 DWORD ecm;    /* error correction mode: NFX_YES or NFX_NO     */
 DWORD resolution;
 DWORD encoding;
 DWORD pagewidth;
 DWORD mode;    /* NFX_MODE_IDLE, NFX_MODE_NEGOTIATING,        */
                /* NFX_MODE_TRANSMITING, NFX_MODE_RECEIVING,   */
                /* NFX_MODE_DISCONNECTING, NFX_MODE_FINISHED   */
 DWORD error;     /* Last error code generated                 */
 DWORD docnumber; /* Current document in progress              */
 DWORD pagenumber;/* Current page of the document              */
 DWORD badlines;  /* Number of bad lines (or bad frames in     */
                  /* ECM mode) during current session          */
 char filename[NFX_FILENAME_MAX]; 
                  /* Name of current file processed            */
 char remoteSID[NFX_MAX_SID];
                  /* Received SID from remote station          */
 BYTE remoteNSF[NFX_MAX_NSF];
                  /* Received NSF from remote station          */
 DWORD snr;       /* signal to noise ratio in dB               */
 DWORD rx_training_zeros;
                  /* training zeros in the TCF                 */
                  /* in tens of milliseconds                   */

 char remoteSUB[NFX_MAX_SUB];
                  /* Received Sub-Address string from          */
                  /* remote station                            */
 DWORD sub_sent;
                  /* Set if Sub-Address frame is sent to       */
                  /* remote station                            */
 DWORD modemtype; /* modem used to transfer document           */
} NFX_FAX_STATUS;

Using Sub-AddressingTop of Page

NaturalFax supports the sub-addressing feature for sending and receiving. By default, sub-addressing is enabled on the receive side and disabled on the sending side. To enable the sub-addressing feature, set useSUBADD to NFX_YES in NFX_TRANSMIT_PARMS or NFX_RECEIVE_PARMS.

In NaturalFax demonstration programs, nfxsend uses -a subaddress to enable or disable the sub-addressing feature. If -a subaddress is used by nfxsend, a transmitter sends sub-address information to the receiver depending on the receiver's capability. If the receiver does not support this feature, the user is notified that sub-address information was not sent, but that the fax was sent.

The following example shows sub-addressing enabled:

nfxsend -plps0 -d555 -s0:0 -a 12549 -v sample.tif
nfxrecv -plps0 -s0:2 -v receive.tif

The following example shows sub-addressing disabled:

nfxsend -plps0 -d5555 -s0:0 -v sample.tif


Table of Contents Index NMS Glossary Previous Page Next Page Version


Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2001, NMS Communications Corporation. All rights reserved.