CNAME = LITERAL (Read)
The name of
component (residing within the extension) to be examined or modified. It is only accessed
when OPTION="Erase", "Get", "Put", or "Rename".
CTYPE = LITERAL (Read)
The type of
component (residing within the extension) to be created. Allowed values are "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,
"_CHAR32"
is a 32-character component. "LITERAL" and "_CHAR" generate 80-character components.
CTYPE is only accessed when OPTION="Put".
CVALUE = LITERAL (Read)
The value(s) for
the component. Each value is converted to the appropriate data type for the component.
CVALUE is only accessed when OPTION="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.
LOOP = _LOGICAL (Read)
LOOP=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]
NDF = NDF (Update)
The NDF to modify or examine.
NEWNAME = LITERAL
(Read)
The new name of a renamed extension component. It is only accessed
when OPTION="Rename".
OK = _LOGICAL (Read)
This parameter is used to seek
confirmation before a component is erased or overwritten. A TRUE value permits the
operation. A FALSE value leaves the existing component unchanged. This parameter is
ignored when LOOP=FALSE.
OPTION = LITERAL (Read)
The operation to perform
on the extension or a component therein. The recognised options are listed
below.
"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.
SHAPE( ) = _INTEGER (Read)
The shape of the component. Thus 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".
XNAME
= LITERAL (Read)
The name of the extension to modify.
XTYPE = LITERAL
(Read)
The type of the extension to create. The suggested default is the
current value or "EXT" when there is no current value.