Viewing Registry

The NameExt is an OS/2 command-line utility program that is used to display the contents of nodes in the OS/2 name space. The Open32 registry is part of the OS/2 name space. It resides under the node path DOS/WINOS2/WINREG.

By default, the information generated by this utility program is written to the terminal (STDOUT); however, the user can use the "-f" parameter to write the output to a file. NameExt has the flexibility to provide information to a single node (the default or -1 0), for all nodes at or below the specified node (-1 *), or to limit the depth in the name space. The user has even finer control in being able to select only nodes that satisfy a specific set of search criteria (the "-s" parameter). Finally, the user can:

Retrieve all information for a node (the default)
Retrieve only the metadata for a node (the "-m" parameter)
Include or exclude a list of attributes (the "-i" and "-x" parameters)

Character strings will be output in display format if they contain all printable characters; otherwise they will be output in character-based hex format.

Syntax:

┌──────────────────────────────────────────────────────────────────────────────┐│                                                                              │
│ >>──NameExt──path──┬────────────────────────┬──────────────────────────────> │
│                    └─-s ─┤ search_filter ├──┘                                │
│                                                                              │
│                                     (3)                                      │
│ >──┬──────────────────────────┬──-m ─────┬────────────────┬────────────────> │
│    │     ┌─,───────────────┐  │          └─-f output_file─┘                  │
│    │                      │  │                                              │
│    │                    (1)   │                                              │
│    ├─-i ──attribute_name──────┤                                              │
│    │     ┌─,───────────────┐  │                                              │
│    │                      │  │                                              │
│    │                    (2)   │                                              │
│    └─-x ──attribute_name──────┘                                              │
│                                                                              │
│    ┌─-l 0 ────────────────┐                                                  │
│ >──┼──────────────────────┼───────────────────────────────────────────────>< │
│    ├─-l levels_to_extract─┤                                                  │
│    └─-l *─────────────────┘                                                  │
│                                                                              │
│ SEARCH_FILTER:                                                               │
│    ┌─┤ logical_operator ├─┐                                                  │
│     │                  │ │                                                  │
│ ├────┤ filter ├─────────┴─┴────────────────────────────────────────────────┤ │
│                                                                              │
│ LOGICAL_OPERATOR:                                                            │
│ ├──┬─AND─┬─────────────────────────────────────────────────────────────────┤ │
│    ├─OR──┤                                                                   │
│    └─XOR─┘                                                                   │
│                                                                              │
│ FILTER:                                                                      │
│ ├──┬─attribute_name─┬─EQ─┬──┤ value_expression ├──┬────────────────────────┤ │
│    │                ├─NE─┤                        │                          │
│    │                ├─GT─┤                        │                          │
│    │                ├─GE─┤                        │                          │
│    │                ├─LT─┤                        │                          │
│    │                └─LE─┘                        │                          │
│    │                       (4)                    │                          │
│    ├─EXISTS(attribute_name)───────────────────────┤                          │
│    │                               (5)            │                          │
│    ├─RSTR(attribute_name) EQ string───────────────┤                          │
│    │                               (6)            │                          │
│    ├─LSTR(attribute_name) EQ string───────────────┤                          │
│    │                                 (7)          │                          │
│    ├─MIDSTR(attribute_name) EQ string─────────────┤                          │
│    ├─(─┤ filter ├─)───────────────────────────────┤                          │
│    └─NOT(─┤ filter ├─)────────────────────────────┘                          │
│                                                                              │
│ VALUE_EXPRESSION:                                                            │
│ ├──┬─([system_type─┬────────────┬─]value)───────┬──────────────────────────┤ │
│    │               └─:user_type─┘               │                            │
│    │                                  ┌─,───┐   │                            │
│    │                                       │   │                            │
│    ├─([system_type[]─┬────────────┬─]──value┴─)─┤                            │
│    │                 └─:user_type─┘             │                            │
│    ├─quoted_character_string────────────────────┤                            │
│    │   ┌─,──────────────┐                       │                            │
│    │                   │                       │                            │
│    └─{──value_expression┴─}─────────────────────┘                            │
│                                                                              │
│ NOTES:                                                                       │
│ (1)  This form specifies that the list of attributes that follows should be  │
│      included in the extract.                                                │
│                                                                              │
│ (2)  This form specifies that the list of attributes that follows should be  │
│      excluded from the extract.                                              │
│                                                                              │
│ (3)  This form specifies that the extract contains only the metadata and the │
│      path name.                                                              │
│                                                                              │
│ (4)  This expression is true if the attribute exists and has any value or no │
│      value.                                                                  │
│                                                                              │
│ (5)  This expression is true if the right-most portion of attribute_name's   │
│      value equals the string.                                                │
│                                                                              │
│ (6)  This expression is true if the left-most portion of attribute_name's    │
│      value equals the string.                                                │
│                                                                              │
│ (7)  This expression is true if the string appears anywhere in               │
│      attribute_name's value.                                                 │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

Parameters:

path

Name space to be displayed -s

Flag used to specify that you want to extract nodes which satisfy a certain set of search criteria. search_filter

The search criteria used to extract nodes. -i

Flag used to specify that you want to provide a list of attributes to be included in the extract. -x

Flag used to specify that you want to provide a list of attributes to be excluded from the extract. attribute_name

The name of the attribute to be extracted. -m

Flag used to specify that you want only the metadata for a node extracted. -f

Sends the results to an output file that you specify. output_file

A user-specified file to which the extracted data is sent. -l

Flag used to specify the number of levels deep (relative to the path) in the name space to extract. *

Flag used to specify that you want all the nodes at or below a specified node. 0

Provides information for the node specified by the path. levels_to_extract

Limits the depth of a name space. logical_operator

Allowable logical operators are AND, OR, and XOR. value_expression

A value given to an expression. EXISTS(attribute_name)

This expression is true if the attribute exists, and has any or no value. RSTR(attribute_name) EQ string

This expression is true if the right-most portion of attribute_name's value equals the string. LSTR(attribute_name) EQ string

This expression is true is the left-most portion of attribute_name's value equals the string. MIDSTR(attribute_name) EQ string

This expression is true if the string appears anywhere in attribute_name's value. system_type

BOOLEAN
CHAR
UCHAR
UNICHAR
INT8
UINT8
INT16
UNIT16
INT32
UINT32
BYTE
PORT

User-defined attribute types.

Any value appropriate for the system type.

One-dimensional array of characters, enclosed in quotes.

Return Codes:

OK. The command ran successfully. 4
8
12
There are currently no warnings (return codes of 4) issued by the utilities. A warning return code is included only for completeness. The error will be further identified by messages that are issued by the commands when errors are detected.
Example:
The following example displays the contents of the entire Open32 registry.
```
nameext dos\winos2\winreg -l *
```
[Back: Adding an Application INI File to Registry]
[Next: Restoring Registry]