•         advanced

Unidata McIDAS-X/-XCD - v2005 Release Notes

Before Installing McIDAS-X

Please take the time to read this entire document; its important to understand the whole procedure before you begin. If you connect to ADDE remote servers at other sites, contact the site coordinators at those sites. The site coordinators can tell you if any server problems that might affect your system were noted since this upgrade was distributed.

This upgrade procedure is divided into four sections.

• Section I. Supported Software Configurations contains the software versions to use with McIDAS-X 2005.
• Section II. Before Installing McIDAS-X describes the Required and Optional Actions to perform before installing McIDAS-X 2005.
• Section III. Installing McIDAS-X explains how to install McIDAS-X 2005.
• Section IV. McIDAS-X Significant Changes describes the Required and Optional Actions to perform after installing McIDAS-X 2005.

Section I. Supported Software Configurations

McIDAS-X 2005 is supported on systems running Apple Mac OS X, Compaq OSF1, HP-UX, FreeBSD, IBM AIX, Microsoft Windows XP with Services for Unix, RedHat Linux, SGI IRIX or Sun Solaris. The software configurations compatible with McIDAS-X 2005 are listed in Chapter 1 of the Unidata McIDAS User’s Guide

Section II. Before Installing McIDAS-X

Complete all Required Actions below.

Core Software Changes

Review the changes to core software before installing McIDAS-X 2005. Section IV lists some of the significant changes since the last upgrade. Two ASCII text files, MAY05PRG.TXT and MAY05INQ.TXT, list all software changes made to McIDAS-X since the previous upgrade. A third file, MAY05OPN.TXT, lists all software bugs known at the time this upgrade was distributed. All these three files are provided with the distribution.

Required Action:

See Section IV of this document to review the significant changes made to core software. You can also place the three text files in the ~mcidas directory before installing the upgrade. To do so, complete the instructions in Obtaining McIDAS-X 2005 in Chapter 1 of the Unidata McIDAS User’s Guide.

Operating System and Compiler Changes

Beginning with this upgrade, the following changes were made to operating system and compiler versions that McIDAS-X is supported on.

• Fedora Core 3 on 64 bit systems was added as a newly supported operating system. Please note that Fedora Core 3 is the free distribution of RedHat Enterprise 4 WS. Preliminary testing on Fedora Core 4 32-bit has been successful, so we anticipate extending full support in early fall 2005.
• The SGI IRIX version that McIDAS-X is supported on remains at 6.5.21. However, the vendor compilers’ (SGI Fortran 77 and ANSI C) version changed from 7.41 to 7.4.2m, and the g77/gcc compilers’ version changed from 3.3 to 3.3.2.

Required Action:

See the table in Section I, Supported Software Configurations, for the complete list of operating system and compiler versions that McIDAS-X 2005 is supported on. We recommend that you update the operating systems and/or compiler versions on your McIDAS-X workstation(s) to those listed in the table.

Compatibility with -X Remote Servers and -XCD

McIDAS-X 2005 can run in a stand-alone mode. However, many commands can access data on other workstations (remote servers). Therefore, your McIDAS-X client workstations and the remote servers they access must be running compatible versions in order for all features to work as expected.

For example, the items below are dependent upon the McIDAS-X version that the client and/or server is running.

