CC) Details concerning the DESL
stack command.The DESL "stack" command provides the capability to the user to append existing SIF file(s) onto a single new SIF file. If a list of variable names is specified via the "names" option then this specified list of variables retaining the names which are actually on the SIF file being processed WILL be the names record of the new file being produced. The default condition (without "names" specified) is for the new file to contain everything on the files being stacked but without superfluous NAMEs records.
Any names enclosed in brackets are required or are in a set of options, one of which must be specified. Any non-blinking names enclosed in brackets are optional or are in a set of options, only one of which can be specified.
In cases where the option name is one of a set each different set number is indicated by a red numeric set number superscript trailing the respectiveright bracket :
CCaltvars)
(Command :stack) Details for the altvars option. CCbackward)
(Command :stack) Details for the backward option. CCconstant)
(Command :stack) Details for the constant option.Allows the user to add constant names/values, indicated in the above by pairs of "name" and "value", to the new file being produced by the current stack operation. Up to 200 constant name-value pairs can be specified.
Example : constant flap1 15 slat2 2.5
CCcset)
(Command :stack) Details for the cset option.
The item immediately following "cset" is the file sequence number in the "files" list for which the following up-to-20 conditions will be applicable.
Each file-specific 3-item condition, like its global 3-item condition counterpart, is made up of (1) a SIF variable name, (2) a 2-character logical conjunction, and (3) a second SIF variable name or a constant.
Example : cset 3 alpha gt phi mach lt 1.2
Here, the user has indicated that, along with whatever
other GLOBAL conditions may have been specified, the
pertinent DESL function, for the THIRD file specified
or implied by the "files" list, will have its application
ALSO limited to records which satisfy BOTH of the two
conditions :
All file-specific conditions are implicitly joined by
an "and" conjunction; ie, by default, all file-specific
conditions would have to be true SIMULTANEOUSLY for
the applicable record to be retained.
If one or more file-specific conditions following
the file sequence number is to be connected to other
file-specific conditions for the same file number by
an "or" conjunction, then the 2-character item "or"
must immediately follow the file number.
Example : cset 2 or alpha lt 0 alpha gt 4
Here, the user has indicated that, along with whatever
other GLOBAL conditions may have been specified, the
pertinent DESL function, for the SECOND file specified
or implied by the "files" list, will have its application
ALSO limited to records in which the value of the SIF
variable "alpha" satisfies at least ONE of the conditions :
Additionally, if the file number following the "cset"
option is negative, the absolute value of this negative
file number is used for the actual file number and the
associated "and" or "or" condition(s) are NOT used in the
traditional sense of filtering the records read but
are ONLY used to indicate when READING of the associated
file is to STOP. This ability is useful in preventing
the reading of a long file when it is known that the
data required is relatively near the beginning of the
file.
Example : cset -1 or run eq 3 alpha gt 24
Here, the user has indicated that when a record is
encountered for which either or both of the two conditions
is/are TRUE, reading of the current SIF file should end.
CCeqtol)
(Command :stack) Details for the eqtol option.Example : eqtol .5
CCfiles)
(Command :stack) Details for the files option.
This list of files can be implicitly extended via use of the <list argument which can appear among the specified file names. If one or more of the <list-type arguments are specified, where "list" is a currently defined file name list, the file names contained in the indicated file name list(s) will be included, at their respective point(s) of encounter, in the current file list. The referenced list(s) must have been produced by the "newfiles" and/or "newfilex" argument lists associated with one or more previously executed DESL commands. Each "list" name can be up to 15 characters long. File names can also include the {...} construct. This type specification within a file name implies that the list name given between the curly brackets ( {} ), is to be used to have each of its elements substituted in turn for the { ... }, inclusively, such that an implicit lengthening of the file list is accomplished, up to the maximum number of files allowed. Any time such a {...} usage occurs, all lists mentioned must exist; i.e., must have been previously defined in the current DESL session. Only one {...} construct can be included in a file name. Including more than one such construct will result in unpredictable results.
An example of this type of file name specification is the following :
t43r{runs}.sif
Here, the list "runs" will have its elements used, in turn, in place of the {runs} substring.
| . |
(Begin modifications on 052102)
Each file name, whether it includes the {...} or not,
can be a maximum of 256 characters long.
If a file name is more than 16 characters long it
must be enclosed in question marks (?) .
(End modifications on 052102) |
Up to 500 files can be explicitly or implicitly specified.
Example : files x10 thru x18 <fxlist5
CCincrfile)
(Command :stack) Details for the incrfile option.Allows the user to add new names/values to the new file being produced by the current stack operation. The variable names, indicated by "name" above, will have associated values which begin with "value1" for the first existing file being stacked and increase by "value2" for every existing file being stacked thereafter. Up to 200 "incrfile" sets can be specified.
Example : incrfile newrun 1 1
CCincrrec)
(Command :stack) Details for the incrrec option.Allows the user to add new names/values to the new file being produced by the current stack operation. The variable names, indicated by "name" above, will have associated values which begin with "value1" for the first record in each existing file being stacked and will increment by "value2" for each record stacked. Up to 200 "incrrec" sets can be specified.
Example : incrrec newpoint 1 1 seq 10 10
CCnames)
(Command :stack) Details for the names option.Example : names run mach alpha beta cl
CCnewfiles)
(Command :stack) Details for the newfiles option.
The name of the new file actually produced can be saved via the use of the ">list"- or ">>list"-type argument, which can appear along with the specified new file name. If a ">list"- or ">>list"-type argument is specified, where "list" is the specified file name list, the name of the new file which DESL actually produces during the execution of the current command will be saved in the specified file name list.
This file name list can later be referenced by the "files"/"xfiles" options to imply the file name contained therein. If the ">list" argument is specified the named list will be created if it does not already exist, or will overwrite a like-named list if one exists. If the ">>list" argument is specified the named list will be appended to if it exists or will be created if it does not exist. All file name lists are in existence for the current DESL session only. Each "list" name can be up to 15 characters long.
In all but a few noted cases, it is acceptable to use the ">list" or ">>list"-type argument without specifying a full complement of actual new file names. Any new file produced whose NAME is GENERATED by DESL is ALWAYS marked as a file to "PURGE at cleanup".
A suffix which may be in effect as established via the filesuffix DESL command will be added to any expressed or implied new file name.
| . |
(Begin modifications on 052102)
The new file name, whether it includes the {...} or
not can be a maximum of 256 characters long.
If a newfile name is more than 16 characters long
it must be enclosed in question marks (?).
(End modifications on 052102) |
Example : newfiles new1 thru new10 >stlist3
CCnewfilex)
(Command :stack) Details for the newfilex option.Example : newfilex new1 thru new10
CCnoappend)
(Command :stack) Details for the noappend option.The default situation is to, in effect, concatenate all mentioned SIF files, regardless of the "widths" of such files; ie, the resulting SIF file will not necessarily have all of the same variables defined in all records. To the "base" of variables set established, whether the "noappend" option is specified or not, is added any new "nominal" variables actually found in the corresponding ORIGINAL sif names record(s) as the files to stack are processed.
CCnominal)
(Command :stack) Details for the nominal option.As each SIF file is processed the values assigned to new each nominal variable will be that "new nominal value", as defined in (1) above, which falls between the lower and upper ranges of values, as defined in (2) and (3) above, which contains the values of the SECOND SIF variable in the records of the SIF file being processed. If there is no match between the file's value and any specified range the nominal-value variable will be assigned the "setval" value.
Example : nominal newmach mach .2 .19 .21
CCnoop)
(Command :stack) Details for the noop option. CCpathfile)
(Command :stack) Details for the pathfile option.
An example of such a file is the following :
* * Example path file for test xxx * * item 1 = path to be translated : MUST * match VERBATIM with name given * specified/implied via "paths" * * item 2 = resulting name translation * data56 ? \usr\home2\ people\test56\ ? up ?..\? way-up ? ..\..\..\ Temp46\?
Example : pathfile pathA
CCpaths)
(Command :stack) Details for the paths option.Example : paths ..\ ..\Main\ sub1\
CCsetval)
(Command :stack) Details for the setval option.Example : setval 7000
DESL Manager at ViGYAN, Inc.
30 Research Drive
Hampton, VA 23666
Voice: (757) 865-1400
Toll Free: (800) 288-3998
FAX: (757) 865-8177
