SUBROUTINE TRYBUMP(LUNIT,LUN,USR,I1,I2,IO,IRET) C$$$ SUBPROGRAM DOCUMENTATION BLOCK C C SUBPROGRAM: TRYBUMP C PRGMMR: WOOLLEN ORG: NP20 DATE: 1994-01-06 C C ABSTRACT: THIS SUBROUTINE CHECKS THE FIRST NODE ASSOCIATED WITH A C CHARACTER STRING (PARSED INTO ARRAYS IN COMMON BLOCK /USRSTR/) IN C ORDER TO DETERMINE IF IT REPRESENTS A DELAYED REPLICATION SEQUENCE. C IF SO, THEN THE DELAYED REPLICATION SEQUENCE IS INITIALIZED AND C EXPANDED (I.E. "BUMPED") TO THE VALUE OF INPUT ARGUMENT I2. C A CALL IS THEN MADE TO SUBROUTINE UFBRW IN ORDER TO WRITE USER DATA C INTO THE NEWLY EXPANDED REPLICATION SEQUENCE. C C TRYBUMP IS USUALLY CALLED FROM UFBINT AFTER UFBINT RECEIVES A C NON-ZERO RETURN CODE FROM UFBRW. THE CAUSE OF A BAD RETURN FROM C UFBRW IS USUALLY A DELAYED REPLICATION SEQUENCE WHICH ISN'T C EXPANDED ENOUGH TO HOLD THE ARRAY OF DATA THE USER IS TRYING TO C WRITE. SO TRYBUMP IS ONE LAST CHANCE TO RESOLVE THAT SITUATION. C C PROGRAM HISTORY LOG: C 1994-01-06 J. WOOLLEN -- ORIGINAL AUTHOR C 1998-07-08 J. WOOLLEN -- IMPROVED MACHINE PORTABILITY C 1999-11-18 J. WOOLLEN -- THE NUMBER OF BUFR FILES WHICH CAN BE C OPENED AT ONE TIME INCREASED FROM 10 TO 32 C (NECESSARY IN ORDER TO PROCESS MULTIPLE C BUFR FILES UNDER THE MPI) C 2003-11-04 S. BENDER -- ADDED REMARKS/BUFRLIB ROUTINE C INTERDEPENDENCIES C 2003-11-04 D. KEYSER -- MAXJL (MAXIMUM NUMBER OF JUMP/LINK ENTRIES) C INCREASED FROM 15000 TO 16000 (WAS IN C VERIFICATION VERSION); UNIFIED/PORTABLE FOR C WRF; ADDED DOCUMENTATION (INCLUDING C HISTORY) (INCOMPLETE); OUTPUTS MORE C COMPLETE DIAGNOSTIC INFO WHEN ROUTINE C TERMINATES ABNORMALLY C 2009-03-31 J. WOOLLEN -- ADDED DOCUMENTATION C C USAGE: CALL TRYBUMP (LUNIT, LUN, USR, I1, I2, IO, IRET) C INPUT ARGUMENT LIST: C LUNIT - INTEGER: FORTRAN LOGICAL UNIT NUMBER FOR BUFR FILE C (SEE REMARKS) C LUN - INTEGER: I/O STREAM INDEX INTO INTERNAL MEMORY ARRAYS C (ASSOCIATED WITH FILE CONNECTED TO LOGICAL UNIT LUNIT) C USR - REAL*8: (I1,I2) STARTING ADDRESS OF DATA VALUES TO BE C WRITTEN TO DATA SUBSET C I1 - INTEGER: LENGTH OF FIRST DIMENSION OF USR C I2 - INTEGER: NUMBER OF "LEVELS" OF DATA VALUES TO BE C WRITTEN TO DATA SUBSET C IO - INTEGER: STATUS INDICATOR FOR BUFR FILE ASSOCIATED C WITH LUNIT (SEE REMARKS): C 0 = INPUT FILE (POSSIBLE FUTURE USE) C 1 = OUTPUT FILE C C OUTPUT ARGUMENT LIST: C IRET - INTEGER: RETURN CODE FROM CALL TO SUBROUTINE UFBRW C C REMARKS: C ARGUMENT LUNIT IS NOT REFERENCED IN THIS SUBROUTINE. IT WAS C INCLUDED ONLY FOR POTENTIAL FUTURE EXPANSION OF THE SUBROUTINE. C C ARGUMENT IO IS ALWAYS PASSED IN WITH A VALUE OF 1 AT THE PRESENT C TIME. IN THE FUTURE THE SUBROUTINE MAY BE EXPANDED TO ALLOW IT C TO OPERATE ON INPUT FILES. C C THIS ROUTINE CALLS: BORT INVWIN LSTJPB UFBRW C USRTPL C THIS ROUTINE IS CALLED BY: UFBINT UFBOVR C Normally not called by any application C programs. C C ATTRIBUTES: C LANGUAGE: FORTRAN 77 C MACHINE: PORTABLE TO ALL PLATFORMS C C$$$ INCLUDE 'bufrlib.prm' COMMON /USRINT/ NVAL(NFILES),INV(MAXSS,NFILES),VAL(MAXSS,NFILES) COMMON /USRSTR/ NNOD,NCON,NODS(20),NODC(10),IVLS(10),KONS(10) REAL*8 USR(I1,I2),VAL C----------------------------------------------------------------------- C----------------------------------------------------------------------- C SEE IF THERE IS A DELAYED REPLICATION GROUP INVOLVED C ---------------------------------------------------- NDRP = LSTJPB(NODS(1),LUN,'DRP') IF(NDRP.LE.0) GOTO 100 C IF SO, CLEAN IT OUT AND BUMP IT TO I2 C ------------------------------------- INVN = INVWIN(NDRP,LUN,1,NVAL(LUN)) VAL(INVN,LUN) = 0 JNVN = INVN+1 DO WHILE(NINT(VAL(JNVN,LUN)).GT.0) JNVN = JNVN+NINT(VAL(JNVN,LUN)) ENDDO DO KNVN=1,NVAL(LUN)-JNVN+1 INV(INVN+KNVN,LUN) = INV(JNVN+KNVN-1,LUN) VAL(INVN+KNVN,LUN) = VAL(JNVN+KNVN-1,LUN) ENDDO NVAL(LUN) = NVAL(LUN)-(JNVN-INVN-1) CALL USRTPL(LUN,INVN,I2) C FINALLY, CALL THE MNEMONIC WRITER C ---------------------------------------- CALL UFBRW(LUN,USR,I1,I2,IO,IRET) C EXIT C ---- 100 RETURN END