• Remote server workstations must have port 112 open to allow clients running McIDAS-X 2005 or 2004 to access their data. Likewise, ports 500 and 503 must also be open to allow clients running McIDAS-X 2003 to access their data. See ADDE Data Transfer Methods in Section IV of this document for details.
• This 2005 upgrade includes Meteosat Second Generation (MSG) client and server updates to allow copying (with the IMGCOPY command) of selected MSG bands (not just one band or all bands). This feature works only if both the server and client are running version 2004a or later (because the feature was first added in version 2004a). The client changes are backward-compatible, so you can install 2005 on a client and successfully use IMGCOPY to copy MSG imagery from a remote server running 2004 (though you won't be able to copy selected bands because the server is on an older version that doesn't support that option). However, the server changes are NOT backward-compatible. For example, if you install version 2005 on a remote server serving real-time MSG imagery (segmented Level 1.5 files transmitted by EUMETSAT), clients running version 2004 or earlier will no longer be able to use IMGCOPY to copy MSG data from your server. So it's important that remote server administrators do not install version 2004a or later on their real-time MSG servers until all of the clients that access their MSG data are running McIDAS-X 2004a or later.
• This upgrade contains modifications to the MOSRPT command to work with new MOS dataset names that are created in McIDAS-XCD 2005. The new ‑XCD datasets, RTWXTEXT/NAMMOS and RTWXTEXT/NGMMOS, have been added to maintain consistency with National Weather Service model names. This means that the MOSRPT command in this 2005 ‑X upgrade will work as documented only if the ‑XCD server it accesses is running   ‑XCD version 2005. In order to accommodate data access from older –XCD servers, the MOSRPT command contains undocumented options TYPE=FOUS and TYPE=ETA that default to the dataset names used in ‑XCD 2004 and earlier (RTWXTEXT/ETAMOS and RTWXTEXT/FOUS14).

Required Action:

Coordinate upgrading your site’s McIDAS-X and -XCD systems according to your needs, considering the compatibility requirements listed above.

Disk Space

McIDAS-X disk space requirements increased, mainly due to the addition of new servers.

The overall disk space requirements for obtaining, building and installing McIDAS-X 2005 are listed in the table below. The compiler type (vendor or gcc/g77) used for each build are also listed.

Required Action:

Verify that you have sufficient disk space available to obtain, build, and install McIDAS-X 2005.

Section III. Installing McIDAS-X

If you need assistance with the upgrade please contact Unidata User Support <support@unidata.ucar.edu>.

Required Action:

Obtain and install McIDAS-X 2005 using the instructions in Chapter 1, Installing and Configuring McIDAS-X, in the Unidata McIDAS User’s Guide.

Section IV. McIDAS-X Significant Changes

Complete all Required Actions below. Optional Actions are only for your consideration.

ADDE Data Transfer Methods

This 2005 upgrade contains the final set of changes for McIDAS ADDE data transfer methods. The changes were required because the ports that were initially used (500 and 503) are now registered for uses other than McIDAS. In order to maintain a permanent port for ADDE data transfers, port 112 was registered for McIDAS use and phased into McIDAS-X over the 2003, 2004 and 2005 upgrades. The transition from ports 500 and 503 to port 112 was spread over three upgrades to allow ADDE remote servers to maintain compatibility with client workstations running older upgrade versions as well as those running the current upgrade version.

On the client side:
In McIDAS-X 2003, clients sent their requests for gzip-compressed data to server port 112, compressed data to server port 503, and uncompressed data to server port 500. In McIDAS-X 2004 and later (including this 2005 upgrade), clients send all remote data requests, regardless of the transfer method, to server port 112.

On the server side:
The 2003 and 2004 versions of the ADDE remote server (installed using the mcinet2003.sh and mcinet2004.sh scripts) opened ports 112, 500 and 503 so that requests from clients running version 2003 or older were accepted. Beginning with this 2005 upgrade, the ADDE remote server (mcinet2005.sh) opens only port 112 (ports 500 and 503 are no longer opened). Therefore, 2005 ADDE remote servers will respond only to data requests from clients running version 2005 or 2004 (and also 2003 if the client’s MCCOMPRESS environment variable is set to "gzip"). Thus, commands sent to server port 500 or 503 from clients running older versions will fail on the client (eventually timeout because of no response).

Required Action:

Client workstation users:
If your client workstation accesses data on remote servers you must upgrade it to at least McIDAS-X version 2004 (preferably 2005) if any of the remote servers it accesses are running version 2005.

Remote server workstation administrators:
Before installing the McIDAS-X 2005 ADDE remote server (using the mcinet2005.sh script), you should give your users sufficient notice that they need to upgrade their client workstations to version 2004 or 2005 (or 2003 if their MCCOMPRESS environment variable is set to "gzip") in order to access the data on your server.

SSEC McIDAS-X GUI

