Object Specification - Natural Library Objects

#### Search Results

Search

# Object Specification - Natural Library Objects

This section describes the options provided on the object-specification screens 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 screen Unload/Load/Scan Natural Library Objects provides the following fields and PF keys:

Field | PF Key | Explanation
--- | --- | ---
DBID/FNR |  | Only applies to the unload function. The database ID (DBID) and file number (FNR) of the system file where the Natural libraries are stored. If no values (or `0`) are specified, the current FUSER or FNAT system file is used.
Select DBID/FNR | PF5 (advanced-user mode only) | Only applies to the unload function. Displays a selection list of system files available.
Library |  | The name of a library or a range of names: see Name in Name, Date and Time Specification.
Select library | PF4 | Displays a selection list of all libraries available. See also Select Library.
Object name |  | The name of a Natural programming object or shared resource or a range of names: see Name. Only evaluated if the fields Natural programming objects (default setting) and/or Shared resources are selected on the screen Natural Library Objects, Details. See also Natural Library Object Details.
Select objects |  | Only applies to the unload function in advanced-user mode. If no library range is specified, a selection list of all Natural objects available is displayed (see also Select Objects).
Error number 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 field Error messages (default setting) is selected on the screen Natural Library Objects, Details (see also Natural Library Object Details).
Details | PF6 | Invokes the screen Natural Library Objects, Details where you can enter more detailed object specifications. See Natural Library Object Details.
Settings | PF7 | Only applies to functions executed in advanced-user mode. Invokes the Unload/Load/Scan Settings screen where you can specify option and parameter settings: see Settings.
Work file | PF11 | The name of the work file to be used for the function. If the name exceeds the space available, choose PF11 (WorkF) and enter a longer name of up to 253 characters. Alternatively, position the cursor at this field and choose PF1 (Help). See also Work Files.
PF1

## Natural Library Object Details

The screen Unload/Load/Scan Natural Library Objects, Details 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 screen Unload/Load/Scan Natural Library Objects, Details provides the following fields and PF keys:

Field | PF Key | Explanation
--- | --- | ---
Library |  | The name of a library or a range of names: see Name in Name, Date and Time Specification. Ranges are not allowed if the Use Predict set option is selected.
Select (Library) | PF4 | Displays a selection list of all libraries available. See also Select Library.
DBID/FNR |  | See DBID/FNR in Natural Library Objects above.
Object Types: Natural programming objects |  | Natural programming objects including Natural DDMs (data definition modules). If the FDDM system file has been activated, see also Use FDDM file for processing DDMs in the section Settings.
Object Types: Error messages |  | User-defined error messages.
Object Types: 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.
Object name |  | See Object name in Natural Library Objects above.
Use 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 Use Predict set option is selected, the following applies: The Object name field must contain asterisk (*) indicating all objects. This is the default setting. The Library field must contain the name of a single library. Name ranges are not allowed. The Set number field must be filled. For detailed information on Predict sets, refer to the Predict documentation.
Set number |  | Only applies if Use Predict set is selected. A one- or two-digit number that identifies the retained set to be used.
Set library |  | Only applies if Use 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 field is used by default.
Set user |  | Only applies if Use 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.
Programming Object Options: S/C-Kind |  |
The kind of Natural programming object:
`S` | Source objects only.
`C` | Cataloged objects only.
`A` or `*` | All source objects and/or cataloged objects. This is the default setting.
`W` | All STOWed objects: source and cataloged objects with identical date and time.
`B` | Both source and cataloged objects if both exist.
Note `W` and `B` are valid for the unload function only. Though `W` and `B` can also be entered for the load or scan function, they are treated like `A`.
Programming Object Options: Natural types |  | A Natural object-type code such as `P` for program. For a list of valid codes, see `NATTYPE` in the section select-clause.
Select Natural types | PF6 | Invokes a window where you can select one or more types of Natural object.
Properties | PF7 | Invokes an extra screen where you can specify additional properties of Natural programming objects: see Natural Library Object Properties.
Error Messages: Error number from/to |  | A range of user-defined error messages as entered in the Error number from/to fields (see Natural Library Objects above).
Error 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.
Error Messages: S/L-Kind |  |
The kind of error message text:
`S` | Short text.
`L` | Long text.
`A` | Short and/or long text. This is the default.
`B` | Short and long texts if both exist (unload function only).
Exceptions | PF8 | Invokes an extra screen where you can specify exceptions to the selection of Natural programming objects: see Natural Library Object Exceptions.

