T1/E1 Analysis

File based HDLC Record/Playback over SA-bits


The File based HDLC Record/Playback over SAbits (SaBitsFunc) module is an optional application that allows receive and transmit of HDLC frames in *.hdl file format.


  • Receiving SA HDLC frames in HDL files
  • Transmitting SA HDLC frames from an HDL file

Syntax Notation

All the parameters must be entered in the order defined by the syntax. [parm] means that the parameter is optional and can be omitted.

Parm1|Parm2|Parm3 - parameter is mandatory, one of the choices Parm1, Parm2 or Parm3 must be specified

  • Transmission of SA HDLC frames from an HDL file


    run task "SaBitsFuncE1:SaBitsTxFile" using " 'File_Name' CONT|EOF|N_frames [0xSM] [FLAGS nFlags] " .


    'File_Name' - name of HDL file in single quotes to transmit
    CONT - transmit file in round robin fashion (after the last frame transmit the 1st frame)
    EOF - transmit an entire file once
    N_frames - transmit N_frames. If file is shorter than N_frames start transmitting the 1st frame after the last frame till N_frames are transmitted
    0xSM - SA bit mask
    FLAGS nFlags - number of flags (0x7E) between frames to transmit


    run task "SaBitsFuncE1:SaBitsTxFile" using "'c:\test.hdl' 3 Flags 1000" #1;
    Transmit first three frames on card 1 with 1000 flags between frames

    run task "SaBitsFuncE1:SaBitsTxFile" using "'c:\data files\test.hdl' CONT" #1;
    Continuously transmit file c:\data files\test.hdl'
  • Receiving SA HDLC frames into an HDL file


    run task "SaBitsFuncE1:SaBitsRxFile" using " 'File_Name' FileSize CONT|N_frames [FAS|NON-FAS] [0xSM] "


    'File_Name' - name of HDL file in single quotes to saved received frames to
    FileSize - maximum disk file size in bytes
    CONT - record frames in circular fashion, i.e. when the file capacity (size) is reached purge earlier frames.
    N_frames - receive up to N_frames.
    [FAS|NON-FAS] - FAS (default) receive in Frames 1,3,5.. , NON-FAS receive in frames 0,2,6,.. of each multiframe
    0xSM - SA bits mask


    run task "SaBitsFuncE1:SaBitsRxFile" using "'c:\test.hdl' 10000000 100000" #1;
    receive into file c:\test.hdl (allocate 10MB disk space for the file) up to 100000 frames SA4-SA8

For additional syntax click here to download the sample script


Please Note: The XX in the Item No. refers to the hardware platform, listed at the bottom of the Buyer's Guide, which the software will be running on. Therefore, XX can either be ETA or EEA (Octal/Quad Boards), PTA or PEA (tProbe Units), UTA or UEA (USB Units), HUT or HUE (Universal Cards), and HDT or HDE (HD cards) depending upon the hardware.

 Back to Client/Server Scripted Control Software Page