The SSEC McIDAS-X GUI was modified to include the changes listed below.

• The Time Scheduler GUI was modified to allow specification of an ID number, like that in the SKE, SKL and SKU commands.
• The Image Display GUI was updated to make changing frames easier by replacing the GUI's simple label with a spinbox.
• The Weather Watch GUI was modified to reset the time to the current time each time the GUI is started.
• The Shortcut Button GUI was modified to include options to create a drop-down menu button, specify how many buttons to display, specify popup text to display when the cursor is moved over the button, and to whether to upcase the command text.

Optional Action:

Use the GUI by starting it with the GUI command, selecting the Start GUI upon McIDAS startup option in the mcidasx -config GUI’s Miscellaneous tab, or automatically start the GUI with each McIDAS-X session by adding a -c GUI command in the Run commands at startup section of your .mcidasrc file.

SSEC Configuration GUI

The SSEC McIDAS-X startup script was modified to start the McIDAS-X Configuration GUI if the user does not have a preexisting .mcidasrc file (e.g., when McIDAS-X is started for the first time in a new account). It also, by default, adds the new -config flag to the .mcidasrc file so the Configuration GUI appears each time McIDAS-X is started in future sessions. A checkbox on the Configuration GUI's front tab gives the choice of declining that option (in which case the -config flag is commented out). As with previous versions, the Configuration GUI can also be started by running the command mcidasx -config at the Unix prompt.

Optional Action:

Read the sections Configuring McIDAS-X Sessions with .mcidasrc in Chapter 1 and Starting McIDAS-X in Chapter 2 of the Unidata McIDAS User's Guide for more information about the -config flag and the Configuration GUI.

GEO and LEO Commands

The “NIR” option in the channel parameter of the GEO and LEO commands was changed to “SW” to more accurately reflect the description for the ~3.9µm shortwave infrared channel. The names of the other channel options are the same as before, but their descriptions were updated.

Required Action:

Check all occurrences of GEO and LEO commands in your macros, scripts, BATCH files, F Key Menus, McBASI programs and SKE entries to see if they specify the NIR option. If any do, change "NIR" to "SW" so they continue to work with McIDAS-X 2005.

IMGOPER Command

In the IMGOPER command, the ZERO=DATA/MISS keyword was removed and replaced with the new MISS=m1..mn keyword that lets you specify missing data values for each source image, e.g., MISS=0 -1 0 or MISS=NONE. Use of the ZERO=DATA/MISS keyword is still allowed for backward compatibility, but it is no longer documented and supported so you should switch to the new keyword as described in the Required Action section below.

Required Action:

Replace all uses of the ZERO keyword with the corresponding MISS keyword in your IMGOPER commands. In addition to changing your interactive command line entries, check all occurrences of IMGOPER commands in your macros, scripts, BATCH files, F Key Menus, McBASI programs and SKE entries to see if they contain ZERO=DATA or ZERO=MISS. If any do, change ZERO=DATA to MISS=NONE, and change ZERO=MISS to MISS=0.

IMGCHA Command

The IMGCHA and IMGCOPY commands were modified to zero out the original source type (word 56) if it's equal to PRD and STYPE=VISR is specified. This change fixes a problem in displaying product images created with the IMGFILT or IMGOPER commands. A new keyword, OTYPE, was added to IMGCHA to update the original source type. The keyword is unlikely to be needed except for certain cases of sophisticated multi-step image processing.

Required Action:

If temperature information is needed but was unexpectedly lost during multi-step image processing, use the IMGCHA command with the OTYPE keyword to reset the original source type back to its original value.

MSG Server

In previous versions of McIDAS-X, every call to the Meteosat Second Generation (MSG) server resulted in a trce file being written on the server. This problem has been corrected to write the file only if requested.

Required Action:

If your site serves MSG data in the raw format, check your server workstation for trce files and remove them.

Other Modifications

The modifications below require no special action.

Data Files

The following changes were made to files in the ~mcidas/data directory.

Required Action:

Merge these modifications with all local copies of the data files.

Local Code

Compile and link all local code after installing the upgrade. Listed below are some of the software and structural changes most likely to affect your local code.

