4 - MODE OPTIONS
Mode options modify the behavior of Action options. Mode options are all optional, and no values follow a Mode option.
Mode Option -AW (-AnyWhere) :
works with Info option -BP (-BatchProcess) to use an empty work directory, so that the recorded dsrqst command can be started anywhere other than the directory where it was originally recorded.
Mode Option -BG (-BackGround) (Alias: -b) :
background process. When present, screen display is turned off for both standard output and standard error.
Mode Option -CS (-CheckStatus) (Aliases: -CheckReqeustStatus, -CheckParitionStatus) :
checks and displays more detailed status information for each request. To show process progress as a percentage, the fields dsrqst.fcount and dsrqst.size_request must not be empty, and wfrqst.status must be set to ‘O’ for each finished data file record.
Mode Option -FI (-ForceInterrrupt) :
forcibly interrupts a request that is still being built; without it, a warning message is displayed instead.
Mode Option -FO (-FormatOutput) :
formats column output for get actions. The same width, evaluated dynamically, is applied to all values of a given field.
Mode Option -FP (-ForcePurge) :
purges a request that is not yet due. This Mode option is also used with Action -DL together with Mode option -UD (-UnusedData) or -UR (-UnusedRequest) to physically remove 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 the request control index is given as 0 when Action -SC (-SetControl) is executed. This guards against accidentally adding request control records.
Mode Option -NE (-NoEmail) :
does not send an email notice to the specialist after an update.
Mode Option -NO (-NotOnline) :
does not publish the file list after an update and sets the request status to N. No normal email is sent because the data are not online, but error messages, if any, are still sent to the specialist. Add Mode option -NE as well to suppress all email under any circumstances.
EXAMPLE 8. Rebuild request 27208 (which is not in status Q) without sending email or publishing a file list:
Mode Option -NP (-NewPartition) :
: new partitions can only be added for a given request index when this Mode option is present and Action -SP (-SetPartition) is executed.
Mode Option -NR (-NewRequest) :
: a new request can only be added when this Mode option is present and the request index is given as 0 when Action -SR (-SetRequest) is executed. This guards against accidentally adding request records.
Mode Option -RO (-ResetOrder) (Alias: -Reorder) :
(Alias: -Reorder) resets the display order of the data files in a request to match the order in which the data file records are given for Action -SF (-SetFile). The display order can also be set explicitly by providing display-order index values via Info option -DO (-DisplayOrder).
Mode Option -UD (-UnusedData) :
with Action -DL (-Delete), checks and removes unused data under data/dNNNNNN. Files are only physically removed when Mode option -FP is also present.
Mode Option -UF (-UnstagedFile) :
with Action -DL (-Delete), checks and resets the request file status for files that are not on disk.
Mode Option -UR (-UnusedRequest) :
with Action -DL (-Delete), checks and removes request directories that are still on disk but no longer in GDEXDB. Directories are only physically removed when Mode option -FP is also present.
Mode Option -WD (-WithDataset) :
gets the dataset ID for Actions -GF (-GetFile) and -GT (-GetTarFile).
Mode Option -WE (-WithEmail) :
forces an email to the requester after the file list has been republished successfully for a request. Works with Action -RP (-ResetPurge|RePublish).