JAMMER

1
JAMMER

• B-ISDN ATM Course
• Dr. Mansoor Alam

2
Communication Structure
3
Jammer What is it ?

• Simple Programming Language for WUGS
• Interactive and Batch Oriented Input
• Programming Constructs
• Integer variables and Arrays
• Iterations
• Conditionals
• Procedures
• Gives you complete access to all bits in WUGS
  registers and tables.
• Allows you to write ANY value to any register
• No range checking
• No correctness checking
• Allows for testing the correct operation of the
  switch

4
Jammer Command Line Usage

• Typical Usage
• Jammer 0.1 ut105194 3552
• This would cause Jammer to try to connect to the
  GBNSC listening on port 3552 and running on the
  host ut105194.
• The 0.1 can later be used by Jammer to identify
  this switch controller. Not very useful anymore.
• Another usage
• Jammer 0.1 ut105194 3552 template.js
• Same as above PLUS
• Jammer will read in the batch file template.js
  and process it.

5
Jammer Commands

• Switch Manipulating
• Session
• Testing
• Programming Constructs

6
Jammer Switch Manipulating Commands

• reset sm reset the switch
• write mr write a maintenance register
• write vcxt write an entry to virtual circuit
  tables
• write vpxt write an entry to virtual path
  tables
• read mr read a maintenance register
• read vcxt read a Virtual Circuit Table entry
• read vcxtcc read the cell counter for a vcxt
  entry
• read vpxt read a Virtual Path Table entry
• read vpxtcc read the cell counter for a vpxt
  entry

7
Contd.

• Clear vpxt clear a particular vpxt entry
• Clear vcxt clear a particular vcxt entry
• Clear vxt clear ALL vcxt and vpxt entries at
  a port
• Clear errors clear all the error bits in all
  the maintenance registers
• Build merge receive recycle xmit commands
  that make it easier to build multipoint to
  multipoint recycling connection trees.

8
Jammer Session Commands

• comments allows embedded comments
• help prints a terse list of commands
• quit exit Jammer
• echo String print String, may include var
• pause N pause for N seconds
• upause N pause for N microseconds
• shutdown kill GBNSC that jammer is connected
  to
• wait wait for all outstanding operations
• waiting checks for outstanding operations
• prompt String print String and wait for
  ltreturngt from user

9
Contd

• ltvargt prompt String same, takes ltvaluegt
  ltreturngt, var ? ltvaluegt
• date print current date and time
• cd change working directory
• set switch change the switch to which
  Jammer is communicating
• ltCtrl-Cgt interrupt a Jammer script
• !ltcommandgt execute a Unix shell command

10
Testing Related Commands

• ping sm Pings the switch to make sure
  it is alive
• ping sc Pings the switch controller to
  see if it is alive
• test cell0 Send a test cell through switch
  , no recycling, (ping sm)
• test cell1 Send a test cell through switch
  with one recycling pass
• test cell2 Send a test cell through switch
  with two recycling pass

11
Recycling Passes
12
Contd.

• get cells receives cells from switch and
  verifies payload
• put cells Injects cells into switch with
  specified payload
• Failed keeps track of whether any
  commands have failed

13
Jammer Programming Structures

• if-else-fi Conditional block
• proc-end Procedure block
• while-done Loop
• return return from proc, no return value
• include ltfilegt include a batch file
• int var declare an integer variable
• int varrange declare an integer array
  variable

14
Contd

• int var declare an integer array
  proc param
• var evaluate an integer variable
• varindex evaluate an integer array
  variable
• Expressions , -, , /, , --, lt, gt, lt, gt,
  , !, ( ) are there for building expressions.

15
Jammer Examples

• A basic script
• Setting up a connection
• Iterative Testing
• Data Cells
• An Interactive Session

16
A Basic Script

• this sample prints Hello! Message to screen
• proc PrintToScreen()
• echo Hello!
• end
• Save as print_to_screen.js
• At the Jammer prompt type
• include print_to_screen.js
• This includes PrintToScreen proc into the current
  session
• Invoke the procedure by typing
• PrintToScreen()

17
Jammer Example Setting up a Connection
18
Iterative Testing

• define port processor and vcxt control variables
• Int pp
• Int vcxt_num
• Pp 0
• loop thru all port processors
• While(pp lt 8)
• vcxt_num 0
• echo vcxt_testtesting VCXT table pp at all
  entries.
• loop thru all vcxts
• while(vcxt_num lt 1023)
• write zero values to each field
• write vcxt pp vcxt_num 0 0 0 .0
• vcxt_num
• done
• wait for all outstanding tests to complete
• wait
• test for failures
• if (failed)
• echo vcxt_test write to VCXT index pp
  FAILED

CLEAR VCXT
19
An Interactive Session
20
Data Cell Testing

• Enter command write mr 0 2 0 128 32 0 255 1 1 1
  1 1048576 0
• Enter command write vpxt 0 0 1 2 1 0 0 0 0 0 0 1
  0 0 0 0 0 0000
• Enter command write vcxt 0 50 1 2 1 00 0 0 0 0 1
  00 50 1 00000
• Enter command get cells 0 50
• Number of Cells to expect 1 1
• Number of sec to wait for cells to return (0
  for MAX) 0
• Number of times to repeat pattern ( 0 for NO
  pattern) 0
• Enter command put cells 0 50
• Number of cells to send 1 1
• Number of times to repeat pattern (0 for NO
  pattern) 0
• Enter command
• JAMMERLIST Put cells operation completed
  succesfully
• Enter command
• JAMMERLIST Get cells operation completed
  succesfully

21
Jammer Hints

• Use three windows
• GBNSC or GBNSC.init
• Jammer
• Your favorite editor
• as you try commands in Jammer you can put them in
  a file for later use as a batch file
• Useful cell counters are in
• VCXTCC
• MR 4
• MR 15
• Error bits and error counters are in
• MR 3
• MR 4
• MR 5
• MR 14
• MR 16