• Servers and command dsserve.pgm were modified to use the fully qualified path of RESOLV.SRV for locking.
• File locking was added to command redirect.pgm to prevent multiple users writing to LWPATH.NAM simultaneously.
• Commands wwdisp.c and wwlist.c and associated routines wwmisc.c, m0wwmisc.h, and dcodesub.for were updated to read operational VTEC information and for a change in the WMO header for severe thunderstorm and tornado watch bulletins.
• As requested by users at the 2004 MUG Meeting, NASA-Langley’s 2-byte product calibration module, kbxprd2.dlm, was added to McIDAS-X 2005 and their cloud product commands, barcp.pgm and imgdispcp.mac, were added to McIDAS-XRD 2005.
• The Australian Bureau of Meteorology supplied SSEC with 1-byte FY-2C data. A new calibration module, kbxfy2.dlm, was written to view this data. Updates to the calibration module will be included in a future McIDAS-X addendum.
• The modules listed below were updated to support McIDAS-X on 64 bit Linux workstations.
  

  wwdisp.c	wwlist.c	wwmisc.c
  daytime.c	mccomp.sh	ncdfks.c
  zlm.pgm	mcidas.h	sfcmg.c
  mcts.c	mcts.h

• The modules listed below were modified to fix byte flipping issues with MODIS data.
  

  modsaget.cp	kbxmods.dlm	mcaput.for
  mcaget.for	aputserv.fp

• Modules IconBar.tcl, GUIMain.gui, Context.tcl, and popuphelp.tcl were updated to enhance capabilities of user-defined buttons in the McIDAS-X GUI.
• The data structure for SATBAND was updated to allow for wavelength, wave number and frequency information. A new applications program interface (API), m0getsatbandinfo.for, was written to access SATBAND. Commands frmlabel.pgm, imglist.pgm, za.pgm and routine mcexptxt.for were updated to access this new information.
• Upper-air commands were updated to set the LFC equal to the LCL when the initial calculation has the LFC below the LCL. The modules listed below were updated for this change.
  

  altim.c	ualist.c	uaplot.c
  hodo.c	mcsndanl.c	sndskewt.pgm
  sndaltim.pgm	sndplot.pgm	sndlist.pgm
  sndhodo.pgm

• Stability parameters from mcsndanl.c can now be listed by adding DEV=CCC to UA* and SND* command entries. The modules listed below were updated for this change.
  

  altim.c	ualist.c	uaplot.c
  hodo.c	mcsndanl.c	sndskewt.pgm
  sndaltim.pgm	sndplot.pgm	sndlist.pgm
  sndhodo.pgm

• The default value of today for DAY= was removed from the real-time GVAR server gvaraget.c. This change was made to match other real-time image servers.
• Ports 500 and 503 were removed from mcinet.sh.
• The documentation for function Mccydtostr was updated in cydstr.c.
• File masking for GRID files was added to McIDAS-X. The following modules were updated for this enhancement.
  

  isgfmt.for	igget.for	mcfndgrd.for
  mcglast_.c	gputserv.fp	gdirserv.fp
  ggetserv.fp	grdcopy.pgm	mcgput.for
  igopen.for	iggmax.for	igmakx.for
  igopen.for	igquit.for	readsort.for
  igget.for	igput.for	gridparm.inc
  igfilename.for

• In preparation for the new GRIB server, the modules listed below were either updated or moved from McIDAS-XCD to McIDAS-X.
  

  database.c	gribgget.cp	gbtbpds001.0v1
  mcgrib.h	mcncdf.h	gbtbpds001.4v1
  gribfunc.c	gribgdir.cp	gbtbpds001.2v1
  ncdffunc.c	ncdfgdir.cp	gbtbpds001.2v2
  ncdfgget.cp	xcdgrib.c	gbtbpds001.2v3
  gbtbpds001.a34v1	gbtbpds001.a60v1	gbtbpds001.a74v1
  gbtbpds001.a98v1	gbtbpds001.av1	gbtbpds001.b98v1
  gbtbpds001.bv1	gbtbpds001.2v128

