Object Specification - Natural Library Objects

#### Search Results

Search

# Object Specification - Natural Library Objects

This section describes the options provided in the object-specification windows for processing Natural library objects.

Natural library objects are programming objects (including Natural DDMs), user-defined error messages and shared resources.

For descriptions of keywords and valid input values, see also select-clause in the section Direct Commands.

This section covers the following topics:

- Natural Library Objects

- Natural Library Object Details

- Natural Library Object Properties

- Natural Library Object Exceptions

- Natural Library Object Exception Properties

## Natural Library Objects

The specification window for Natural library objects provides the following items:

Item | Explanation
--- | ---
Library | The name of a library or a range of names: see Name in Name, Date and Time Specification. To choose a name from a selection list of all libraries available, open the drop-down list box.
DBID | Only applies to the unload function. The database ID of the system file where the Natural libraries are stored.
FNR | Only applies to the unload function. The file number of the system file where the Natural libraries are stored. If no values (or `0`) are specified for DBID and FNR, the current FUSER or FNAT system file is used.
Password | Only applies to the unload function if executed in remote environments located on z/OS. The Adabas password of the system file where the Natural libraries are stored.
Cipher key | Only applies to the unload function if executed in remote environments located on z/OS. The Adabas cipher code of the system file where the Natural libraries are stored.
Name | The name of a Natural programming object or shared resource or a range of names: see Name. The default is an asterisk (*), which selects all objects available. Only evaluated if the check boxes Natural programming objects and/or Shared resources are selected in the details window, which is the default. See also Natural Library Object Details.
Message from/to | A valid range (1 - 9999) of user-defined error messages delimited by the first and the last message number. Only evaluated if the Error messages check box is selected in the details window, which is the default. See also Natural Library Object Details.
Details | Invokes an additional window where you can enter more detailed object specifications: see Natural Library Object Details.
Settings | Only applies to functions executed in advanced-user mode. Invokes the Settings window where you can specify option and parameter settings: see the section Settings.
Unload file or Load file or Scan file (Server) | Only applies to functions executed in advanced-user mode. The name of the work file to be used for the function. See also the section Work Files.
Browse | Only applies to functions executed in advanced-user mode. Invokes the browse function to select a work file from a directory.

## Natural Library Object Details

The details window for Natural library objects is used to specify further selection criteria for Natural library objects.

For descriptions of keywords and valid input values, see also select-clause in the section Direct Commands.

The details window for Natural library objects provides the following items:

Item | Explanation
--- | ---
Library | The name of a library or a range of names: see Name in Name, Date and Time Specification. To choose a name from a selection list of all libraries available, open the drop-down list box. Ranges are not allowed if the Predict set option is selected.
DBID | See DBID in Natural Library Objects above.
FNR | See FNR in Natural Library Objects above.
Password | See Password in Natural Library Objects above.
Cipher key | See Cipher key in Natural Library Objects above.
Natural programming objects | Natural programming objects. Natural DDMs (data definition modules): In remote environments located on z/OS, DDMs are located in the FDIC system file. They are not considered Natural library objects. In other system environments, DDMs are considered Natural programming objects, which are stored in Natural libraries. If the FDDM system file has been activated, see also Use FDDM file for processing DDMs in Settings - Options.
Error messages | User-defined error messages.
Shared resources | Any non-Natural file that is used in a Natural environment and is maintained in the Natural library system. Note that shared resources are not defined in remote environments located on z/OS systems.
Name | See Name in Natural Library Objects above.
S/C-Kind | The kind of Natural programming object:
Src | Source objects only.
Gp | Generated programs (cataloged objects) only.
Any | All source and/or cataloged objects (generated programs). This is the default.
Stowed | All STOWed objects: source and cataloged objects with identical date and time.
Both | Both source and cataloged objects if both exist.
Note Stowed and Both are valid for the unload function only.
Predict set | Only applies to the unload and find functions and if Predict is installed. This option is used to read the names of the objects to be processed from a retained set. A retained set is created with the save set option of the `LIST XREF` command. If the Predict set option is selected, the following applies: The Name text box must contain asterisk (*) indicating all objects. This is the default setting. The Library list box must contain the name of a single library. Name ranges are not allowed. The Set number box must be filled. For detailed information on Predict sets, refer to the Predict documentation.
Set number | Only applies if Predict set is selected. A one- or two-digit number that identifies the retained set to be used.
Set library | Only applies if Predict set is selected. The name of the library to be searched for a Predict set. If you do not specify a name, the library entered in the Library list box is used by default.
Set user | Only applies if Predict set is selected. The ID of the user who created the retained set. If no ID is entered, the ID specified with the system variable `*USER` (see the System Variables documentation) is used.
Natural Object Types | The types of Natural programming object.
Select All | Selects all types of Natural programming object (this is the default).
Deselect All | Deselect all types of Natural programming object.
User-defined Messages: from/to | A range of user-defined error messages as entered in the Message from/to boxes (see Natural Library Objects above).
User-defined Messages: S/L-Kind | The kind of user-defined error message text:
Short | Short text.
Long | Long text.
Any | Short and/or long text. This is the default.
Both | Short and long texts if both exist (unload function only).
User-defined Messages: Language codes | Up to 8 valid language codes (for example, code `1` for English) of the specified error messages. An asterisk (*) selects all language codes.
Properties | Invokes an extra window where you can specify additional properties of Natural programming objects: see Natural Library Object Properties below. Once you have specified any properties, you can activate them by selecting the check box to the left of the Properties button, or deactivate them by removing the mark from the check box.
Exceptions | Invokes an extra window where you can specify exceptions to the selection of Natural programming objects: see Natural Library Object Exceptions below. Once you have specified any exceptions, you can activate them by selecting the check box to the left of the Exceptions button, or deactivate them by removing the mark from the check box.

