publishGFE User's Guide

April 4, 2006
Table of Contents

Overview

Running the publishGFE Program

Example Output

Overview

The publishGFE is a program to allow publishing of Fcst data to the Official database from a command line.

Running the publishGFE Program

 
The command line syntax is:
publishGFE -h hostname -r portnumber [-p parm] [-t namedTR] [-s startTime] [-e endTime] [-u user]

A sample command line is:
publishGFE -h dx4f -r 98000000 -t "Day 3" -u awipsusr
 
Option Syntax Optional or Mandatory Description
-h hostname Mandatory (See Note) Specifies the host, upon which the ifpServer is running.
-r port Mandatory (See Note) Specifies the port, upon which the ifpServer is running.
-p parmName Optional. May have more than one -p switch. Specifies the parm name to publish, such as "MaxT". You can also specify a level for non-surface based elements, such as "Wind_3K".  The underscore character separates the parameter name from the level.
-t namedTR Optional. Supersedes any -s and -e switches. Defines the time range over which to publish.  This is a user-defined named time range.
-s startTime Optional. Format: yyyymmdd_hhmm Defines the starting time range over which to publish. 
-e endTime Optional. Format: yyyymmdd_hhmm Defines the ending time range over which to publish.
-u user Optional.  The connection to the ifpServer will be made using this user, which defaults to "SITE". This switch may be necessary if the -t switch is given and it refers to a non-SITE defined time range.
Note: The -h serverhost and -r port are predefined based on your installation configration of GFESuite.  The -h and -r will be defined for the server host and port specified during installation.    If you wish to connect to another server, then these switches will be necessary.   If environment variables ${CDSHOST} or ${CDSPORT} are defined, then the default server and port will be determined from the environment variables, unless overridden with the user specified -h and -r switches.

Example Execution

The following shows an example of publishing MaxT and MinT data over the time range defined by "Hour 0-240".

camper > publishGFE -h dx4f -r 98000000 -p MaxT -p MinT -t "Hour 0-240"

13:20:10.023 publishGFE.C 41 EVENT: Publish Fcst Data to Official
13:20:10.028 Client.C 161 EVENT: Establishing connection to server on polaris:98000000 ver=20020626
13:20:10.042 Client.C 177 EVENT: Connection complete to server on polaris
13:20:10.100 publishGFE.C 205 EVENT: Publishing: MaxT (Aug 26 02 06:00:00 GMT, Sep 05 02 06:00:00 GMT)
13:20:10.102 publishGFE.C 209 EVENT: Publishing: [ParmId: MaxT_SFC:BOU_GRID__Fcst_00000000_0000 CommitTR: (Aug 26 02 06:00:00 GMT, Sep 05 02 06:00:00 GMT) ]
13:20:10.305 publishGFE.C 221 EVENT: Publish completed