3.3.3 - Build Local Files

      Action Option -BL (-BuildLocal) (Aliass: -BuildLocalfile) :

      an action to validate/convert remote files and build up local files.

      dsupdt[[-(DS|dataset)] dsnnn.n] -(BL|BuildLocal) [Mode Options]
        [-(CI|ControlIndex) UpdateControlIndex]
        [-(LI|LocalIndex) LocalFileIndices]
        [-(LF|LocalFile) LocalFileNames]
        [-(XO|ExecOrder) ExecOrderIndex]
        [-(RF|RemoteFile) RemoteFileNames]
        [-(BC|BuildCommand) CommandBuildLocalFile]
        [-(ED|EndDate) NextDataEndDate]
        [-(EH|EndHour) NextDataEndHour]
        [-(GP|GenericPattern) GenericPatterns]
        [-(WD|WorkDir) WorkingDirectory]
        [-(FQ|Frequency) UpdateFrequency]
        [-(CD|CurrentDate) CurrentDate]
        [-(CH|CurrentHour) CurrentHour]
        [-(VS|ValidSize) MinSizeForValidFile]
        [-(PL|ProcessLimit) MaxNumberOfChildProcesses]
        [-(SB|SbatchOptions) SlurmBatchOptions]
        [-(QS|QsubOptions) PBSBatchOptions]
        [-(BP|BatchProcess) [BatchProcessHosts]]
        [-(CC|CarbonCopy) Cc'dEmailAddresses]
        [-(DB|Debug) DebugModeInfo]

      Mode option that can be specified for building local file Action:

      The additional routines of data validation and conversion for the remote files are called by this action if the routines are provided. Nothing is done by this action if the local files are simply the same as the remote files. Utilities of compress/uncompress and tar/untar are used to convert remote files to local files as one to one, multiple to one, or one to multiple. Local files are the files in their final states ready to be archived.

      If a local file is on the local disk already, the build local file action for this local file is skipped; the existing local file must removed manually if rebuild is needed.



      Back to Top
      -(BG|BackGround)background process to turn off screen display for both
      -(CP|CurrentPeriod)allows action of the end date/hour beyond the current
      -(EE-ErrorEmail)sends email only when error happens during building
      -(FU|ForceUpdate)if present, force build at lease for one end data/time,
      -(GZ|GMTZone)uses GMT dates/times as controlling times
      -(HU|HourlyUpdate)forces update of time to hours after successful action
      -(IE|IgnoreError)works with Mode option -MU (-MultipleUpdate) to skip
      -(KR|KeepRemote)keep remote file on local disk by copying it to local
      -(LO|LogOn)turn detail logging on if option -PL is present
      -(MO|MissedOnly)build local file only if it is not archived yet
      -(MU|MultipleUpdate)allows building multiple local files if multiple data
      -(NE|NoEmail)does not send email to the specialist after build
      -(NY|NoLeapYear)skips February 29 for leap years
      -(QE|QuitError)quits building local files of a dataset when an
      -(UB|UseBeginTime)when present, use the beginning time of update period
      -(UB|UseBeginTime)when present, use the beginning time of update period for replace temporal pattern of end time in file names and download commands