## Natural Library Object Properties

The Properties window for Natural library objects is used to specify properties for the Natural library objects selected for processing.

For descriptions of keywords and valid input values, see also select-clause in the section Direct Commands.

The Properties window for Natural library objects provides the following items:

Item | Explanation
--- | ---
User ID | The ID of the user who last saved the object. Specify a single user ID or a range of user IDs: see Name in Name, Date and Time Specification.
Natural version | The Natural version of the Natural programming objects. You can also specify a range of versions: see Name.
Mode |
The programming mode of the Natural programming objects:
Structured | Structured mode only.
Report | Reporting mode only.
Any | No mode check performed. This is the default.
DDM DBID | Not valid in remote environments located on z/OS. The database ID (DBID) of the data definition modules (DDMs). Valid entries are: 1 to 65535 or 0 (all DBIDs)
DDM FNR | Not valid in remote environments located on z/OS. The file number (FNR) of the DDMs: Valid entries are: 1 to 65535 or 0 (all FNRs).
Date: Select all objects | Selects all objects, regardless of their date.
Date: Select objects modified between/and | Selects all objects with a save or catalog date and/or time within the range specified in the Date boxes. Select a value from the combo box or type values for a start date and/or time and/or values for an end date and/or time. For valid input values, see Date and Time in Name, Date and Time Specification. Special dates allowed are: `TODAY`, `YESTERDAY`, `MONTH` and `YEAR`.
Date: Select objects modified on | Selects all objects with a save or catalog date and/or time that fits the date/time specified in the Date box. Select or type values for a date and/or time. For valid input values, see Date and Time. Special dates allowed are: `TODAY` and `YESTERDAY`.
Size: Select all objects | Selects all objects, regardless of their size.
Size: Select objects with size between/and | Selects all objects with a size within the range specified in the Size boxes: type a value for a start size and/or an end size.
Size: Select objects with size | Selects all objects with a size that fits the size specified in the Size box.

## Natural Library Object Exceptions

The Exceptions window for Natural library objects is used to specify exceptions to the selection of Natural library objects.

All objects that match the selection criteria specified in Natural Library Objects, Natural Library Object Details and Natural Library Object Properties are checked against the specifications made in the Exceptions window. Objects that match all specifications defined as exceptions, are exempted from processing.

For descriptions of keywords and valid input values, see also select-clause in the section Direct Commands.

The Exceptions window for Natural library objects is basically identical to the details window. For explanations of the items listed in the table below, see the relevant section. The Properties button is used to specify additional properties for Natural programming object exceptions: see Natural Library Object Exception Properties below.

Item
Location: Library
Object Types: Natural programming objects Error messages Shared resources
Natural Programming Objects and Shared Resources: Name
Natural Programming Objects: S/C-Kind Natural Object Types
Natural System Error Messages: from/to Language codes S/L-Kind
Extras: Properties

## Natural Library Object Exception Properties

The Exception Properties window for Natural library objects is used to specify exceptions to the properties of the Natural library objects selected for processing.

For descriptions of keywords and valid input values, see also select-clause in the section Direct Commands.

The Exception Properties window for Natural library objects provides the following items:

Item | Explanation
--- | ---
User ID | See User ID in Natural Library Object Properties.
Natural version | See Natural version in Natural Library Object Properties.
Mode | See Mode in Natural Library Object Properties.
DDM DBID | See DDM DBID in Natural Library Object Properties.
DDM FNR | See DDM FNR in Natural Library Object Properties.
Date: Ignore date | Performs no date check. Objects are processed, regardless of their date.
Date: Exclude objects modified between/and | Exempts from processing all objects with a save or catalog date and/or time within the range specified in the Date boxes. Select or type values for a start date and/or time and/or values for an end date and/or time. For valid input values, see Date and Time in Name, Date and Time Specification. Special dates allowed are: `TODAY`, `YESTERDAY`, `MONTH` and `YEAR`.
Date: Exclude objects modified on | Exempts from processing all objects with a save or catalog date and/or time that fits the date/time specified in the Date box. Select or type values for a date and/or time. For valid input values, see Date and Time. Special dates allowed are: `TODAY` and `YESTERDAY`.
Size: Ignore size | Performs no size check. Objects are processed, regardless of their size.
Size: Exclude objects with size between/and | Exempts from processing all objects with a size within the range specified in the Size boxes: type a value for a start size and/or an end size.
Size: Exclude objects with size | Exempts from processing all objects with a size that fits the size specified in the Size box.

### On this page

- Natural Library Objects
- Natural Library Object Details
- Natural Library Object Properties
- Natural Library Object Exceptions
- Natural Library Object Exception Properties