4 - MODE OPTIONS

      Use proper Mode options to modify behaviors of Action options. Mode options are all optional. No value is allowed to be passed in following any Mode option.

      Mode Option -AW (-AnyWhere) :

      works with Info option -BP (-BatchProcess) to use empty work directory so that the recorded "dsrqst' command can be started processing anywhere other than the directory where the command was recorded initially.

      Mode Option -BG (-BackGround) (Aliass: -b) :

      background process. When it presents screen display is turned off for both standard outputs and errors.

      Mode Option -CS (-CheckStatus) (Aliass: -CheckReqeustStatus, -CheckParitionStatus) :

      if present, checks and displays more detailed status information of each request. To show process progress in percentage, fields dsrqst.fcount or dsrqst.size_request must not be empty, and wfrqst.status must be set to 'O' for echo finished data file record.

      Mode Option -FI (-ForceInterrrupt) :

      if present, force interrupts a request that is still under building; otherwise a warning message will display.

      Mode Option -FO (-FormatOutput) :

      if present, formats column output results for get actions. A same width, evaluated dynamically, is applied for all values of a given field.

      Mode Option -FP (-ForcePurge) :

      if present, purges a request that is not due yet. This Mode option is also used for Action -DL with either Mode options -UD (-UnusedData) or -UR (-UnusedRequest) to clean the unused data files or request directories.

      Mode Option -MD (-MyDataset) :

      allows a specialist to add, modify or delete request control records, request partition records, request records and data file records for a dataset owned by another specialist.

      Mode Option -NC (-NewControl) :

      a new request control can only be added when this Mode option is present and request control index is given as 0 when Action -SC (-SetControl) of 'dsrqst' is executed. This Mode option blocks mistakes of adding request control records unintentionally.

      Mode Option -NE (-NoEmail) :

      does not send email notice to the specialist after update

      Mode Option -NO (-NotOnline) :

      does not publish filelist after update and set the request status to N. No normal email is send either since the data are not ready online, but error message, if any, is still sent to specialist. Add Mode option -NE too if no email is wanted fo any situation.


      EXAMPLE 8.

      Rebuild Request 27208 That Is Not In Status Q And No Email Needs To be sent and no filelist needs to be published

      dsrqstBR -RI 27208 -RS Q -NE -NO

      Mode Option -NP (-NewPartition) :

      new partitions can only be added for a given request index when this Mode option is present when Action -SP (-SetPartition) of 'dsrqst' is executed.

      Mode Option -NR (-NewRequest) :

      a new request can only be added when this Mode option is present and request index is given as 0 when Action -SR (-SetRequest) of 'dsrqst' is executed. This Mode option blocks mistakes of adding request records unintentionally.

      Mode Option -RO (-ResetOrder) (Aliass: -Reorder) :

      when present, resets the display orders of the data file lists of a request as the order data file records are given for actions -SF (-SetFile). Another way of reordering the data files is to provide explicitly display order index values per Info option -DO (-DisplayOrder).

      Mode Option -UD (-UnusedData) :

      checks and removes unused data under data/dsnnn.n with action -DL (-Delete). Only physically removing if Mode option -FP is present.

      Mode Option -UF (-UnstagedFile) :

      checks and reset request file status for files are not on disk with action -DL (-Delete).

      Mode Option -UR (-UnusedRequest) :

      with action -DL (-Delete), checks and removes request directory that still on disk but not in RDADB any more. Only physically removing if Mode option -FP is present.

      Mode Option -WD (-WithDataset) :

      get the dataset ID for Actions -GF (-GetFile) and -GT (-GetTarFile).

      Mode Option -WE (-WithEmail) :

      forces to send email to requester after the a filelist being republished successfully for a request. It works with Action -RP (-ResetPurge|RePublish).



      Back to Top