McIDAS-XCD v2005

The McIDAS-XCD upgrade procedure is divided into four sections.

• Section I. Before Installing McIDAS-XCD describes the actions to be performed before installing McIDAS-XCD 2005.
• Section II. Installing McIDAS-XCD describes the installation procedure for McIDAS-XCD 2005.
• Section III. McIDAS-XCD Post-Upgrade Procedures describes the actions to be performed immediately after upgrading to McIDAS-XCD 2005 from a previous version.
• Section IV. McIDAS-XCD Changes lists the McIDAS-XCD software changes that have been made since the last upgrade.

Section I. Before Installing McIDAS-XCD

Complete all Required Actions below.

Compatibility with McIDAS-X

Required Action:

Section II. Installing McIDAS-XCD

If you need assistance with the installation, please contact Unidata User Support <support@unidata.ucar.edu>.

Required Action:

Obtain and install McIDAS-XCD 2005 using the instructions in the XCD Installtion portion of the Unidata McIDAS-X Users Guide.

Section III. McIDAS-XCD Post-Upgrade Procedures

This section lists the actions to be performed immediately after upgrading to McIDAS-XCD 2005 from a previous version. If you are installing McIDAS-XCD for the first time on a workstation then everything in this section will have been done during the installation procedure.

ETA to NAM Grid Changes

The National Weather Service has changed the name for their ETA model to NAM (North American Mesoscale). In order to remain consistent with NWS nomenclature the XCD grid decoder will now place NAM rather than ETA into the SRC field of the McIDAS grid headers. Note: You should warn any of your users who may be using GRD* commands with SRC=ETA in any scripts, batch files, mcbasi jobs, etc. to either change ETA to NAM or to add NAM, e.g. SRC=ETA NAM .

Required Actions:

1. Log on to the workstation as user mcidas
2. Open the file, RTMODELS.CFG for editing
3. Change all lines that begin with ETA= to begin with NAM=
4. Save and close the file
   

Optional Actions:

If you wish to change the dataset names to use NAM rather than ETA complete the following steps. This assumes that you are using the default RTGRIDS dataset configuration. Local configurations may vary.

1. Log on to the McIDAS-XCD workstation as user mcidas
2. Open the file RESOLV.SRV for editing
3. Copy and paste the lines for the RTGRIDS/ETA-* datasets
4. In the new lines, change all instances of N2=ETA-* to N2=NAM-*
5. In the new lines, change all instances of C=ETA... to C=NAM...
6. Save and close the file

Note: This procedure does not delete the RTGRIDS/ETA-* datasets, it merely creates a set of datasets called RTGRIDS/NAM-* that point to the same data. Once all of your users have switched to the NAM datasets you can remove the ETA datasets.

Additional NAM Grid Datasets

The NWS recently added NAM gridded data that covers the Alaskan region in AWIPS projections to it's NOAAPORT datastream. Complete the following steps to add datasets to the RTGRIDS ADDE group to accommodate these data. If you choose not to complete this procedure then the new NAM grids will be filed in the RTGRIDS/OVERFLOW dataset.

Optional Actions:

1. Log on to the workstation as user mcidas
2. Open the file ~mcidas/data/RTMODELS.CFG for editing
3. Add the following lines to the file

   # NAM-AKPSAWIP
   NAM= 0 53501 60000 GEO=216
   
   # NAM-AKPSAWI2
   NAM= 0 53601 60000 GEO=217
   
   # NAM-AKPSAWI4
   NAM= 0 53701 60000 GEO=242

4. Log on to the McIDAS-XCD workstation as user mcidas
5. Open the file ~mcadde/mcidas/data/RESOLV.SRV for editing
6. Add the following lines to the file;

   N1=RTGRIDS,N2=NAM-AKPSAWIP,TYPE=GRID,RT=Y,K=GRID,R1=53501,R2=53540,C=NAM - Alaska/PS (projection used by AWIPS),
   
   N1=RTGRIDS,N2=NAM-AKPSAWI2,TYPE=GRID,RT=Y,K=GRID,R1=53601,R2=53640,C=NAM - Alaska/PS (projection used by AWIPS - dbl res),
   
   N1=RTGRIDS,N2=NAM-AKPSAWI4,TYPE=GRID,RT=Y,K=GRID,R1=53701,R2=53740,C=NAM - Alaska/PS (projection used by AWIPS - quad res),