## Natural Library Object Properties

The screen Unload/Load/Scan Library Objects, Properties 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 screen Unload/Load/Scan Library Objects, Properties provides the following fields:

Field | Explanation
--- | ---
User ID | The ID of the user who saved or cataloged a Natural programming object. Specify a single user ID or a range of user IDs: see Name in Name, Date and Time Specification.
Programming mode |
The programming mode of the Natural programming objects:
`R` | Reporting mode only.
`S` | Structured mode only.
`A` | No mode check performed. This is the default setting.
Natural version | The Natural version of the Natural programming objects. You can also specify a range of versions: see Name.
DDM DBID | The database ID (DBID) of the data definition modules (DDMs). Valid entries are: 1 to 65535 or 0 (all DBIDs)
DDM FNR | The file number (FNR) of the DDMs: Valid entries are: 1 to 65535 or 0 (all FNRs).
Object Date: Select all objects (no date check) | Selects all objects, regardless of their date.
Object Date: Select objects modified between/and | Selects all objects with a save or catalog date and/or time within the range specified in these fields by entering a precise start date and/or time and/or 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`.
Object Date: Select objects modified on | Selects all objects with a save or catalog date and/or time that fits the date/time specified in these fields by entering a precise date and/or time. For valid input values, see Date and Time. Special dates allowed are: `TODAY` and `YESTERDAY`.
Object Date: Check date for object kind | Kind of object (source or cataloged object) to be checked for the defined date or date range. Valid input values are:
`S` | Check the date of source objects and (if available) the date of objects which exist only as cataloged objects.
`C` | Check the date of cataloged objects and (if available) the date of objects which exist only as source objects.
blank | Object kind is not checked. This is the default setting.
The search result of the object check also depends on the setting of the S/C-Kind field. |
Object Size: Select all objects (no size check) | Selects all objects, regardless of their size.
Object Size: Select objects with size between/and | Selects all objects with a size within the range specified in these fields by entering a start size and/or an end size.
Object Size: Select objects with size | Selects all objects with a size that fits the size specified in this field.

## Natural Library Object Exceptions

The screen Unload/Load/Scan Library Objects, Exceptions 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 on the screen Unload/Load/Scan Library Objects, Exceptions. 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 screen Unload/Load/Scan Library Objects, Exceptions is basically identical to the screen Unload/Load/Scan Natural Library Objects, Details. See the relevant section for explanations of the fields, commands and alternative PF keys listed in the table below. The field Add/change properties for selection is used to specify additional properties for Natural programming object exceptions: see Natural Library Object Exception Properties.

Field | PF Key
--- | ---
Library | PF4
Select (Library) |
Object Types: Natural programming objects Error messages Shared resources |
Object name |
S/C-Kind |
Natural types |
Select Natural types | PF6
Properties | PF7
Error number |
S/L-Kind |
Languages |

## Natural Library Object Exception Properties

The screen Unload/Load/Scan Library Objects, Exceptions is used to specify exceptions to the properties of the Natural library objects selected for processing.

The screen provides the following fields:

Field | Explanation
--- | ---
User ID | See User ID in Natural Library Object Properties.
Programming mode | See Programming mode in Natural Library Object Properties.
Natural version | See Natural version 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.
Object Date: Ignore object date | Performs no date check. Objects are processed, regardless of their date.
Object 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 these fields by entering a precise start date and/or time and/or 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`.
Object 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 these fields by entering a precise date and/or time. For valid input values, see Date and Time. Special dates allowed are: `TODAY` and `YESTERDAY`.
Object Size: Ignore object size | Performs no size check. Objects are processed, regardless of their size.
Object Size: Exclude objects with size between/and | Exempts from processing all objects with a size within the range specified in these fields by entering a start size and/or an end size.
Object Size: Exclude objects with size | Exempts from processing all objects with a size that fits the size specified in this field.

### On this page

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