getNotify User's Guide

January 13, 2012

Table of Contents

Overview

Running the getNotify Program

Example Output

Overview

The getNotify program is a diagnostic routine to connect to awips qpid server, receive notifications of data changes, and then output the notifications to the terminal window. It is handy for diagnosing notifications that are sent from the server.

Running the getNotify Program

The command line syntax is:
python getNotify.py -h hostname -p portNumber [-u user] [-l] [-g] [-d] [-m] [-v]

A sample command line is:
python getNotify.py -h cpsbn1 -p 5672 -g

Option Syntax Optional or Mandatory Description
-h hostname Mandatory (See note) Specifies the host, upon which the awips qpid server is running
-p port Mandatory (See note) Specifies the port, upon which the awips qpid server is running
-u user Optional Specifies the user on connection to the awips qpid server. Defaults to the current UNIX login name.
-l Optional If specified, outputs detailed information about lock notifications.
-g Optional If specified, outputs detailed information about grid update notifications.
-d Optional If specified, outputs detailed information about database inventory change notifications.
-m Optional If specified, outputs detailed information about user message notifications.
-v
 Optional
 If specified, outputs detailed information about the VTEC Table Change Notifications.

Example Data

The following shows some example output and how it is interpreted. This example uses just the -h and -p switches so the program output simply lists the number of received notifications.

Basic Execution

dx3-nhda{jdynina}112: python getNotify.py -h cpsbn1 -p 5672
Get Notifications Diagnostic Program
Establishing connection to broker on cpsbn1
Establishing connection to broker on cpsbn1
Connection complete to broker on cpsbn1
Connection complete to broker on cpsbn1
L=0,G=42,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=25,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=85,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=38,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=29,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=38,D=0,S=0,R=0,C=0,T=0,U=1,B=0,V=0,
L=0,G=9,D=0,S=0,R=0,C=0,T=0,U=1,B=0,V=0,
L=0,G=3,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=3,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=53,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=14,D=0,S=0,R=0,C=0,T=0,U=1,B=0,V=0,
L=0,G=65,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,

The following table describes the symbol and its meaning:
 
L Lock Notifications
G Grid Update Notifications
D Database Inventory Change Notifications
M User Message Notifications
V
 VTEC Table Change Notifications

Note: For AWIPS2, a decision was made to not support the following notification types:

*SampleNotification
*ReferenceNotification
*ColorSpectrumNotification
*TextFileNotification
*ProcessStatusNotification

because of the architectural differences between AWIPS1 and AWIPS2, these specific notifications will not be supported by getNotify.

Execution with -l switch

The lock notification message contains the weather element identifier (ParmID), and the new lockTable. Note, no locks were detected in this case.

dx3-nhda{jdynina}113: python getNotify.py -h cpsbn1 -p 5672 -l
Get Notifications Diagnostic Program
Establishing connection to broker on cpsbn1
Establishing connection to broker on cpsbn1
Connection complete to broker on cpsbn1
Connection complete to broker on cpsbn1
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=13,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=9,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=8,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=8,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,

Execution with -g switch

The grid update notification message contains the replacement time range, the weather element identifier (ParmID), and the replacement times of the grids.

