5.1 - Single-Value Info Options

      A single-value Info option is used to pass one value into this application. One value, and one only, must follow a single-value option; otherwise an error message is displayed if no value or more than one value passed in.

      Info Option -BP (-BatchProcess) (Aliass: -d, -DelayedMode) :

      delayed mode execution. When it presents, the 'dsupdt' command is not executed right way, but the command information is recorded into RDADB instead and the command is executed later by the centralized daemon 'dscheck'. One or multiple host names can be specified after option -BP to force the 'dsupdt' command be executed on or not on the hosts. For examples, '-d rda-work' to run on host 'rda-work'; and '-d !rda-work' to run on all configured hosts other than 'rda-work'. A upper limit for number of tries can also be passed in with this options, 1 to 99, as '-d 2' for example. It default to 1 for cammand of 'dsupdt' if not specified.

      Info Option -CD (-CurrentDate) :

      provides a current date for update actions when a date is used other than today. This option provides opportunity for specialists to rerun a update for re-archiving or a deleted update action.

      Info Option -CH (-CurrentHour) :

      provides a current hour for update actions when an hour is used other than the executing hour. This option provides opportunity for specialists to rerun a update for re-archiving or a deleted update action.

      Info Option -DS (-Dataset) (Aliass: -Dsid, -DatasetID) :

      for a dataset number, or called dataset name or dataset name.

      Info Option -DV (-Divider) (Aliass: -Delimiter, -Separator) :

      delimiter for separating columns of multi-value Info options in input files. It is default to '<:>'.

      Info Option -ES (-EqualSign) :

      for an equal sign of assigning one value to either a single-value option or multi-value option in input files. It is defaulted to '<=>'.

      Info Option -FN (-FieldNames) :

      for a string of single letter field names. Values of the selected fields are retrieved per actions -GL (-GetLocalFile) and -GR (-GetRemoteFile). Values of default fields are retrieved if this option is not specified. Valid field names are listed in corresponding action sections.

      Info Option -LN (-LoginName) :

      login name of the current user; it defaults to the current login DSS specialist who starts execution of 'dsupdt'. Set this option if you try to run this utility for a specialist other than yourself. Mode option -MD is added to execute 'dsarch' if a login name provided by option -LN is different than the one who starts 'dsupdt'.

      Info Option -OF (-OutputFile) :

      leading an output file name into which the output result of this application is dumped. Output file format is similar to the format of the input files. If this option is not given, the result is displayed on screen.

      Info Option -ON (-OrderNames) :

      for a string of single letter field names use to order the results of GET actions, -GC (-GETControl), -GL (-GetLocalFile) or -GR (-GetRemoteFile). Uppercase is for Ascending order while lowercase is for Descending order.

      Info Option -PL (-ProcessLimit) :

      defaults to 1. If present with a value larger than 1, the update actions of 'dsupdt' forks multiple child processes to process one update record in each child process. The master program quits when all available update records are handled in child processes. This helps data update for datasets with many time consuming independent update records.

      Info Option -AO (-ActOption) :

      for setting Action and Mode options in input files. It is default to ''.

      Info Option -VS (-ValidSize) :

      a minimal size for a file to be valid for archiving process. It defaults to 100 bytes and can be reset on command line with the update actions.



      Back to Top