Top Banner
SeisUP Applications Manual
1871
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
  • SeisUP Applications Manual

  • Table of Contents............... 1SeisUP Applications Manual............... 2SeisUP Applications Manual...... 4Introduction to the SeisUP administrative and programming tools................ 7SeisUP Configuration Files............... 11Dataset Naming Convention................. 12DIRECTORY TREE........... 14SeisUP Files Stored in User Home Directories................. 16LICENSE_INSTALL............... 17SEISUP_LMGRD_INSTALL................... 18CHKDSET................... 19CHKLINKS................ 20CLEANUP_RUN_LOGS................... 21DSET_FILES.................... 22DSKINV................. 23DUMP_JOB_CACHE............... 24JM_MULTICAST_MONITOR.................. 25PROJECT_DATA................. 26SEISUPD_ADMIN.................. 27SEISUPD_CTL................. 28SEISUPD_INSTALL................. 29SEISUPD_LOG_MON............. 30SELECT_PLOTTING_SUBSYSTEM................. 31SET_HELP_VIEWER................... 32TAPEINIT................... 33TAPESERV................ 34CLUSTER_COMMAND.................. 35NODE_NAMES.................. 36CLUSTER_DIST............... 37CLUSTER_HOST_ENTRIES............... 38CLUSTER_NODE_ENTRIES................ 39CLUSTER_POWEROFF................. 40CLUSTER_REBOOT............... 41DIST_CLUSTER_PROGRAM................... 42RKILL.PL.................... 43RUTIL................... 44COMPACT............... 45CONFIG_SEISUP_SCRIPT.................. 46CONVFLOW6_7................... 47DB_DUMP..................... 48DBU.................. 49DUMP_FLOW.................... 50DUMP_ID................... 51GOODBAD

    i

  • ..................... 52LOCKUP

    ..................... 53REBUILD

    ................. 54SEGMENTATION FAULT

    .................... 55BUGREPORTS

    ................... 56PROGRAMMING

    .................. 57CAT_UPDATE Wrapper

    ..................... 58CATOUT

    .................... 59EXEC_DEBUG

    .................... 60LS_HORIZONS

    .................... 61LST_NODES

    ..................... 62MODGEN

    .................... 63PLOT_LOGOS

    .................... 64PVM_HOSTS

    .................... 65LST_NODES

    .................. 66SeisUP Data Manager

    ................. 73SeisUP Filesystems Manager

    .................... 75Options menu

    ................ 77SeisUP Tape Devices Manager

    ................ 80Introduction to the SeisUP system

    ................... 82Using the flow editor

    .................. 83Parts of the flow editor

    .................. 84Opening an existing flow

    ..................... 85Saving a flow

    .................... 86Deleting a line

    .................. 87Quitting the flow editor

    .................... 88Selecting icons

    ................... 89Inserting modules

    .................. 90Editing flows and icons

    ............... 92Copying parts of a line to another line

    .................... 93Grouping icons

    .................... 94Ungrouping icons

    ................... 95Connecting modules

    .................. 96Disconnecting modules

    ................ 97Query the connections of a node

    ................... 98Releasing data sets

    ................ 99Seismic data inventory program

    ..................... 101Using Motif

    ....................... 102Lists

    ..................... 103Scroll bars

    ..................... 104Push button

    ................ 105Check boxes and Radio buttons

    .................... 106Text Input Field

    .................. 107Using pull-down menus

    .................... 108File selection box

    ................... 109Managing Windows

    ii

  • .................... 112Creating a flow

    ..................... 113File menu

    .................. 114Creating an input data set

    ............... 115Using the execution type ahead buffer

    ................. 116Edit tape attributes for tape

    .................... 117Adding modules

    ................. 118Using the module librarian

    ................. 119Setting module parameters

    ................. 121Using the flow pop-up menu

    ................... 123Executing modules

    ..................... 125Module types

    ................. 126Selecting the Current Host

    .................... 127Execute menu

    ................... 128Flow editor menus

    ..................... 129Edit menu

    ..................... 130Find menu

    .................... 131Module menu

    ..................... 132Tools menu

    ...................... 135Glossary

    ................. 136Geosp Using the matrix editor

    ................ 138Geosp Parts of the matrix editor

    ................ 139Geosp Matrix Editor File Menu

    ................ 140Geosp Matrix Editor Edit Menu

    ................... 141Geosp Tools Menu

    ................. 142Geosp Moving the current cell

    ................... 143Geosp Selecting cells

    ................. 144Geosp Cut, Copy, and Paste

    ................. 145Geosp Moving Cell Values

    ........... 146Geosp Entering or updating values in a spreadsheet

    .................. 147Geosp Filling Cell Values

    ................ 148Geosp Interpolating Cell Values

    ................. 149Geosp Arithmetic Operations

    .................. 150Geosp Sorting cell values

    ................... 151Geosp Inserting Rows

    ................... 152Geosp Deleting Rows

    ................. 153Geosp Clearing Cell Values

    ................ 154Geosp Creating a new spreadsheet

    ................. 155Geosp Saving a spreadsheet

    ................. 156Geosp Deleting a spreadsheet

    .............. 157Geosp Navigating through spreadsheets

    ................... 158Geosp Go to Sheet

    ................. 159Geosp Importing matrix files

    ................. 161Geosp Exporting matrix files

    ............... 162Geosp Picking spreadsheets to export

    ................ 163Geosp Quitting the Matrix Editor

    iii

  • ................. 164Geosp Matrix Editor Menus

    ............. 165SeisUP - History Viewer - Help Documentation

    .............. 170SeisUP -Job Monitor- Help Documentation

    .............. 177SeisUP Job Server Administration Manual

    .................. 189SeisUP Licensing Manual

    ................. 212SeisUP Plotting Subsystem

    .................. 216SeisUP Reference Manual

    ............ 222SeisUP Reference Manual: ADAPTDCN Module

    ............. 225SeisUP Reference Manual: ADDHDR Module

    ............. 226SeisUP Reference Manual: AHCVEL Module

    ............. 227SeisUP Reference Manual: AMPCOR Module

    ............. 233SeisUP Reference Manual: AMPSTAT Module

    ............. 236SeisUP Reference Manual: ASCREAD Module

    .............. 237SeisUP Reference Manual: AUTC Module

    ............ 240SeisUP Reference Manual: AUTOREV Module

    .............. 243SeisUP Reference Manual: AVOA Module

    ............ 253SeisUP Reference Manual: AVOCROSS Module

    ............ 266SeisUP Reference Manual: AVOSCALE Module

    ............ 268SeisUP Reference Manual: AZIMVTRY Module

    ............. 270SeisUP Reference Manual: BINLINE Module

    ............. 272SeisUP Reference Manual: BINREAD Module

    .............. 275SeisUP Reference Manual: BLIP Module

    .............. 277SeisUP Reference Manual: BSSE Module

    .............. 279SeisUP Reference Manual: CAZM Module

    ............. 284SeisUP Reference Manual: CCPBIN Module

    ............ 287SeisUP Reference Manual: CENSUSDB Module

    ............. 288SeisUP Reference Manual: CHKNAN Module

    .............. 289SeisUP Reference Manual: CLIP Module

    ............ 290SeisUP Reference Manual: CLUSTEST Module

    ............. 292SeisUP Reference Manual: CMPLINE Module

    ............ 294SeisUP Reference Manual: CNSGEOM Module

    .............. 299SeisUP Reference Manual: COFF Module

    ............. 303SeisUP Reference Manual: COHFILT Module

    ............ 306SeisUP Reference Manual: COMREAD Module

    ............ 307SeisUP Reference Manual: COMWRITE Module

    .............. 310SeisUP Reference Manual: CONV Module

    ............ 313SeisUP Reference Manual: CROSSTIE Module

    ............. 314SeisUP Reference Manual: CUT3D Module

    ............. 316SeisUP Reference Manual: CVA2D Module

    ............. 321SeisUP Reference Manual: CVA3D Module

    ............ 327SeisUP Reference Manual: CVA3DHTI Module

    .............. 331SeisUP Reference Manual: CVFB Module

    ............. 332SeisUP Reference Manual: CVGMA Module

    ............. 333SeisUP Reference Manual: DBHDR Module

    ............. 337SeisUP Reference Manual: DBINQ Module

    iv

  • ............ 338SeisUP Reference Manual: DBMERGE Module

    ............. 340SeisUP Reference Manual: DCBIAS Module

    ............. 341SeisUP Reference Manual: DECON Module

    ............ 348SeisUP Reference Manual: DELHORZ Module

    ............. 349SeisUP Reference Manual: DELTAXY Module

    ............. 352SeisUP Reference Manual: DEMUX Module

    ............. 358SeisUP Reference Manual: DEPTH Module

    ............. 359SeisUP Reference Manual: DESPIKE Module

    .............. 360SeisUP Reference Manual: DICE Module

    ............. 363SeisUP Reference Manual: DICE3D Module

    ............. 366SeisUP Reference Manual: DIPMOD Module

    ............. 368SeisUP Reference Manual: DISINTG Module

    ............. 369SeisUP Reference Manual: DISPLAY Module

    .............. 393SeisUP Reference Manual: DLIST Module

    ............. 395SeisUP Reference Manual: DMO3D Module

    ............. 401SeisUP Reference Manual: DMODIST Module

    ............. 403SeisUP Reference Manual: DMOG Module

    .............. 407SeisUP Reference Manual: DMOS Module

    .............. 411SeisUP Reference Manual: DNG1 Module

    .............. 415SeisUP Reference Manual: DNG2 Module

    ............. 416SeisUP Reference Manual: DTYPE Module

    ............ 417SeisUP Reference Manual: ELASTICP Module

    ............ 421SeisUP Reference Manual: ELETOFLT Module

    .............. 423SeisUP Reference Manual: ENDIF Module

    ............. 425SeisUP Reference Manual: ENSBAL Module

    ............. 428SeisUP Reference Manual: ENSCLN Module

    ............. 430SeisUP Reference Manual: ENSDCN1 Module

    ............. 436SeisUP Reference Manual: ENSDCN2 Module

    ............. 438SeisUP Reference Manual: ENSFFT Module

    ............ 440SeisUP Reference Manual: ENSMATH Module

    ............ 442SeisUP Reference Manual: ENSSCALE Module

    ............. 447SeisUP Reference Manual: EQDIST Module

    ............. 450SeisUP Reference Manual: EQDMO Module

    ............. 455SeisUP Reference Manual: EXPHORZ Module

    ............. 457SeisUP Reference Manual: EXTRACT Module

    ............. 459SeisUP Reference Manual: FAKE3D2 Module

    ............. 461SeisUP Reference Manual: FBPBO2D Module

    ............ 464SeisUP Reference Manual: FBPICKMC Module

    ............. 468SeisUP Reference Manual: FCVFB Module

    .............. 470SeisUP Reference Manual: FDAF Module

    ............. 474SeisUP Reference Manual: FDMIG2D Module

    ............. 477SeisUP Reference Manual: FDMIG3D Module

    ............. 485SeisUP Reference Manual: FDUMP Module

    ............. 487SeisUP Reference Manual: FILTER Module

    ............. 490SeisUP Reference Manual: FKFILT Module

    v

  • .............. 494SeisUP Reference Manual: FKINT Module

    ............. 496SeisUP Reference Manual: FKKFILT Module

    ............. 502SeisUP Reference Manual: FKMIG Module

    ............. 508SeisUP Reference Manual: FKMOD Module

    ............. 514SeisUP Reference Manual: FKMRC Module

    ............. 517SeisUP Reference Manual: FKPLOT Module

    .............. 519SeisUP Reference Manual: FLAT Module

    .............. 521SeisUP Reference Manual: FLEX Module

    ............. 523SeisUP Reference Manual: FLEXBIN Module

    .............. 526SeisUP Reference Manual: FOLD Module

    ............ 529SeisUP Reference Manual: FORTHPIK Module

    ............. 534SeisUP Reference Manual: FRACDET Module

    ............ 539SeisUP Reference Manual: FREQTUNE Module

    ............ 543SeisUP Reference Manual: FRFSTPRP Module

    .............. 545SeisUP Reference Manual: FXDN Module

    ............. 547SeisUP Reference Manual: FXYDMIG Module

    ............. 551SeisUP Reference Manual: FXYDN Module

    ............. 553SeisUP Reference Manual: FXYMIG Module

    ............ 557SeisUP Reference Manual: FXYMIGEX Module

    ............. 558SeisUP Reference Manual: FXYMIGR Module

    .............. 559SeisUP Reference Manual: GAIN Module

    ............ 561SeisUP Reference Manual: GAMLSEIS Module

    ............. 572SeisUP Reference Manual: GCHG2D Module

    .............. 575SeisUP Reference Manual: GEOM Module

    ............. 579SeisUP Reference Manual: GEOMCK Module

    ............ 582SeisUP Reference Manual: GEOMEXT Module

    ............ 586SeisUP Reference Manual: GEOMVIEW Module

    ............. 589SeisUP Reference Manual: GEOVEL Module

    ............ 595SeisUP Reference Manual: GEOVEL3C Module

    ............. 599SeisUP Reference Manual: GNATTR Module

    ............. 602SeisUP Reference Manual: GNPLOT Module

    ............. 604SeisUP Reference Manual: GRNMTN Module

    .............. 608SeisUP Reference Manual: GRVA Module

    ............. 617SeisUP Reference Manual: GVLPICK Module

    ............ 622SeisUP Reference Manual: GVLPRINT Module

    ............ 625SeisUP Reference Manual: HAMPSON Module

    ............ 627SeisUP Reference Manual: HDRDUMP Module

    ............. 630SeisUP Reference Manual: HDRINTP Module

    ............. 634SeisUP Reference Manual: HDRSTK Module

    ............. 639SeisUP Reference Manual: HILBERT Module

    .............. 640SeisUP Reference Manual: HIP Module

    .............. 641SeisUP Reference Manual: HMTH Module

    ............. 642SeisUP Reference Manual: HORIZON Module

    ............. 644SeisUP Reference Manual: HORZIMP Module

    .............. 647SeisUP Reference Manual: HSUM Module

    vi

  • ............. 648SeisUP Reference Manual: IDLINBIN Module

    ............. 649SeisUP Reference Manual: IDRENUM Module

    ............... 651SeisUP Reference Manual: IF Module

    ............. 652SeisUP Reference Manual: IMPHORZ Module

    ............. 655SeisUP Reference Manual: IMPLS3D Module

    ............. 657SeisUP Reference Manual: INTGRT Module

    .............. 659SeisUP Reference Manual: INVEL Module

    ............. 660SeisUP Reference Manual: INVERSN Module

    .............. 667SeisUP Reference Manual: ISOV Module

    .............. 670SeisUP Reference Manual: IVEP Module

    ............. 680SeisUP Reference Manual: KAPTURE Module

    .............. 682SeisUP Reference Manual: KFIL Module

    ............. 685SeisUP Reference Manual: KTMIG Module

    .............. 702SeisUP Reference Manual: LAME Module

    .............. 704SeisUP Reference Manual: LAP Module

    .............. 707SeisUP Reference Manual: LCKF Module

    ............. 710SeisUP Reference Manual: LENGTH Module

    ............. 711SeisUP Reference Manual: LENGTH2 Module

    ............. 713SeisUP Reference Manual: LINE3D Module

    ............ 716SeisUP Reference Manual: LINENAME Module

    ............. 718SeisUP Reference Manual: LINSUB Module

    ............ 722SeisUP Reference Manual: LOGREAD Module

    ............. 724SeisUP Reference Manual: LRADON Module

    ............. 736SeisUP Reference Manual: MAPCON Module

    ............. 738SeisUP Reference Manual: MARINE Module

    ............. 740SeisUP Reference Manual: MATCH Module

    ............. 742SeisUP Reference Manual: MATCH2 Module

    ............. 744SeisUP Reference Manual: MATCON Module

    ............ 745SeisUP Reference Manual: MCADPDCN Module

    ............. 750SeisUP Reference Manual: MGEOM Module

    ............. 754SeisUP Reference Manual: MGRIDP1 Module

    ............ 756SeisUP Reference Manual: MIDGEOM Module

    ............. 757SeisUP Reference Manual: MIX3D Module

    ............. 761SeisUP Reference Manual: MIXD3D Module

    ............ 770SeisUP Reference Manual: MNMXAMP Module

    ............ 771SeisUP Reference Manual: MONOSUB Module

    .............. 773SeisUP Reference Manual: MPAS Module

    ............ 780SeisUP Reference Manual: MSOURCE Module

    ............ 783SeisUP Reference Manual: MSTATION Module

    .............. 788SeisUP Reference Manual: MULP Module

    .............. 793SeisUP Reference Manual: MUTE Module

    ............. 798SeisUP Reference Manual: MVREC Module

    ............. 799SeisUP Reference Manual: NMO3D Module

    .............. 801SeisUP Reference Manual: NMOA Module

    .............. 803SeisUP Reference Manual: NMOR Module

    vii

  • .............. 813SeisUP Reference Manual: NOISE Module

    ............. 814SeisUP Reference Manual: NOISEDIT Module

    ............ 817SeisUP Reference Manual: NOPERMIT Module

    ............. 821SeisUP Reference Manual: NOTCH Module

    .............. 825SeisUP Reference Manual: NSUB Module

    ............. 826SeisUP Reference Manual: NTEXT Module

    ............ 828SeisUP Reference Manual: OFFSCALE Module

    .............. 830SeisUP Reference Manual: OMIT Module

    ............. 832SeisUP Reference Manual: OPTDCN1 Module

    ............. 838SeisUP Reference Manual: OPTDCN2 Module

    ............ 840SeisUP Reference Manual: OPTDCNPL Module

    ............ 845SeisUP Reference Manual: OPTMUTE Module

    ............. 847SeisUP Reference Manual: PAD3D Module

    ............. 848SeisUP Reference Manual: PICKSHIF Module

    .............. 849SeisUP Reference Manual: PILOT Module

    ............. 852SeisUP Reference Manual: PILOT2 Module

    ............. 854SeisUP Reference Manual: PKMIG Module

    .............. 856SeisUP Reference Manual: PLOT Module

    ............. 883SeisUP Reference Manual: PMNORM Module

    ............. 884SeisUP Reference Manual: POLINT Module

    ............. 886SeisUP Reference Manual: POWER Module

    .............. 888SeisUP Reference Manual: PSI3D Module

    ............. 892SeisUP Reference Manual: PSMIG2D Module

    ............. 899SeisUP Reference Manual: PSMIG3D Module

    ............. 908SeisUP Reference Manual: PSUTIL Module

    ............. 910SeisUP Reference Manual: PTHROW Module

    ............. 913SeisUP Reference Manual: PTSLICE Module

    ............. 915SeisUP Reference Manual: PWAVO Module

    .............. 927SeisUP Reference Manual: QC3D Module

    ............. 929SeisUP Reference Manual: QCMUTE Module

    ............. 931SeisUP Reference Manual: QCOMP Module

    ............. 935SeisUP Reference Manual: QCVEL Module

    ............. 938SeisUP Reference Manual: QCVIEW Module

    ............. 954SeisUP Reference Manual: QDERIVE Module

    ............. 958SeisUP Reference Manual: QFILTER Module

    ............. 962SeisUP Reference Manual: RADON Module

    ............. 969SeisUP Reference Manual: RADON1 Module

    ............. 982SeisUP Reference Manual: RADONC Module

    .............. 995SeisUP Reference Manual: RAS1 Module

    .............. 997SeisUP Reference Manual: RAS2 Module

    .............. 998SeisUP Reference Manual: RAS3 Module

    ............. 999SeisUP Reference Manual: RAS3D1 Module

    ............. 1002SeisUP Reference Manual: RAS3D2 Module

    .............. 1004SeisUP Reference Manual: RAS4 Module

    .............. 1006SeisUP Reference Manual: RDMO Module

    viii

  • .............. 1010SeisUP Reference Manual: READ Module

    ............. 1015SeisUP Reference Manual: REFST Module

    ............ 1026SeisUP Reference Manual: REFSTPRP Module

    ............. 1028SeisUP Reference Manual: REGRID Module

    ............. 1030SeisUP Reference Manual: SOURCE Module

    ............. 1035SeisUP Reference Manual: REPEAT Module

    ............. 1037SeisUP Reference Manual: RESAMP Module

    ............. 1038SeisUP Reference Manual: RESID1 Module

    ............. 1047SeisUP Reference Manual: RESID2 Module

    ............ 1056SeisUP Reference Manual: RESMERGE Module

    .............. 1057SeisUP Reference Manual: RFMT Module

    .............. 1064SeisUP Reference Manual: RFS1 Module

    .............. 1071SeisUP Reference Manual: RLIV Module

    ............. 1075SeisUP Reference Manual: RMHDR Module

    ............. 1076SeisUP Reference Manual: RNDCLN Module

    ............. 1078SeisUP Reference Manual: ROTATE Module

    ............ 1080SeisUP Reference Manual: ROTATE2C Module

    ............ 1086SeisUP Reference Manual: ROTATE4C Module

    .............. 1094SeisUP Reference Manual: RSIM Module

    .............. 1095SeisUP Reference Manual: RT3D Module

    ............. 1096SeisUP Reference Manual: RWSUM Module

    ............. 1097SeisUP Reference Manual: RZERO Module

    ............. 1098SeisUP Reference Manual: SCALE Module

    .............. 1101SeisUP Reference Manual: SCAT Module

    ............. 1103SeisUP Reference Manual: SCDCN1 Module

    ............. 1106SeisUP Reference Manual: SCDCN2 Module

    ............. 1108SeisUP Reference Manual: SCDCN3 Module

    ............ 1109SeisUP Reference Manual: SCDECON1 Module

    ............ 1120SeisUP Reference Manual: SCDECON2 Module

    ............. 1124SeisUP Reference Manual: SCPHD1 Module

    ............. 1127SeisUP Reference Manual: SCPHD2 Module

    ............. 1129SeisUP Reference Manual: SCPHD3 Module

    .............. 1130SeisUP Reference Manual: SEG2 Module

    .............. 1133SeisUP Reference Manual: SEGP1 Module

    ............ 1135SeisUP Reference Manual: SEGYREAD Module

    ............ 1144SeisUP Reference Manual: SEGYWRIT Module

    ............. 1149SeisUP Reference Manual: SELECT Module

    .............. 1151SeisUP Reference Manual: SGN1 Module

    .............. 1153SeisUP Reference Manual: SGN2 Module

    .............. 1158SeisUP Reference Manual: SGN3 Module

    ............. 1160SeisUP Reference Manual: SGNE1 Module

    ............. 1163SeisUP Reference Manual: SGNE2 Module

    .............. 1165SeisUP Reference Manual: SLICE Module

    .............. 1166SeisUP Reference Manual: SMIG Module

    ............ 1173SeisUP Reference Manual: SMIGSAVE Module

    ix

  • ............. 1174SeisUP Reference Manual: SMOOTH Module

    ............ 1177SeisUP Reference Manual: SMTHANG Module

    ............ 1178SeisUP Reference Manual: SMVSLICE Module

    .............. 1182SeisUP Reference Manual: SNR Module

    .............. 1184SeisUP Reference Manual: SORT Module

    ............. 1186SeisUP Reference Manual: SOURCE Module

    .............. 1191SeisUP Reference Manual: SPER Module

    ............. 1194SeisUP Reference Manual: SPIKEDIT Module

    ............. 1197SeisUP Reference Manual: SPRSKID Module

    .............. 1198SeisUP Reference Manual: SPS Module

    ............. 1202SeisUP Reference Manual: SQUEEZE Module

    ............ 1203SeisUP Reference Manual: SRINTERP Module

    ............. 1206SeisUP Reference Manual: SSDECON Module

    .............. 1211SeisUP Reference Manual: SSMP Module

    ............. 1213SeisUP Reference Manual: STACK Module

    ............. 1215SeisUP Reference Manual: STACK3D Module

    ............. 1217SeisUP Reference Manual: STATIC Module

    ............ 1230SeisUP Reference Manual: STATINTP Module

    ............. 1232SeisUP Reference Manual: STATION Module

    ............. 1238SeisUP Reference Manual: STKSNR Module

    ............. 1240SeisUP Reference Manual: STRETCH Module

    .............. 1241SeisUP Reference Manual: STRM Module

    ............. 1243SeisUP Reference Manual: STTINTP Module

    ............. 1245SeisUP Reference Manual: SUBSEGY Module

    ............ 1247SeisUP Reference Manual: SURFWAVE Module

    ............. 1249SeisUP Reference Manual: SURMAT Module

    .............. 1251SeisUP Reference Manual: SWAP Module

    ............. 1253SeisUP Reference Manual: SYNDIP Module

    ............. 1256SeisUP Reference Manual: SYNTH Module

    .............. 1258SeisUP Reference Manual: TAUF Module

    ............ 1262SeisUP Reference Manual: TAUPDMO Module

    ............. 1266SeisUP Reference Manual: TCOPY Module

    .............. 1267SeisUP Reference Manual: TDAF Module

    ............. 1270SeisUP Reference Manual: TDUMP Module

    ............ 1279SeisUP Reference Manual: TFDNOISE Module

    ............. 1285SeisUP Reference Manual: TOVG0 Module

    ............ 1287SeisUP Reference Manual: TRACECAL Module

    ............ 1294SeisUP Reference Manual: TRACECMB Module

    ............ 1298SeisUP Reference Manual: TRACEFFT Module

    ............ 1300SeisUP Reference Manual: TRANSPOS Module

    ............. 1302SeisUP Reference Manual: TRCPLOT Module

    ............. 1308SeisUP Reference Manual: TRCREM Module

    ............ 1310SeisUP Reference Manual: TRIMCMP Module

    .............. 1315SeisUP Reference Manual: TRIP Module

    ............. 1317SeisUP Reference Manual: TRIP5D Module

    x

  • .............. 1324SeisUP Reference Manual: TVEQ Module

    ............. 1327SeisUP Reference Manual: TVMULT Module

    .............. 1331SeisUP Reference Manual: TVSA Module

    ............. 1333SeisUP Reference Manual: TVSAC Module

    .............. 1336SeisUP Reference Manual: TVSE Module

    ............. 1339SeisUP Reference Manual: TVSEC Module

    ............. 1342SeisUP Reference Manual: TVTRIM Module

    .............. 1344SeisUP Reference Manual: TVZD Module

    ............. 1348SeisUP Reference Manual: UKOOA Module

    ............. 1351SeisUP Reference Manual: UNDUPE Module

    ............. 1359SeisUP Reference Manual: UNSCALE Module

    .............. 1361SeisUP Reference Manual: VA3C Module

    .............. 1363SeisUP Reference Manual: VCOR Module

    ............ 1365SeisUP Reference Manual: VELCONV Module

    ............ 1368SeisUP Reference Manual: VELSMTH Module

    ............ 1370SeisUP Reference Manual: VEXTRACT Module

    ............. 1371SeisUP Reference Manual: VIBMIN Module

    ............ 1373SeisUP Reference Manual: VIEWER3D Module

    ............. 1374SeisUP Reference Manual: VIMPEXP Module

    .............. 1377SeisUP Reference Manual: VIP Module

    ............. 1381SeisUP Reference Manual: VIPINV Module

    ............. 1383SeisUP Reference Manual: VIPMATH Module

    ............. 1384SeisUP Reference Manual: VORMED Module

    ............. 1386SeisUP Reference Manual: VORONOI Module

    ............. 1389SeisUP Reference Manual: VORSCL Module

    ............. 1390SeisUP Reference Manual: VSLICE Module

    .............. 1395SeisUP Reference Manual: VSUM Module

    ............ 1398SeisUP Reference Manual: WAVELET Module

    ............ 1401SeisUP Reference Manual: WAVEMULT Module

    ............. 1404SeisUP Reference Manual: WRITE Module

    ............. 1408SeisUP Reference Manual: WTNRC Module

    .............. 1411SeisUP Reference Manual: XAVA Module

    .............. 1416SeisUP Reference Manual: XEQU Module

    ............. 1418SeisUP Reference Manual: XYGEOM Module

    ............. 1420SeisUP Reference Manual: XYMAP Module

    .............. 1424SeisUP Reference Manual: ZAVO Module

    .................... 1439ASCII data type

    .................... 1440BIN data type

    .................... 1441CGM data type

    .................... 1442CMAP data type

    .................. 1443COMPRESS data type

    .................... 1444DGN1 data type

    .................... 1445DNS1 data type

    ................... 1446ENSDCN data type

    ................... 1447FDMIG data type

    xi

  • ................... 1448FXYDSV data type

    ................... 1449FXYMIG data type

    ................... 1450FXYSAV data type

    .................... 1451GCI Data Type

    .................... 1458GVL data type

    ................... 1459KTMIG data type

    .................... 1460LAS data type

    ................... 1461OPTDCN data type

    .................... 1462PSM data type

    .................... 1463RAS1 data type

    ................... 1464RAS3D1 data type

    .................... 1465REG data type

    .................... 1466RFMT data type

    .................... 1467RFS1 data type

    ................... 1468SCDCN1 data type

    ................... 1469SCDCN2 data type

    .................. 1470SCDECON1 data type

    ................... 1471SCPHD1 data type

    ................... 1472SCPHD2 data type

    .................... 1473SEG-Y data type

    .................... 1478SGN1 data type

    .................... 1479SGNE1 data type

    .................... 1480SMIG data type

    .................... 1481Matrix 3DDIR

    ................... 1484Matrix 3DREFDEF

    ................... 1488Matrix 4THNMO

    .................... 1490Matrix AFS1B

    ................... 1492Matrix AMPSTAT

    ................... 1494Matrix AMPWIN

    ................... 1495Matrix APERTURE

    .................... 1497Matrix AUTC

    .................... 1498Matrix AVGVEL

    .................... 1500Matrix AVOC

    ................... 1501Matrix CMPDATUM

    ................... 1502Matrix COFFOFF

    ................. 1503Dialog COLORSURFDEF

    ................... 1506Matrix CONVFREQ

    .................. 1507Matrix CONVFREQ1

    ................... 1509Matrix CONVTIM

    ................... 1510Matrix CONVTIME

    ................... 1511Matrix CVAETAS

    ................... 1512Matrix CVAVELS

    .................... 1513Matrix DBFOLD

    ................... 1514Matrix DBFOLDOFF

    .................... 1516Matrix DECON

    xii

  • .................... 1518Matrix DFORM

    ..................... 1521Matrix DICE

    ................... 1523Matrix DIPMODEL

    .................... 1525Matrix DISTOFF

    .................... 1526Matrix DMUX

    ................... 1528Matrix DNGBINS

    ................... 1530Matrix DSETLIST

    ................... 1531Matrix DUMPLIST

    .................... 1532Matrix ENSWIN

    ................... 1533Matrix ETANMO

    .................... 1535Matrix EVEL

    ................... 1537Matrix EXTRACT

    ................... 1541Matrix FILEFREQ

    .................... 1542Matrix FILES

    .................... 1543Matrix FILTER

    ................... 1545Matrix FILTERB

    .................... 1547Matrix FKFAN

    .................... 1549Matrix FKFANV

    .................... 1551Matrix FKPOLY

    ................... 1553Matrix FKPOLYV

    .................... 1555Matrix FLEX

    ................... 1556Matrix FLEXOVP

    ................... 1558Matrix FXYFREQ

    .................... 1560Matrix GAIN

    ................... 1562Matrix GCIHDREXT

    .................... 1563Matrix GDELAY

    ................... 1565Matrix GEOMCK

    ................... 1567Matrix GVLAWIN

    ................... 1569Matrix GVLPREF

    .................... 1572Matrix HMTH

    ................... 1576Matrix HORIZON

    ................... 1577Matrix HORIZON3D

    .................... 1579Matrix INTVEL

    ................... 1581Matrix IREFVEL

    ................... 1583Matrix ISOVBINS

    ................... 1585Matrix ISOVHORS

    ................... 1586Matrix ISOVLINS

    ................... 1588Matrix ISOVTIMS

    ..................... 1590Matrix KFIL

    .................. 1592Matrix LASHEADER

    .................... 1593Matrix LCKF

    .................... 1595Matrix LINAME

    .................... 1597Matrix LINES

    ................... 1598Matrix LMOVEL

    .................. 1600Matrix MARINEGEOM

    xiii

  • .................... 1603Matrix MATCH

    .................... 1604Matrix MATCH2

    ................... 1606Matrix MIDPOINT

    ................... 1607Matrix MIX3DWGT

    ................... 1610Matrix MPISNODES

    ................... 1611Matrix MULPPER

    .................... 1613Matrix MUTE

    ................... 1615Matrix MUTECONT

    ................... 1617Matrix MXLINE3D

    .................. 1619Matrix MXLINE3DXY

    ................... 1621Matrix NMOMUTE

    ................... 1623Matrix NOTCHFIL

    ................... 1625Matrix OFFBDIST

    .................... 1626Matrix OMIT

    .................... 1629Matrix OPTDCN

    ................... 1632Matrix OPTDCNP1

    .................... 1634Matrix PATREC

    ................... 1636Matrix PATTERN

    ................... 1638Matrix PATTERNM

    .................. 1640Matrix PLOTENTRY

    ................... 1641Matrix PLOTLIST

    .................... 1642Matrix PLOTLT

    ................... 1644Matrix PLOTLTCUS

    ................. 1646Matrix PLOTNOTETEXT

    ................... 1647Matrix PLOTPRF

    .................. 1649Matrix PLOTSINGLE

    ................... 1650Matrix PLOTSPMX

    .................. 1651Matrix PLOTSYMBOLS

    ................... 1653Matrix PLOTTIC

    ................... 1654Matrix PLOTTRIP

    .................... 1655Matrix PSMQC

    ................... 1656Matrix PSROTANG

    ................... 1657Matrix PSROTANG1

    ................... 1659Matrix QCOMPF

    ................... 1661Matrix QCOMPS

    ................... 1663Matrix QCOMPV

    ................... 1665Matrix QCVELWIN

    ................... 1666Matrix QMATRIX

    ................... 1668Matrix QVALUES

    .................... 1670Matrix RADON

    .................... 1672Matrix RADON1

    ................... 1674Matrix RAS2GEO

    ................... 1675Matrix RAS2SRC

    ................... 1676Matrix RECMASK

    ................... 1677Matrix RECVGEOM

    xiv

  • .................... 1681Matrix REELS

    ................... 1682Matrix REGIONS

    ................... 1684Matrix REGIONST

    .................... 1686Matrix RFMT

    ................... 1688Matrix RFMTSEGD

    .................... 1690Matrix RMOD

    ................... 1691Matrix RMSFCSN

    ................... 1693Matrix RMSSSPN

    .................... 1695Matrix RMSV3C

    .................... 1697Matrix RMSVEL

    .................... 1699Matrix SCDCN1

    ................... 1701Matrix SCDECON1

    .................... 1703Matrix SCLDB

    .................... 1704Matrix SCLSCL

    .................... 1705Matrix SCLWIN

    .................... 1707Matrix SDELAY

    ................... 1709Matrix SEGYEBC

    ................... 1710Matrix SEGYLINES

    .................. 1711Matrix SEGYREMAP

    ..................... 1713Matrix SGN1

    ..................... 1715Matrix SGN2

    .................... 1717Matrix SGNE

    .................. 1719Matrix SMOOTHHORZ

    ..................... 1721Matrix SNR

    .................... 1722Matrix SOURCE

    ................... 1724Matrix SOURCE2

    ................... 1727Matrix SOURCEM

    ................... 1730Matrix SRCDXOFF

    ................... 1734Matrix SRCDXOFF2

    ................... 1739Matrix SRCMXLST

    .................. 1740Matrix SRCRECREC

    .................. 1743Matrix SRCRECREC2

    ................... 1747Matrix SRCRECSPD

    .................. 1750Matrix SRCRECSPD2

    ................... 1754Matrix SRCRECXY

    ................... 1757Matrix SRCRECXY2

    ................... 1761Matrix SRCXYREC

    ................... 1764Matrix SRCXYREC2

    ................... 1768Matrix SRCXYSPD

    ................... 1771Matrix SRCXYSPD2

    ................... 1775Matrix SRGMUTE

    .................... 1777Matrix SSDEC

    ................... 1778Matrix STAELEV

    ................... 1780Matrix STATGEO

    ................... 1782Matrix STATION

    xv

  • ................... 1784Matrix STATSEQ

    ................... 1786Matrix STATSRC

    ................... 1788Matrix SURFACE

    ................... 1790Matrix SURFDEF

    .................. 1792Matrix SURFSMOOTH

    .................. 1794Matrix SVSHTSHIFT

    .................... 1795Matrix SYNDIFF

    ................... 1797Matrix SYNDIPOA

    .................... 1799Matrix SYNDIPS

    .................... 1802Matrix TARGET

    .................... 1804Matrix TAUF

    .................. 1806Matrix TRCPLOT_CMT

    .................. 1807Matrix TRCPLOT_GAP

    ..................... 1808Matrix TSVP

    .................... 1810Matrix TVDIP

    ................... 1812Matrix TVSMOOTH

    .................... 1814Matrix TVTVZD

    ................... 1816Matrix TVTVZDC

    ................... 1818Matrix TVTVZDD

    .................... 1820Matrix TVZD

    ................... 1822Matrix USRFCSN

    ................... 1823Matrix USRMBIN

    .................... 1824Matrix USRSBIN

    ................... 1825Matrix USRSGEN

    ..................... 1826Matrix V0

    ................... 1827Matrix VA3CDIP

    ................... 1828Matrix VABINS2D

    ................... 1830Matrix VABINS3D

    ................... 1832Matrix VPVSDEN

    .................... 1834Matrix VS2VP2

    .................... 1835Matrix VSUM

    .................... 1838Matrix VVSPER

    ................... 1840Matrix WEIGHTS

    ................... 1841Matrix WINDOWS2

    ..................... 1844Matrix X_T

    ................... 1845Matrix XTTAPER

    .................... 1847Matrix XYDIP

    .................... 1849Release Notes

    xvi

  • Documentation >

    SeisUP 2013 Help Documentation

    Applications and Administration

    Reference

    Modules Data Types Matrices SDK Programming Manual (PDF format) SDK Reference Manual (PDF format)

    Release Notes

    Copyright 2013 GeoCenter LP

    1

  • Documentation > SeisUP Applications Manual >

    SeisUP Applications Manual

    Administration

    Lots of useful information for optimal SeisUP usage. Includes descriptions for SeisUP admin scripts, anumber of "General Usage" tips, troubleshooting and third party development.

    DataManager

    The DataManager application provides a through and organized view of the data known to SeisUP. Alongwith viewing the data sets for any SeisUP project, other features include setting up the output filesystemslist, tape definitions file and the ability to archive/restore projects.

    Flow Editor (Geodraw)

    An introduction to SeisUP: starting a SeisUP session, building processing flows and running jobs.

    Matrix Editor (Geosp)

    An introduction to the multidimensional spreadsheet program used within SeisUP to manipulatedimensional vector information such as geometry and velocities.

    HistoryViewer

    Complete documentation on viewing the processing history of a SeisUP data set using the HistoryViewer program.

    JobMonitor

    Complete documentation on viewing the status all running SeisUP jobs using the JobMonitor program.Also describes how the user may interact with running jobs.

    JobServer (seisupd)

    An introduction and administrative information regarding SeisUPs job server which is responsible forspawning processes that represent the work-flows submitted by users via the FlowEditor.

    License Server / Licensing Scheme

    2

  • A discussion of the license scheme and administration of the license management subsystem.

    Plotting

    This document describes how to setup SeisUPs interface with 3rd Party plotting software to produce hard copies.

    Copyright 2013 GeoCenter LP

    3

  • SeisUP has undergone some significant changes in function. Many will not be visible to the normal userbut administrators and programmers need to be aware of what has changed. This release incorporates thenew administrative functions as well as new modules. This document discusses both old and new versions.

    OverviewThe SeisUP administrative tools are grouped by function. Most tools can be used by anyone, some requireroot access.

    General informationAdministrative configuration files. Dataset naming conventions. The directory structure was changed for the 2005 release. Files stored in user home directories.

    Installation and License issuesSeisUP is changing its licensing code from an internal system to Flexlm in order to provide additional flexibility.

    Installation of SeisUP is relatively easy. Documentation is on the SeisUP CD. The main issues arewhere to put the executables and where to put the seismic data. As a general rule, do not put seismicdata on the same device as the OS. Also try to keep the SeisUP usr directory off of the device withthe OS as well. The new license_install script is very similar to the old version. Several options have been removedbecause the SDI functions have also moved to Flexlm. This link is a discussion of the new Flexlm licensing. Flexlm licensing installation

    General purposeThe backuparea script allows the user to save a copy of the flows and optionally the data for an areato disk or tape. The option to save to a file is new. NOTE The tape drive is assumed to be locallyattached. Search for "orphaned" datasets with the new chkdset script. This is a replacement for the old fixdsets function. chklinks The listing files names and locations will change. The cleanup_run_logs script moves and renamesthe listing files to the new location. Get a list of the actual locations of datasets with the dset_files script. This has been partly absorbedby the dskinv function. A catch all program for disk space reports - dskinv. This new script, dump_job_cache, provides a fast way to see what jobs are running in a line withouthaving to have a graphic connection to the machine.

    4

  • Use fixdsets to update dataset locations when data has been moved to another location. This new script allows the user to watch job activity as jobs enter and leave the job queue. jm_multicast_monitor This new script scans an area for live datasets and optionally tars them to a file. project_data The restorearea script allows the user to bring an area and its data back from storage. This is a utility to send commands to the new SeisUP daemon. seisupd_admin This is a script to stop, start or restart the new daemon. seisupd_ctl This is a script to install the new daemon. seisupd_install This provides a way to follow the SeisUP job log without having to have a graphical interface. seisupd_log_mon This new script presents a list of available plot streams and allows the user to changes settings. select_plotting_subsystem This new script updates the help browser default. set_help_viewer This function sets the reel number on a tape. - tapeinit - Tapes normally do not come with serialnumbers set. The tape library can be used to verify tapes are accessed in the correct order. This function allows a tape drive on a remote machine to be accessed by a SeisUP job. The tapeconfiguration file must contain the full path to this executable on the remote machine. If it is not running,the job will attempt to start it. tapeserv

    Cluster toolsThese are new functions to maintain a cluster.

    To send the same command to several cluster nodes use cluster command. Use cluster dist to copy files to a list of nodes. A new provision allows each cluster node to have localcopies of executables to reduce bandwidth demands at job startup. A function to generate entries for the /etc/hosts file. cluster host_entries A function to generate node lists. cluster node_entries A function to turn off cluster nodes. cluster_poweroff A function to reboot cluster nodes. cluster_reboot A wrapper for cluster_dist. dist_cluster_program Kill a users jobs on a node with rkill.pl. A GUI wrapper for rkill.pl rutil.

    PlottingA discussion of the new plotting control functions.

    Troubleshooting and other odd toolsIf something breaks.

    5

  • Use the compact command to free space form DB files. This has largely been replaced with the dbucommand. Use the config_seisup_script to change the $QEDTOP referenced in the seisup script. Previous releases used a different structure for the flow files. The convflow6_7 function will updatethe flow. The db_dump function can dump the contents of a DB file. The work horse of DB utilities is the dbu command. It combines several functions and is moretolerant of corrupted DB files. Use dump_flow to get a list of all nodes and node IDs in a flow file. The dump_id command reports the most recently run node and job ID. The goodbad command does a quick check of a DB file. It reports if it can read all entries. If it can,the DB file is good. SeisUP can sometimes lockup. The steps to take if this happens are here. The rebuild command has mostly been replaced by the dbu command. The dreaded segfault. If all else fails a good bug report can speed up fixes considerably.

    Development toolsThese are for writing your own modules.

    The build system has been updated between releases, the programming manual has not yet been updated.The changes are fairly minor.

    There are two programming manuals. One describes the needed files and the other describes availablefunctions. The new cat_update script updates the SeisUP.cat file in $QEDTOP/lib/db/cat. Previously a thirdparty application had its own .cat file in the same directory. Use the catout to get a list of modules on the system. The new exec_debug script is evoked when a job is run in debug mode. To run jobs in debug modeyou must first start seisup with the debug flag:

    seisup nw

    In order to get a list of SURFACE horizons for a parameter list, use the ls_horizons function in themodules .pdb file. In order to get a list of nodes for a parameter list use the lst_nodes function in the moduless .pdb file. The new modgen script will build a skeleton C module. In order to get a list of plot logos for a parameter list use the plot_logos function in the modules .pdbfile. In order to get a list of pvm hosts for a parameter list use the pvm_hosts function in the modules .pdbfile In order to get a list of color maps for a parameter list use the sup_cmaps function in the modules.pdb file

    6

  • SeisUP Configuration Files

    SeisUP Installation Directorybin/

    glp

    etc/

    seisup.cshfilesystemstape_devicesio.confseisupd.confexec.confmatrix.confhorizon.conf

    lib/

    qedhostspvmhostsqedtapesnodes/*logo/default.wdf

    Also see:

    Plotting

    glpThis script is executed whenever the user selects print in the help viewer or when displaying theexecution status. The provided script simply uses the "lp" command on the resident system. You mayneed to modify the script to accommodate your printing subsystem.

    seisup.cshThis file can be read in your .cshrc file to properly initialize your environment for SeisUP. Forexample, if SeisUProotDirectory above is /seisup and you are on a Sun, add the following to the endof you .cshrc file: source /seisup/etc/seisup.csh

    7

  • filesystemsThis file will list directories or file systems available for creating disk data sets via the disk manager.Previous versions of SeisUP may have suggested placing "local" or "remote" after the path of thefilesystem. That format is no longer supported. Each line in this file must be either a comment (theline starts with the # character) or a path to a filesystem. The disk manager will attempt to distributedisk files among different file systems using a disk selection method defined in the io.conf file(description below). All data sets will be written to the filesystems listed in this file, except when theuser explicitly sets up an alternative filesystems list for a SeisUP project using the "Filesystems"option from the "Options" menu in the Flow Editor program.If all of the file systems fill up, the disk manager will attempt to communicate with the user to requestif the job should abort, or continue after the user releases some disk space. This file may be modified manually or by using the Data Filesystems Manager option accessed fromthe Data Manager applications File menu.

    tape_devicesThis file defines the list of available tape drives. The job server does not automatically add the list oflocal tape devices to this file, instead the user may repopulate the list using the "Discover Tapes"button from the Tape Devices Manager Dialog within the Data Manager application. The reason thisfunctionality has been removed from the job server was so that the new job server may remainindependent of other parts of SeisUP. This file may be edited manually or via the Tape DevicesManager option accessible from the Data Managers File menu.

    io.confThis configuration file has been added to improve disk usage. By modifying the io.conf file the usercan set a free space requirement on disk selection so that disks with very little free space will not bewritten to. The user may also set the disk selection algorithm to random, based on available space, ornumber of processes using the disk. Please read the comments in the io.conf file for a more detailedexplanation of possible I/O configurations.

    seisupd.confThis new configuration file defines parameters for the job server, seisupd. After any modificationsthe job server will need to be restarted. The default network parameters may be changed should theyconflict with your network.

    exec.confThis file will contain parameters to be used when running jobs in SeisUP. For instance:

    MAX_ENSEMBLE The maximum number of traces per ensemble to hold in memory if notstacked data.

    MAX_ENSEMBLE_STACK The maximum number of traces per ensemble to hold memory for stacked data

    8

  • matrix.confThis file will define names of matrix types are to be saved to the processing history file in the internalSeisUP formatted data sets.

    horizon.confThis file will define colors to be used for interpreted horizons.

    qedhostsThis file will define the hosts available for executing jobs. Each host listed here should have the jobserver running. In previous versions this file held the license keys. That is no longer the case, licensefiles are now stored in the SeisUProotDirectory/etc/ directory.

    pvmhostsThis file will define the hosts available for parallel execution when spawning off child processes.

    qedtapes This file will define the range of tape numbers for tape media types available at this site.

    nodes/*This directory will define the hosts available for non-PVM parallel execution when spawning offchild processes or multi-threaded applications. An example module that uses this is KTMIG. A filenamed default must always exist. The default file contains the default host list. The SystemsAdministrator can create various combinations of host lists in this directory. A user can select a hostlist file from the module parameter menu over which to run his application on. An example usage onan SMP machine named godzilla with 16 CPUs and a Linux cluster of 128 nodes with dual CPUscould contain one entry in the default file as follows:

    godzilla cpu=16A second file could be named cluster would contain one entry for each of the 128 cluster nodes,named node1, node2, ..., as follows:

    node1 sys=linux cpu=2node2 sys=linux cpu=2. . .

    . . .

    The user would then be able to select to run the parallel job either on the SMP machine or the clustervia the parameter menu for the module.

    9

  • logo/default.wdfThis file is an X-window dump file of the logo to be displayed by the PLOT module for the defaultlogo. Other logos are located in the same directory. The file extension .wdf is an alias for .xwd whicha number of image manipulation programs can output. GIMP and Image Magic are both free and canproduce this format. Client logos should have the total number of colors reduced to < 10 colors.

    Copyright 2013, GeoCenter LP. All rights reserved. SeisUP is a registered trademark of GeoCenter LP.

    10

  • Dataset Naming Convention

    Data DirectoriesSeisUPs naming convention for disk datasets in the data directories is:

    Area.Line.Dataset.type.[number]

    Dataset is limited to 8 characters for display reasons.

    Type can be something like GCId, GCIm, GCIz, SEGY, CGM, ... Number is usually a 1 if present. If adataset has been split, Number will be 2, 3, ... This only happens if a data directory has run out of spaceand the data is sent to another disk.

    SeisUPs internal data format is named GCI. A GCI dataset has at least three parts. The GCId dataset isthe actual data. The GCIm dataset is a map file used to speed up access to the data. The GCIz dataset,which is not strictly required, is a mostly ASCII history file that contains the processing flow andparameters. Any of the three can be split among data directories.

    NOTE Putting punctuation in an area, line or dataset name is generally a bad idea. Periods (.) and spacescan cause many problems. Underscores (_) are permitted.

    SeisUP Usr DirectoriesThere are a number of files under the SeisUP usr directory which contains the area / line files. The biggestby far are the files named DB. They contain geometry and other information. The flow file contains themodules and connections. Datasets are controlled by the .cleanup files. Job listings are either .lst or .runlog files.

    11

  • DIRECTORY TREEAll directories listed here are rooted at $QEDTOP - the highest level SeisUP directory. $QSYS is thesystem type, i.e. linux, sun, sgi, hp or nt. It is possible to have multiple installations for differentarchitectures sharing a $QEDTOP. It is not possible to have different versions of SeisUP installed in thesame $QEDTOP but it is possible to have them on the same machine.

    The current directory structure is as follows.

    DocumentationDocumentation/ApplicationsDocumentation/Applications/Administratium Tool help files.Documentation/Applications/DataManager Datamanager help.Documentation/Applications/Geoall Color table help.Documentation/Applications/Geodraw Flow editor help.Documentation/Applications/Geosp Matrix help.Documentation/Applications/HistoryViewer Historyviewer help.Documentation/Applications/JobMonitor Jobmonitor help.Documentation/Applications/JobServer Jobserver help.Documentation/Applications/LicenseServer License help.Documentation/Applications/Plotting Plotting help.Documentation/ReferenceDocumentation/Reference/DataTypes Data type help.Documentation/Reference/Matricies Matrix help.Documentation/Reference/Modules Module help.Documentation/Reference/ReleaseNotes Release notes.binbin/${QSYS} Various mostly command line tools.bin/${QSYS}/admin Administrative tools.bin/${QSYS}/devel Development tools.bin/${QSYS}/list_gen List generating tools.bin/${QSYS}/plotting Plotting scripts. bin/${QSYS}/sdi SDI executables. These may not be present.etc Configuration files.include Include files for programming.install Installation scripts.liblib/app-defaults X window display files.lib/cmaps Color maps.lib/db/cat Catalog files.lib/db/ldb Parameter list files.lib/db/mdb Module definition files.lib/db/pdb Module parameter files.lib/db/xdb Matrix definition files.lib/${QSYS} Library files and third party executables.lib/log Log files for the license server.lib/logo Plot logos.lib/nodes Node definition files.lib/txt Display icons.sdi Tape database.syssys/GeoSeissys/GeoSeis/bin/${QSYS} SeisUP executables.sys/GeoSeis/segy Global DB file.tmp

    12

  • usr

    usr/area Area DB file.usr/area/line Line DB, flow and cleanup files.usr/area/line/run_logs listing files.

    Some files are not located under $QEDTOP. These are:/var/run/seisupd.pid The process ID of the SeisUP daemon./var/log/seisupd.log The message log for the SeisUP daemon.

    The directory structure for SeisUP 2004 and prior was as follows.

    binbin/${QSYS} Various mostly command line tools.bin/${QSYS}/sdi SDI executables.devp Programming manuals and examples.include Include files for programming.install Installation scripts.java Java libraries for instrument tests.jm/[machine_name] Jobserver, start and stop scripts, log files.liblib/app-defaults X window display files.lib/cmaps Color maps.lib/db/cat Catalog files.lib/db/ldb Parameter list files.lib/db/mdb Module definition files.lib/db/pdb Module parameter files.lib/db/xdb Matrix definition files.lib/hlp System help files.lib/${QSYS} Library files and third party executables.lib/logo Plot logos.lib/nodes Node definition files.lib/txt Display icons.sdi Tape database.syssys/GeoSeissys/GeoSeis/bin/${QSYS} SeisUP executables.sys/GeoSeis/hlpsys/GeoSeis/hlp/dt Data type help files.sys/GeoSeis/hlp/mod Module help files.sys/GeoSeis/hlp/mx Matrix help files.sys/GeoSeis/hlp/release Release notes.sys/GeoSeis/lib Libraries.sys/GeoSeis/segy Global DB file.tmpusr

    usr/area Area DB file.usr/area/line Line DB, flow, cleanup and listing files.

    The seisup.csh file, located in bin/${QSYS}, when "sourced" from a csh shell, will set severalenvironmental variables and update the PATH variable.

    13

  • SeisUP Files Stored in User Home Directories

    Files.compression.flexlmrc.qedgeometry.qt/.seisup/ selected_plotter last_project projects/ gradients/.SeisUPdisplay.seisupenv

    .compressionUsers default values for GCI data compression is stored in this file.

    .flexlmrcTechnically this is not solely a SeisUP file, it may be used by any software which uses FlexLM forlicense management. Its purpose is to store license file locations.

    .qedgeometryStores the size, screen position and default icon size used in the last SeisUP session.

    .qt/This directory contains preferences files for QT applications. Several SeisUP utility applications,such as the JobMonitor and DataManager, fall in this category. If youve used the JobMonitor, forinstance, then you should have a file ~/.qt/jobmonitorrc.

    .seisup/

    selected_plotterStores which plotter, from the plotters list, is the users default.

    14

  • last_projectStores the last saved SeisUP project. New SeisUP sessions will open in this project.

    projects/Under this directory a session_history file is stored for every SeisUP project the user hasactively worked in. Each session_history file simply stores the location in the flow where theuser last saved the project. Thus, the next time a user goes back into a saved flow the area shouldbe familiar.

    gradients/User defined colormaps created in module IVEP are stored in this directory.

    .SeisUPdisplayStores the customized list of headers used in the Header Dump option accessible from DISPLAYs Tools menu.

    .seisupenvNo use for this file found. Perhaps it is still around for legacy code.

    Copyright 2013, GeoCenter LP. All rights reserved. SeisUP is a registered trademark of GeoCenter LP.

    15

  • LICENSE_INSTALLThis script must be run as root. It allows the SeisUP and SDI CGMLIB licenses to be updated / installed.

    ./license_install

    Respond with one of the following: seisup -- Install SeisUP license lib -- Install CGM creation license quit -- Quitlicense_install

    Only the first letter of each option is required. You will be asked if you have a license ready. If yourespond "NO", information will be output that is needed to generate the license. If you respond "YES",you will be asked for the license.

    Linux systems do not require a separate CGMLIB license.

    16

  • SEISUP_LMGRD_INSTALLInstalls the SeisUP license manager daemon onto a host system. To uninstall seisup_lmgrd from a systempass the --uninstall option to the installer. This is called during installation. The only use of this scriptotherwise is to remove SeisUP.

    seisup_lmgrd_install [--uninstall] [seisup-directory]

    --uninstall - removes seisup_lmgrdseisup-directory - defaults to $QEDTOP

    17

  • CHKDSETThis function checks the data directories for datasets that do not have a corresponding .cleanup file in the$QEDTOP/usr directory. If an "orphan" dataset is found, you will be asked if you want to delete it.

    NOTE If your system has multiple QEDTOPs with independent usr directories, chkdset can reportdatasets without .cleanup files that actually have files in another QEDTOP if you do not check for allQEDTOPs at once.chkdset [altQEDTOP1] [altQEDTOP2] [...]

    altQEDTOPn Additional QEDTOP to check.

    18

  • CHKLINKSUsage: chklinks [ -ufld ] [ QEDTOP= ] [ AREA= ] [ LINE= ] filesystem

    The chklinks script takes the path to a filesystem that contains SeisUP dataset files. For each SeisUPdataset file in the target filesystem, chklinks will go to the area/line directory and check that the .cleanupfor the dataset file references the correct path to the file.

    For example, if you had a GCI dataset named Geom, whose GCId file was located at the path/mnt/seisup_data/Area.Line.Geom.GCId.1 chklinks will report if the file${QEDTOP}/usr/Area/Line/Geom.GCId.cleanup references the dataset file at a different path (say, /export/seisup_data/Area.Line.Geom.GCId.1).

    One scenario that may result in out-of-date .cleanup files is when dataset files are moved from onefilesystem to another, or if you rename a filesystem. In these situation, run chklinks first to generate areport of what .cleanup files require updating, and then use the -u flag to cause chklinks to update the.cleanup files so that they contain the correct path to their dataset file.

    chklinks operates using the value of the QEDTOP environment variable. If QEDTOP is not set, thenchklinks will exit with an error. You may specify an alternate QEDTOP without changing yourenvironment variable using the command line argument QEDTOP=. For example, chklinksQEDTOP=/seisup_alt /mnt/data will check the files in /mnt/data against the .cleanup files for the areas andlines contained in QEDTOP /seisup_alt.

    You may restrict the scope of chklinks to a specific area or line by specifying the command line argumentAREA= and LINE=, respectively. Alternatively, you may set the environment variables QEDAREA orQEDLINE to the area and line you wish to restrict chklinks search to. -u Update links in cleanup files -f Force update without requiring interactive confirmation -l List files for which cleanup files could not be found, if any -d Print formatted output suitable for parsing QEDTOP= Alternate QEDTOP to search for .cleanup files AREA= Area name to restrict scope of chklinks LINE= Line name to restrict scope of chklinks

    NOTE: Punctuation in area, line or dataset names can throw this and several other utilities off. Do NOTuse periods (.) or spaces in any name.

    19

  • CLEANUP_RUN_LOGSCopies .lst files for a project into the same run_logs directory that SeisUP writes run logs to. This programmust be run from the project (line) directory itself.The older versions of SeisUP put the job listings in files named number.lst in the line directory. Thecurrent version puts the listings in the run_logs directory under the line directory as files named job_number.runlog. In both cases number is negative for batch jobs. Having a file name with a leading "-"causes some problems searching the listings.

    NOTE Use of this script will prevent older versions of SeisUP finding the job listings (execution status).The current version first checks the run_logs directory for the job listing and if it does not find one, looksfor a .lst file.

    There is no inverse version of this script.

    20

  • DSET_FILESProduce a list of actual datasets from .cleanup files.

    dset_files

    dset_files

    dset_files

    area - area name

    line - line namedataset - datasettype - type of dataset, i.e. GCId, GCIm, GCIz

    The first version must be run from the directory with the .cleanup file. The last two require the QEDTOPand QSYS environment variables be set and can be run from any directory.

    21

  • DSKINVA somewhat catch all program for disk space reports.

    dskinv

    Available commands:1. end Quit2. help Produce this display3. query Query datasets Produce a summary space utilization output by area. If is specified, individual dataset information is saved to the file, otherwise it is output with the summary information.4. scratch Scratch datasets Delete datasets by area, line and dataset. maxspace Hidden and not very useful parameter List data directories.5. space Show disk space Report free space in the data directories SeisUP can write to.6. files Show actual files for dataset

    Input a command

    The options can be specified on the command line as well as from the prompt. Options can be specified bynumber or name.

    dskinv 5dskinv space

    dskinv 6

    The most used options are space, files and query.

    22

  • DUMP_JOB_CACHEThis program opens the seisupd job cache located at the path specified in the first argument and printsdescriptions of each job contained in the cache.dump_job_cache [-c] cache_file

    -c - prints summary onlycache_file - normally named job_cache

    dump_job_cache -c job_cache 5 jobs in job_cache

    dump_job_cache job_cache JMJobRef (100074b0) = { Owner: qamar:user (uid = 513, gid = 20) Display: atlas.geocenter.lan:0 Exec. Host: godzilla Exec. Name: jobexec Process ID: 510589 State: JMStateExitSuccess SeisUP Dir: /mnt/gz4/seisup-pro Area: Sanchez-Dummy Line: mergemap Flow File: /mnt/gz4/seisup-pro/usr/Sanchez-Dummy/mergemap/flow Run Log: /mnt/gz4/seisup-pro/usr/Sanchez-Dummy/mergemap/run_logs/job_1412.runlog Node ID: 2014 Job ID: 1412 Submit Time: Fri Oct 7 09:05:41 2005 Start Time: Fri Oct 7 09:05:41 2005 End Time: Fri Oct 7 09:06:21 2005}.

    .

    .

    23

  • JM_MULTICAST_MONITORThis function allows the user to watch SeisUP job submissions. The level of detail is greater than the seisupd_log_mon provides.

    24

  • PROJECT_DATAGiven an area name, this script will scan the area directory located in the SeisUP installation for allcleanup files, parse the cleanup files, and return paths to the datasets for the project.project_data [-a archive_file] area_name [line_name]

    -a archive_file All datasets found will be tarred into archive_file.

    25

  • SEISUPD_ADMINSend commands to the SeisUP daemon seisupd.

    seisupd_admin

    seisupd Administration Commands:restart Restart Network Servicesstop Stop Network Servicesstart Start Network Servicesflush Flush Job Queuesreset Reset Job Queueskillall Kill All Jobsshutdown Shutdownssd Scheduled Shutdownquit Quit seisupd_admin

    26

  • SEISUPD_CTLThis is a wrapper script around /[etc|sbin]/init.d/seisupd start/stop/restart. It must be run as root.

    27

  • SEISUPD_INSTALLInstalls the seisupd job server onto a host system.To uninstall seisupd from a system pass the --uninstall option to the installer.

    28

  • SEISUPD_LOG_MONRun a tail -f on the SeisUP job log. A ^C stops the tail.

    29

  • SELECT_PLOTTING_SUBSYSTEMPresents the user with a list of available plotting subsystems. The user makes a selection from this list andthe script will update the necessary links to enable the old_subsys subsystem.

    30

  • SET_HELP_VIEWERSearches the users path for a web browser and adds it to the SeisUP script.

    31

  • TAPEINITSet the reel number for a tape.

    tapeinit reeln unit

    reeln The reel number to set into the tape.unit The unit number where the tape is loaded.

    32

  • TAPESERVThis program is the SeisUP remote tape server. It is a standalone program that runs on remote machines toserve as a remote tape server. See the tape_devices file in $QEDTOP/etc. Field 6 in this file is the path tothe tapeserv executable on the remote machine. If tapeserv is not running on the remote machine SeisUPwill attempt to start it using this path. There are no arguments.

    33

  • CLUSTER_COMMANDThis script allows the same command to be sent to one or more nodes. It assumes the cluster nodes arenamed sequentially like:

    darwin001darwin002 .

    .

    .

    darwin100

    Arguments: 1: cluster node base name 2: starting node number 3: ending node number 4: command to execute

    Example: cluster_command darwin 1 30 "/sbin/shutdown -h now"

    As shown in the example, multiple argument commands should be enclosed in quotes.

    See the node_names script.

    34

  • NODE_NAMESThis minimally useful script takes as its arguments a base node name, a starting node number, and anending node number. From this it will print out formatted node host names.

    node_names darwin 1 5 darwin001 darwin002 darwin003 darwin004 darwin005

    35

  • CLUSTER_DISTThis script will copy a file to a list of cluster nodes using the rsh command. If the cluster is NOT using thecluster.conf file in $QEDTOP/etc to keep local copies of the executables on the node, there is no purposeusing this script.

    For example:

    cluster_dist darwin 1 10 /etc/hosts /etc

    copies the file /etc/hosts into the directory /etc on cluster nodes darwin001 through darwin010.

    Arguments: 1: Base hostname 2: Starting node number 3: Ending node number 4: Local file 5: Remote destination

    An example of a cluster.conf file is:

    InstallPath /opt/seisupRemoteUser cluster

    This cluster has local copies of the executables and a "cluster user" so every user does not have to have anID on each node.

    36

  • CLUSTER_HOST_ENTRIESThis script will create entries for the /etc/hosts file for cluster nodes designated in the commandarguments. The entries are printed to standard output which can be used by the user as he wishes. Thisscript takes the following arguments:

    1: starting IP address 2: cluster node base hostname 3: starting node number 4: ending node number

    For example, consider the following invocation and its output:

    % cluster_host_entries 10.0.0.50 darwin 1 5 10.0.0.51 darwin001 10.0.0.52 darwin002 10.0.0.53 darwin003 10.0.0.54 darwin004 10.0.0.55 darwin005

    37

  • CLUSTER_NODE_ENTRIESThis script will generate and output to stdout host entries for SeisUP cluster node lists. See the$QEDTOP/lib/nodes directory. The output format is as follows:

    basenameXXX sys=QSYS ncpu=NArguments: 1: Base hostname 2: Starting node number 3: Ending node number 4: SeisUP platform identifier (i.e. linux, darwin-ppc) The default is the environmental variable $QSYS. 5: Number of CPUs (2 default)

    38

  • CLUSTER_POWEROFFSends a shutdown command to the specified nodes.

    Arguments: 1: Base hostname 2: Starting node number 3: Ending node number

    39

  • CLUSTER_REBOOTThis script is used to send a reboot command to each of the specified nodes.

    Arguments: 1: Base hostname 2: Starting node number 3: Ending node number

    40

  • DIST_CLUSTER_PROGRAMThis script uses the cluster_dist script and the $QEDTOP/etc/cluster.conf file to send executables to localcopies on cluster nodes.

    Usage: dist_cluster_program program_name cluster_name start_node_num end_node_num

    41

  • RKILL.PLKill a users jobs on a cluster node.rkill.pl [program]

    program If specified, kill this program. Otherwise kill everything owned by user.

    42

  • RUTILCluster maintenance utility.

    This utility allows the user to kill jobs on multiple nodes or remove temporary files on the nodes. Theutility presents selectable node lists.

    Currently no released modules leave temporary files on the cluster nodes. This will change soon.

    43

  • COMPACTThe COMPACT utility compresses a DB file. This function has largely been replaced by the dbucommands copy option which is a bit more tolerant of corrupted DB files.

    compact srcfile dstfile errfile

    srcfile - full path to the DB file to be compresseddstfile - output DB fileerrfile - file for error handling - not human readable

    If the utility completes successfully, move dstfile over srcfile. Delete errfile in any event.

    44

  • CONFIG_SEISUP_SCRIPTYou will probably never need this script. It edits the seisup script to point to another location.

    45

  • CONVFLOW6_7Convert an old version flow file to a new version file. Any flow file created since 1996 should not needthis function.

    convflow6_7

    46

  • DB_DUMPDump the contents of a DB file in hex and ASCII.

    db_dump [ MANUAL | SEQ ]

    MANUAL allows the user to step through the output. SEQ, which dumps everything, is the defaultdb_dump DB MANUALDump Utility for C-Index/II version 4.0D(c) Copyright Trio Systems 1983-1989

    Enter node to dump or H=header, F=fwrd node, R=rev node, P=print, X=exitL=lock file, U=unlock file (Status: Unlocked) HHeader Dump-----------

    Wordorder = 1xRoot = 1225Levels = 4Next Node = 13945Next Rec = 1End of File = 13949Free Nodes = -1Delete Count = 0Record Count = 0Custom Info Len = 0Index Type Codes1: 0 2: 0 3: 0 4: 0 5: 0 6: 0 7: 0 8: 0 9: 0 10: 011: 0 12: 0 13: 0 14: 0 15: 0 16: 0 17: 0 18: 0 19: 0 20: 2

    Enter node to dump or H=header, F=fwrd node, R=rev node, P=print, X=exitL=lock file, U=unlock file (Status: Unlocked)

    47

  • DBUDBU is a database utility program. This should be run in the directory where the database file is located.

    dbu

    Available commands: create Create a database open Open a database close Close current database list [fname] List keys for given index dump [fname] Dump contents of key load load fname contents into key delete [rec] Delete key copy Copy the current database to new_database. NOTE The default database is the global database. help Produce this display end Quit dbu

    : P - PDB; M - MDB; X - MatrixDB; L - ListDB C - CATEGORY; D - Development Category. OR : # - # is a number from 0 - 15.

    Input a command

    The DB file must be opened or created before anything is done to it. The most common use of dbu is tocopy / compress a possibly corrupted DB file to a new file. The new file is then moved over the old DB file.

    48

  • DUMP_FLOWLists all Node Names and Node IDs in a flow file. This must be run in the line directory.

    dump_flow flow

    49

  • DUMP_IDLists the most recently run Node ID, Job ID and Batch Job ID for a flow file.

    dump_id flow

    Node ID: 7Job ID: 1475Batch Job ID: 401

    50

  • GOODBADDatabase file structure check tool.

    goodbad

    goodbad DB Goodbad C-Index/II File Integrity Checker version 4.0D(c) Copyright Trio Systems, 1986-1989

    Testing: DB

    File tests as good.

    This will fail with a message "Error opening file" if the file is in use. Errors in the DB entries are printed out.

    51

  • LOCKUPFor reasons that are seldom clear, the SeisUP flow editor sometimes locks up. The usual suspects listincludes corrupted DB, .ID, .JMlog, .history and JMtable files. If you get a reasonable clue as to how theseget corrupted other than a system crash, please pass it on to GeoCenter so we can address it.

    The .ID, .JMlog and .history files all reside in the line directory; $QEDTOP/usr//. If no onehas the flow open, these files can be deleted safely.

    Suspect DB files can be checked with the goodbad command. Corrupted DB files are treated by using the dbu command to copy the contents to another file. The new file should be moved over the existing DBfile. DB files reside in both the area and line directories. The one in the line directory is generally muchlarger and the most likely one to be corrupted.

    The JMtable file resides in $QEDTOP/jm/. The job server must be stopped to delete this file.

    52

  • REBUILDDatabase rebuild utility. This has largely been replaced by the dbu copy command which is a bit moretolerant of corrupted database files.

    rebuild oldfile newfile errfile

    oldfile - input file - normally named DBnewfile - output fileerrfile - error file - not human readable

    If the utility completes successfully, replace oldfile with newfile. Delete errfile.

    53

  • SEGMENTATION FAULTSegmentation faults and bus errors are related. Both are related to memory overflows. Segmentation faultsoccur when memory is accessed outside of an arrays bounds. A bus error occurs when memory isaccessed outside the jobs work space.The primary suspect in any abort related to a segmentation fault or bus error is a parameter with a defaultof "get from database" and the value is not in the database. What is returned from a query for a missingvalue is a NULL. This translates to a very large number that, if used, will overflow any array.

    Most modules that query the database have override parameters for the values. A few still do not and assuch can not run with an incomplete (or inaccurate) database.

    54

  • BUGREPORTSWhen you have a problem that defies solution, a good bug report can speed the solution up considerably.GeoCenter has an email and web based bug reporting system and. Unfortunately the spammers found the web based system andafter 4000+ (> 10 times the number of actual) bug reports to see if we were interested in Viagra, etc. theweb based system was changed to forbid anonymous entries. This could be changed in the future if we canget the spam filter to work.

    Error messages displayed in the window where SeisUP was started, the relevant parts of the job listing(parameters and error messages) and screen shots of displays can help. Some aborts also create core files.These are normally found in the line directory.

    The care and feeding steps of core files is as follows:

    cd to the directory with the core file.

    file core This will report the executable name. The core file may be named core.[number].

    gdb executable core Gdb is a debugger. An alternative is dbx.

    where This will report the function calling tree at the point of the abort. Capture this tree. quit

    After the call tree is captured, the core file is of no more use and can be deleted. It is generally notpractical to send the core file to GeoCenter.

    55

  • PROGRAMMINGThere are two .pdf files to help with programming your own modules. They are:

    Programmers Manual Reference Manual

    56

  • CAT_UPDATEThis script is a wrapper for catout to update the SeisUP.cat file.

    57

  • CATOUT

    SYNOPSISPrint to stdout a list of modules organized by category along with brief descriptions of each module. Thebuild system makes use of an option to output an alternate format to regenerate the SeisUP module catalog.

    DESCRIPTIONThis script prints a list of modules installed in SeisUP organized by category, with a short descriptionfollowing each modules name. The script discovers which modules are installed in SeisUP by scanningthe contents of $QEDTOP/lib/db/mdb. This directory contains an .mdb file for each installed module,which provides information about the module such as which category it belongs to.

    catout optionally accepts an -f command-line option, which produces an alternate output format. Thisalternate output format is the same format as a module catalog file, which are installed in$QEDTOP/lib/db/cat. The catalog files installed in this directory are scanned by geodraw at startup topopulate the module librarian dialog. The build system relies on this alternate output format capability toregenerate the main SeisUP module catalog: $QEDTOP/lib/db/cat/SeisUP.cat. Whenever a new module isregistered with the system by make db, the build system executes the following command to generate SeisUP.cat:

    $(QEDSRC)/make/bin/catout -f > $(QEDTOP)/lib/db/cat/$(CATALOG).cat

    Prior to the incorporation of this script into the build system the module catalog was opened directly bythe dbu program. dbu read in the catalog and attempted to update it by finding the correct category for themodule being installed, and adding the module name in. However, the program was plagued by bugs suchas category names being left behind after the last module had been removed from the category.

    This script is copied to $QEDTOP/bin/$QSYS/admin by the src/util/scripts Makefile. It is provided as autility to SeisUP users. Included also is a wrapper script for updating the main SeisUP catalog in the sameway that the build system does. This script is also found in $QEDTOP/bin/$QSYS/admin, and is named cat_update. It is simply used to sync up SeisUP.cat with the contents of the mdb directory, which may benecessary when distributing patches to clients.

    NOTES

    The ability of this script to function depends entirely on each modules .mdb file containing the modulecategory name. Before changing the build system to regenerate SeisUP.cat using this script, the categoryname of a module was specified in the modules Makefile under the CATNAME build variable. This is nolonger necessary. At the same time I modified the .mdb file of every module in the system and committedthose changes to CVS. We must ensure that new modules put the category name in the correct place. Themdb syntax checker (chk_mdb_syntax) will look for this and abort if the category is not specified. If thecategory name is not present in the mdb file, then the module will be put in the "OTHER" category.

    58

  • EXEC_DEBUGThis script can be modified to suit the host system to invoke a debugger to run a job executive in. Thisscript is executed by seisupd when a job has the debug flag set.The sole argument to this script is the path to the executable to debug. While the stock script isimplemented as Bourne shell script, you are free to use whatever script interpreter you like.

    59

  • LS_HORIZONSOutput a list of SURFACE matrices for an /. This is used by the parameter display code.

    ls_horizons area line

    60

  • LST_NODESOutput a list of cluster node files from $QEDTOP/lib/nodes. This is used by the parameter files to get acustom list for user selection.

    61

  • MODGENThis script will generate the skeletal C code for a SeisUP queue processing module.

    modgen module_name

    The following files are generated (where "module" is replaced with the name of your module): ex_module.c pp_module.c module.h module.pdb module.mdb Makefile

    You should be able to build the skeletal module into the system using build command make new db install.

    62

  • PLOT_LOGOSOutput a list of logo files from $QEDTOP/lib/logo. This is used by the parameter files to get a custom listfor user selection.

    63

  • PVM_HOSTSOutput a list of host machines available to run PVM jobs on from $QEDTOP/lib/pvmhosts. This is usedby the parameter files to get a custom list for user selection.

    64

  • LST_NODESOutput a list of color files from $QEDTOP/lib/cmaps. This is used by the parameter files to get a customlist for user selection.

    65

  • SeisUP Data ManagerGetting Started The Application Main Window The Menu Bar The Status Bar The Filesystems Manager The Tape Devices Manager The Backup Areas Window The Restore Areas Window Shortcut Keystroke Commands Troubleshooting

    Getting StartedThis application provides a through and organized view of the data known to SeisUP, as well as methodsto delete, archive and restore that data. The Data Manager may be opened from SeisUPs "Tools" menu orfrom the command line. If opened from SeisUP, the Data Manager will display datasets pertaining to thecurrent project.

    The Application Main WindowThe layout of the Data Managers main window should be familiar to many users as it is common to otherpopular file management applications. Along the left side is the directory tree of SeisUPs "usr" directory(see figure 1) and on the right are the contents of any selected subdirectory (see figure 2).

    Figure 1: SeisUPs "usr" Directory Tree.

    The directory tree has only three levels: the root "usr" directory, the "areas" folders in the second level andthe "lines" folders in the third level. To view the datasets located in an entire area click on its folder. Thiswill also cause the directory tree to expand, revealing its line subfolders. To view the datasets located in an

    66

  • single line within an area, click the "directory expander" icon located just left of the area folder icon.Then, click the line folder for which you wish to view the contents. Whenever an area folder is expanded,the database file size residing in its line folders will be shown in the "DB Size" column to the right the linename. To the right of the expanded area folder will be the summation of database sizes in its line folders.

    Figure 2: Datasets Table for the Selected Area Folder.

    The dataset table on the right side of the main window contains four static columns: dataset name, type,area and line, as well as other columns the user added using the Columns option.

    The Menu BarThe Data Manager has four top level menu items: File, View, Dataset and Help...

    The File drop down menu has eight options...

    File -> Manage Data Filesystems... This option will open the Data Filesystems Manager window. From this window the user may tell SeisUPwhich filesystems dataset should be stored to. For more information see the Data Filesystems Managersection of this document.

    File -> Manage Tape Devices... This option will open the Tape Devices Manager window. From this window the user may enterinformation about remote tape devices so they are known to SeisUP. For more information see the TapeDevices Manager section of this document.

    File -> Backup Selected Areas... This option will open the Backup Areas window. From this window the user can create a tar archive of theselected area folders. For more information see the Backup Areas section of this document.

    File -> Restore Areas... This option will open the Restore Areas window. From the window the user can restore an archive createdfrom the Backup Areas window. For more information see the Restore Areas section of this document.

    67