dx3-nhda{jdynina}115: python getNotify.py -h cpsbn1 -p 5672 -g
Get Notifications Diagnostic Program
Establishing connection to broker on cpsbn1
Establishing connection to broker on cpsbn1
Connection complete to broker on cpsbn1
Connection complete to broker on cpsbn1
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=21,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
GRID=[
ParmID: WVPER_SFC:LWX_GRID_D2D_EPwave10_20120113_1200
Replacement TimeRange: (Jan 20 12 12:00:00 , Jan 20 12 13:00:00 )
Histories: {(Jan 20 12 12:00:00 , Jan 20 12 13:00:00 ): [Origin: INITIALIZED
Origin Parm: WVPER_SFC:LWX_GRID_D2D_EPwave10_20120113_1200
Origin Time Range: (Jan 20 12 12:00:00 , Jan 20 12 13:00:00 ) Time Modified: None Who Modified: None
Update Time: None
Publish Time: None
Last Sent Time: None
]},
ParmID: PERPW_SFC:LWX_GRID_D2D_EPwave10_20120113_1200
Replacement TimeRange: (Jan 20 12 12:00:00 , Jan 20 12 13:00:00 )
Histories: {(Jan 20 12 12:00:00 , Jan 20 12 13:00:00 ): [Origin: INITIALIZED
Origin Parm: PERPW_SFC:LWX_GRID_D2D_EPwave10_20120113_1200
Origin Time Range: (Jan 20 12 12:00:00 , Jan 20 12 13:00:00 ) Time Modified: None Who Modified: None
Update Time: None
Publish Time: None
Last Sent Time: None
]}

Execution with -d switch

The database inventory change notification message contains the updated inventory, the additions, deletions.

dx3-nhda{jdynina}116: python getNotify.py -h cpsbn1 -p 5672 -d
Get Notifications Diagnostic Program
Establishing connection to broker on cpsbn1
Establishing connection to broker on cpsbn1
Connection complete to broker on cpsbn1
Connection complete to broker on cpsbn1
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=60,D=1,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
DB=[
Inventory[AFC_GRID__Restore_00000000_0000,
AFC_GRID_Test_Fcst_00000000_0000, AFC_GRID__ISC_00000000_0000,
AFC_GRID__RTMA_00000000_0000, AFC_GRID__SAT_00000000_0000, AFC_GRID__MSAS_00000000_0000,
AFC_GRID__Official_00000000_0000, AFC_GRID__Fcst_00000000_0000,
AFC_GRID_Prac_Fcst_00000000_0000, AFC_GRID__LAPS_00000000_0000, AFC_GRID__AKWAVE_20120113_0000,
AFC_GRID__AKWAVE_20120113_0600, AFC_GRID__MOSGuide_20120112_1200,
AFC_GRID__MOSGuide_20120113_0000, AFC_GRID__NAM12_20120113_0000, AFC_GRID__NAM12_20120113_0600,
AFC_GRID__NamDNG5_20120113_0000, AFC_GRID__NamDNG5_20120113_0600,
AFC_GRID_D2D_NAM40_20120113_1200, AFC_GRID_D2D_UKMET-NorthernHemisphere_20120113_1200,
AFC_GRID_D2D_TPCProb_20120113_1200, AFC_GRID_D2D_AKWAVE_20120113_0000,
AFC_GRID_D2D_OPCTAFBNW_20120111_0000, AFC_GRID_D2D_NAM20_20120113_1200,
AFC_GRID_D2D_ENSEMBLE_20120113_0000, AFC_GRID_D2D_NAM95_20120113_0000,
AFC_GRID_D2D_TPCProb_20120112_0000, AFC_GRID_D2D_TPCProb_20120113_0000,
AFC_GRID_D2D_gfsLR_20120113_0000, AFC_GRID_D2D_MOSGuide_20120112_1200,
AFC_GRID_D2D_TPCProb_20120112_0600, AFC_GRID_D2D_RTMA_20120113_1400,
AFC_GRID_D2D_TPCProb_20120111_1800, AFC_GRID_D2D_GlobalWave_20120113_0600,
AFC_GRID_D2D_OPCTAFBNW_20120113_1200, AFC_GRID_D2D_NAM95_20120113_1200,
AFC_GRID_D2D_GFS190_20120113_0600, AFC_GRID_D2D_GFS190_20120113_1200,
AFC_GRID_D2D_TPCProb_20120112_1800, AFC_GRID_D2D_gfsLR_20120112_0000,
AFC_GRID_D2D_ENSEMBLE_20120112_1200, AFC_GRID_D2D_GlobalWave_20120113_1200,
AFC_GRID_D2D_WaveWatch_20120113_0600, AFC_GRID_D2D_RTMA_20120113_1500,
AFC_GRID_D2D_TPCProb_20120112_1200, AFC_GRID_D2D_NamDNG5_20120113_1200,
AFC_GRID_D2D_AKWAVE_20120113_0600, AFC_GRID_D2D_OPCTAFBNW_20120113_0000,
AFC_GRID_D2D_GFS190_20120113_0000, AFC_GRID_D2D_MOSGuide_20120113_0000,
AFC_GRID_D2D_NamDNG5_20120113_0600, AFC_GRID_D2D_gfsLR_20120111_0000,
AFC_GRID_D2D_OPCTAFBNW_20120111_1200, AFC_GRID_D2D_NAM12_20120113_1200,
AFC_GRID_D2D_OPCTAFBNW_20120112_1200, AFC_GRID_D2D_OPCTAFBNW_20120112_0000,
AFC_GRID_D2D_OPCTAFBNW_20120108_1200, AFC_GRID_D2D_TPCProb_20120113_0600,
AFC_GRID_D2D_OPCTAFBNW_20120109_0000, AFC_GRID_D2D_UKMET-NorthernHemisphere_20120113_0600,
AFC_GRID_EditTopo_Topo_00000000_0000, AFC_GRID_D2D_PRISMClimo_00000000_0000,
AFC_GRID_D2D_NCDCClimo_00000000_0000, AFC_GRID_D2D_CRMTopo_00000000_0000,
AFC_GRID_D2D_NED_00000000_0000, AFC_GRID_D2D_AKWAVE_20120113_1200]
Additions[AFC_GRID_D2D_AKWAVE_20120113_1200]
Deletions[],
]

Execution with -m switch

The user message notification consists of the message, and the priority.

dx3-nhda{jdynina}117: python getNotify.py -h cpsbn1 -p 5672 -m
Get Notifications Diagnostic Program
Establishing connection to broker on cpsbn1
Establishing connection to broker on cpsbn1
Connection complete to broker on cpsbn1
Connection complete to broker on cpsbn1
L=0,G=7,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=8,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=15,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=11,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=6,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
USER=[
Message: ISC: PBZ ['MinT'] (21/00->21/13) #Grids=1
Priority: EVENTA
Category: ISC
,
]

Execution with -v switch

The vtec table change notification consists of the table name, modification time, and modification source:
dx3-nhda{jdynina}118: python getNotify.py -h cpsbn1 -p 5672 -v
Get Notifications Diagnostic Program
Establishing connection to broker on cpsbn1
Establishing connection to broker on cpsbn1
Connection complete to broker on cpsbn1
Connection complete to broker on cpsbn1
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
L=0,G=0,D=0,S=0,R=0,C=0,T=0,U=0,B=0,V=0,
VTEC=[
Table Name: 'OPERATIONAL'
ModTime: Jan 13 12 16:54:25 GMT
ModSource: VTECDecoder,
]