Manipulates the contents of a specified NDF extension
The task may operate in one of two modes, according to the LOOP parameter.
When LOOP=FALSE
only a single option is executed at a time, making the task
suitable for use from an ICL procedure. When LOOP=TRUE
several options
may be executed at once, making it easier to modify several extension
components interactively in one go.
"Erase"
, "Get"
, "Put"
, or "Rename"
. "LITERAL"
,
"_LOGICAL"
, "_DOUBLE"
, "_REAL"
, "_INTEGER"
, "_CHAR"
, "_BYTE"
, "_UBYTE"
, "_UWORD"
, "_WORD"
.
The length of the character type may be defined by appending the length, for example,
"_CHAR∗32"
is a 32-character component. "LITERAL"
and "_CHAR"
generate 80-character components.
CTYPE is only accessed when OPTION="Put"
. "Put"
. Note that for an array of values the list
must be enclosed in brackets, even in response to a prompt. For convenience,
if LOOP=TRUE
, you are prompted for each string. FALSE
requests that only one operation be performed. This allows batch and
non-interactive processing or use in procedures. LOOP=TRUE
makes SETEXT operate in a
looping mode that allows several modifications and/or examinations to be made to
the NDF for one activation. Setting OPTION to "Exit"
will end the looping.
[TRUE]
"Rename"
. TRUE
value permits the
operation. A FALSE
value leaves the existing component unchanged. This parameter is
ignored when LOOP=FALSE
.
"Delete" | –- Delete an existing NDF extension. |
---|---|
"Erase" | –- Erase a component within an NDF extension |
"Exit" | –- Exit from the task (when LOOP=TRUE )
|
"Get" | –- Display the value of a component within an NDF extension. The component must exist. |
"Put" | –- Change the value of a component within an NDF extension or create a new component. |
"Rename" | –- Renames a component. The component must exist. |
"Select" ] –- Selects another extension. If the extension does not exist a new
one is created. This option is not allowed when LOOP=FALSE . |
The suggested default is the current value, except for the first option where there is no default.
3,2
would
be a two-dimensional object with three elements along each of two lines. 0
creates a
scalar. The suggested default is the shape of the object if it already exists,
otherwise it is the current value. It is only accessed when OPTION="Put"
. "EXT"
when there is no current value. "B"
to the FILTER
component of the CCDPACK extension a the NDF called abc. The "Put"
option allows the creation of extension components with any of the primitive
data types.
The task creates the extension automatically if it does not exist and only allows one extension to be modified at a time.