7. Save and close the file

New GRIB/BUFR Filer Configuration File

The GRIB/BUFR filer has been modified to allow the user to choose to file GRIB and BUFR data, GRIB data only, or BUFR data only. The GRIB file naming options have also been expanded to include the three letter model name abbreviation at the beginning of the file name. These options are available via the configuration file, GRBFILER.CFG.

Required Actions:

1. Log on to the workstation as user mcidas
2. Create a backup copy of your GRIB filer configuration file ~mcidas/workdata/GRBFILER.CFG
3. Copy ~mcidas/mcidas2005/data/GRBFILER.CFG to the ~mcidas/workdata directory
4. View GRBFILER.CFG and make any appropriate changes to reflect your McIDAS-XCD configuration

Name Changes for FOUS14 and ETA MOS

In order to remain consistent with NWS nomenclature the name ETA MOS has been changed to NAM MOS and the name FOUS14 has been changed to NGM MOS. In the following procedure new dataset names (RTPTSRC/NAMMOS, RTPTSRC/NGMMOS, RTWXTEXT/NAMMOS, and RTWXTEXT/NGMMOS) are created however the existing dataset names are not removed. The McIDAS-XCD administrator may remove the old dataset names when he/she is certain that all users have switched to the new names. Note: The decoder software has been changed which makes the following procedure mandatory. Complete the following steps to add the new dataset names for these data.

Required Actions:

1. If McIDAS-XCD is running, turn it off
2. If the LDM is running, turn it off
3. Modify the remote datasets
   1. Log on to the workstation as user mcidas
   2. Open the file ~mcidas/workdata/RESOLV.SRV for editing
   3. Add new datasets for point data
      1. Copy the line that begins with N1=RTPTSRC,N2=ETAMOS and paste the new line directly beneath the original
      2. Change the copied line so that the value for the N2 variable is NAMMOS
      3. Copy the line that begins with N1=RTPTSRC,N2=FOUS14 and paste the new line directly beneath the original
      4. Change the copied line so that the value for the N2 variable is NGMMOS
   4. Add new datasets for text data
      1. Copy the line that begins with N1=RTWXTEXT,N2=ETAMOS and paste the new line directly beneath the original
      2. Change the copied line so that the value for the N2 variable is NAMMOS
      3. Change the copied line AND the original line so that the *.RAP file for the Q= variable is NAMMOS.RAP
      4. Copy the line that begins with N1=RTWXTEXT,N2=FOUS14 and paste the new line directly beneath the original
      5. Change the copied line so that the value for the N2 variable is NGMMOS
      6. Change the copied line AND the original line so that the *.RAP file for the Q= variable is NGMMOS.RAP
   5. Save and close the file
4. Add redirections for the NAM and NGM rapid access files in the mcadde account
   1. Log on to the McIDAS-XCD workstation as user mcidas
   2. Open the file ~mcidas/workdata/LWPATH.NAM for editing
   3. Modify the redirect entries
      1. Find the line that begins with ETAMOS.RAP and change it so that it begins with NAMMOS.RAP
      2. Find the line that begins with ETAMOS.RAT and change it so that it begins with NAMMOS.RAT
      3. Find the line that begins with FOUS14.RAP and change it so that it begins with NGMMOS.RAP
      4. Find the line that begins with FOUS14.RAT and change it so that it begins with NGMMOS.RAT
   4. Save and close the file
