var/external/bufr/newwin.f

   1       SUBROUTINE NEWWIN(LUN,IWIN,JWIN)
   2
   3 C$$$  SUBPROGRAM DOCUMENTATION BLOCK
   4 C
   5 C SUBPROGRAM:    NEWWIN
   6 C   PRGMMR: WOOLLEN          ORG: NP20       DATE: 1994-01-06
   7 C
   8 C ABSTRACT: GIVEN AN INDEX WITHIN THE INTERNAL JUMP/LINK TABLE WHICH
   9 C   POINTS TO THE START OF AN "RPC" WINDOW (I.E. ITERATION OF AN 8-BIT
  10 C   OR 16-BIT DELAYED REPLICATION SEQUENCE), THIS SUBROUTINE COMPUTES
  11 C   THE ENDING INDEX OF THE WINDOW.  ALTERNATIVELY, IF THE GIVEN INDEX
  12 C   POINTS TO THE START OF A "SUB" WINDOW (I.E. THE FIRST NODE OF A
  13 C   SUBSET), THE SUBROUTINE RETURNS THE INDEX OF THE LAST NODE.
  14 C
  15 C PROGRAM HISTORY LOG:
  16 C 1994-01-06  J. WOOLLEN -- ORIGINAL AUTHOR
  17 C 1998-07-08  J. WOOLLEN -- REPLACED CALL TO CRAY LIBRARY ROUTINE
  18 C                           "ABORT" WITH CALL TO NEW INTERNAL BUFRLIB
  19 C                           ROUTINE "BORT"
  20 C 1999-11-18  J. WOOLLEN -- THE NUMBER OF BUFR FILES WHICH CAN BE
  21 C                           OPENED AT ONE TIME INCREASED FROM 10 TO 32
  22 C                           (NECESSARY IN ORDER TO PROCESS MULTIPLE
  23 C                           BUFR FILES UNDER THE MPI)
  24 C 2002-05-14  J. WOOLLEN -- REMOVED OLD CRAY COMPILER DIRECTIVES
  25 C 2003-11-04  S. BENDER  -- ADDED REMARKS/BUFRLIB ROUTINE
  26 C                           INTERDEPENDENCIES
  27 C 2003-11-04  D. KEYSER  -- MAXJL (MAXIMUM NUMBER OF JUMP/LINK ENTRIES)
  28 C                           INCREASED FROM 15000 TO 16000 (WAS IN
  29 C                           VERIFICATION VERSION); UNIFIED/PORTABLE FOR
  30 C                           WRF; ADDED DOCUMENTATION (INCLUDING
  31 C                           HISTORY); OUTPUTS MORE COMPLETE DIAGNOSTIC
  32 C                           INFO WHEN ROUTINE TERMINATES ABNORMALLY
  33 C 2009-03-31  J. WOOLLEN -- ADDED DOCUMENTATION
  34 C 2009-05-07  J. ATOR    -- USE LSTJPB INSTEAD OF LSTRPC
  35 C
  36 C USAGE:    CALL NEWWIN (LUN, IWIN, JWIN)
  37 C   INPUT ARGUMENT LIST:
  38 C     LUN      - INTEGER: I/O STREAM INDEX INTO INTERNAL MEMORY ARRAYS
  39 C     IWIN     - INTEGER: STARTING INDEX OF WINDOW ITERATION
  40 C
  41 C   OUTPUT ARGUMENT LIST:
  42 C     JWIN     - INTEGER: ENDING INDEX OF WINDOW ITERATION
  43 C
  44 C REMARKS:
  45 C
  46 C    SEE THE DOCBLOCK IN BUFR ARCHIVE LIBRARY SUBROUTINE GETWIN FOR AN
  47 C    EXPLANATION OF "WINDOWS" WITHIN THE CONTEXT OF A BUFR DATA SUBSET.
  48 C
  49 C    THIS ROUTINE CALLS:        BORT     LSTJPB
  50 C    THIS ROUTINE IS CALLED BY: DRSTPL   UFBRW
  51 C                               Normally not called by any application
  52 C                               programs.
  53 C
  54 C ATTRIBUTES:
  55 C   LANGUAGE: FORTRAN 77
  56 C   MACHINE:  PORTABLE TO ALL PLATFORMS
  57 C
  58 C$$$
  59
  60       INCLUDE 'bufrlib.prm'
  61
  62       COMMON /USRINT/ NVAL(NFILES),INV(MAXSS,NFILES),VAL(MAXSS,NFILES)
  63
  64       CHARACTER*128 BORT_STR
  65       REAL*8        VAL
  66
  67 C----------------------------------------------------------------------
  68 C----------------------------------------------------------------------
  69
  70       IF(IWIN.EQ.1) THEN
  71
  72 C        This is a "SUB" (subset) node, so return JWIN as pointing to
  73 C        the last value of the entire subset.
  74
  75          JWIN = NVAL(LUN)
  76          GOTO 100
  77       ENDIF
  78
  79 C     Confirm that IWIN points to an RPC node and then compute JWIN.
  80
  81       NODE = INV(IWIN,LUN)
  82       IF(LSTJPB(NODE,LUN,'RPC').NE.NODE) GOTO 900
  83       JWIN = IWIN+VAL(IWIN,LUN)
  84
  85 C  EXITS
  86 C  -----
  87
  88 100   RETURN
  89 900   WRITE(BORT_STR,'("BUFRLIB: NEWWIN - LSTJPB FOR NODE",I6,'//
  90      . '" (LSTJPB=",I5,") DOES NOT EQUAL VALUE OF NODE, NOT RPC '//
  91      . '(IWIN =",I8,")")') NODE,LSTJPB(NODE,LUN,'RPC'),IWIN
  92       CALL BORT(BORT_STR)
  93       END