5. Add redirections for the NAM and NGM rapid access files in the oper account (this step is the same as step #4 except for the account in which it is executed)
   1. Log on to the McIDAS-XCD workstation as user mcidas
   2. Open the file ~mcidas/workdata/LWPATH.NAM for editing
   3. Modify the redirect entries
      1. Find the line that begins with ETAMOS.RAP and change it so that it begins with NAMMOS.RAP
      2. Find the line that begins with ETAMOS.RAT and change it so that it begins with NAMMOS.RAT
      3. Find the line that begins with FOUS14.RAP and change it so that it begins with NGMMOS.RAP
      4. Find the line that begins with FOUS14.RAT and change it so that it begins with NGMMOS.RAT
   4. Save and close the file
6. In this step we will be removing and recreating the data file used by the DECINFO command. This must be done because the DECINFO command and startxcd have been changed to use the new decoder names.
   1. Use DECINFO LIST to display the current status of your data monitors and decoders, you may need this information later
   2. Remove the file ~mcidas/workdata/DECINFO.DAT
   3. Rerun DECINFO LIST to recreate DECINFO.DAT
   4. The status of all data monitors and decoders are now set to their defaults, use the DECINFO command to make any necessary changes
7. Build the rapid access pointer files for NAM and NGM MOS data and remove the old rapid access pointer and text files
   1. For the following step you will need to be logged on to your McIDAS-XCD workstation as user mcidas and have a McIDAS session running
   2. Run the following commands to create the new rapid access pointer files (you can avoid the tedious typing by running SEE XCDDEC.BAT and then just copy and paste the commands into the command line)

      BILDTEXT INIT NAMMOS.RAP NAMMOS.RAT 2000 4 C4 4 12 80 NAMMOS X 48
      BILDTEXT INIT NGMMOS.RAP NGMMOS.RAT 600 4 C4 4 12 80 NGMMOS X 48

   3. Remove ETAMOS.RAT, ETAMOS.RAP, FOUS14.RAT, and FOUS14.RAP (it may be helpful to use the DMAP command to locate these files)
8. Register the new schemas
   1. For the following step you will need to be logged on to your McIDAS-XCD workstation as user oper and have a McIDAS session running
   2. Run the following commands (these commands can also be found in XCDDEC.BAT)

      SCHE DCNGMMOS
      SCHE DCNAMMOS

9. Remove the file ~mcidas/workdata/DECOSTAT.DAT. This isn't a vital step, it simply eliminates a line in the statdisp display that is no longer used.
10. Copy the configuration files, NAMMOS.CFG and NGMMOS.CFG from ~mcidas/mcidas2005/data to ~mcidas/workdata. You may also remove the old configuration files, FO14DEC.CFG and ETAMOS.CFG, they will no longer be used.

Changes to the GFS MOS Decoder

Several bug fixes have been made to the GFS MOS decoder and the configuration file and the schema have also been changed. Complete the following steps;

1. Register the new GFS MOS schema, from a McIDAS text window type;

   SCHE DCGFSMOS

2. Replace the GFS MOS configuration file, GFSMOS.CFG, with the new version (you may want to create a backup of your existing configuration file first), from a shell window type;

   cp ~mcidas/mcidas2005/data/GFSMOS.CFG ~mcidas/workdata

Creating a Separate Spool File for the NEXRAD Decoder

SSEC has found that there is a significant performance improvement if the NEXRAD decoder has its own spool file. Unidata users do not use XCD processing of NEXRAD data since this is more easliy handled by the LDM.

Section IV. McIDAS-XCD Changes

This section lists the changes made to McIDAS-XCD source, data, script, and batch files since the last upgrade (version 2004).

Source Modules Changes

The table below lists changes to McIDAS-XCD source modules since the previous upgrade (version 2004).

File	Description of Modifications
btab.c	Moved to McIDAS-X (xcdgrib.c)
decinfo.pgm	Changed ETA to NAM and FOUS14 to NGM
dmbin.pgm	Expanded GRIB file naming options and added option to decode and file GRIB and/or BUFR data.
dmgrid.pgm	Increased the maximum number of grids per grid file to 10,000.
dmmisc.pgm	Changed ETA to NAM and FOUS14 to NGM.
dmnexr.pgm	Fixed bug that prevented periodic restarts. Fixed bug that could cause the pointer file name to be set incorrectly.
grib.h	Moved to McIDAS-X (mcgrib.h)
m0dcdsfc.for	Fixed bug
m0etamos.for	Replaced by m0nammos.for
m0f14dec.for	Replaced by m0ngmmos.for
m0gfsmos.for	Fixed various bugs that were causing 6Z and 18Z runs to be filed in the 12Z MD file slots. Corrected code to properly handle the decreased temporal resolution in the last two forcast times.
m0nammos.for	New module, replaces m0etamos.for
m0ngmmos.for	New module, replaces m0f14dec.for
m0saodec.for	Improved code to correctly deal with multiple observations from a given station and time.
m0tirdec.for	Added support for NOAA-18
Mcgetmemory.c	Moved to McIDAS-X (xcdgrib.c)
Mcgrbbfrdec.c	Added MySQL code for future use in GRIB database. Added code to allow the option of decoding only GRIB or BUFR data but not both.
Mcgribdecoder.c	Moved to McIDAS-X (xcdgrib.c)
Mcmkmcgrid.c	Moved to McIDAS-X (xcdgrib.c)

Data File Changes

The table below lists changes to McIDAS-XCD data files since the previous upgrade (version 2004).

File	Description of Modifications
GFSMOS.CFG	Increased the number of rows from 42 to 84 and fixed a typo in a comment line
GRBFILER.CFG	Added a fourth option that prepends the GRIB file names with the 3 letter abbreviated model name. Added DECODETYPE keyword to allow more GRIB and/OR BUFR data to be filed.
NAMMOS.CFG	Replaces ETAMOS.CFG.
NGMMOS.CFG	Replaces FO14DEC.CFG.
NEXRFILE.CFG	Increased the default reset frequency to one hour.
NEXRID.CFG	Changed the default products to be filed to ALL.
RTGRIDS.TXT	Changed ETA to NAM.
RTMODELS.CFG	Changed ETA to NAM. Added datasets for NAM Alaska polar stereo grids in AWIPS projections.
WXCORE.PRD	Changed SEVERE_WX_WATCH_OUTLINE from APRO=SLS to WMO=WOUS64. Added NAM* product names that correspond to the existing ETA* product names (none were removed).
XCDDEC.VER	Updated version and date.
decodertypes.core	Added NAMMOS and NGMMOS.
gbtbpds001.0v1	All GRIB table files have been moved from McIDAS-XCD to McIDAS-X in preparation for the GRIB server. These files will now reside in ~mcidas/data and will be accessible to the McIDAS-XCD grid decoder as long as MCPATH contains ~mcidas/data. The file, gbtbpds001.av1, has also been modified to reflect the ETA to NAM name change.
gbtbpds001.2v1
gbtbpds001.2v2
gbtbpds001.2v3
gbtbpds001.4v1
gbtbpds001.a34v1
gbtbpds001.a60v1
gbtbpds001.a74v1
gbtbpds001.a98v1
gbtbpds001.av1
gbtbpds001.bv1

Script and Batch File Changes

The table below lists changes to McIDAS-XCD scripts and batch files since the previous upgrade (version 2004).

File	Description of Modifications
XCD.BAT	Changed ETA to NAM and FOUS14 to NGM. Added redirect for HRS.SPL. Added redirects for *.PRO and *.PTR.
XCDDEC.BAT	Doubled the number of observations as well as the number of reports per observation to be stored in the rapid access text files for MOS data. Changed SCHE calls to use DCNAMMOS and DCNGMMOS rather than DCETAMOS and DCFOUS14. Changed BILDTEXT calls to use NAMMOS and NGMMOS rather than ETAMOS and FOUS14.
xcd_init	Updated version number.
xcdadmin	New file, admin script to allow McIDAS-XCD to be run in the background.

Contact Us   •   Site Map   •   Search   •   Terms and Conditions   •   Privacy Policy   •   Participation Policy

Unidata is a member of the UCAR Community Programs, is managed by the University Corporation for Atmospheric Research, and is sponsored by the National Science Foundation. P.O. Box 3000   •   Boulder, CO 80307-3000 USA   •   Tel: 303-497-8643   •   Fax: 303-497-8690