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:
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 |
|
| 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 |
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 mainframe platforms. |
|||||||||||||||||||
| 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 If the Use Predict set option is selected, the following applies:
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
|
|||||||||||||||||||
| Programming Object Options: |
|
|||||||||||||||||||
| Programming Object Options: | 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: | A range of user-defined error messages as entered in the Error number from/to fields (see Natural Library Objects above). | |||||||||||||||||||
| Error Messages: | 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: |
|
|||||||||||||||||||
| Exceptions | PF8 | Invokes an extra screen where you can specify exceptions to the selection of Natural programming objects: see Natural Library Object Exceptions. | ||||||||||||||||||
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 |
|
||||||||||
| 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: | 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: |
||||||||||
| Object Date: | 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: |
||||||||||
| Object Size:
Select all objects (no size check) |
Selects all objects, regardless of their size. | ||||||||||
| Object Size: | 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. | ||||||||||
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: |
|
| Object name | |
| S/C-Kind | |
| Natural types | |
| Select Natural types | PF6 |
| Properties | PF7 |
| Error number | |
| S/L-Kind | |
| Languages |
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: | 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: |
| Object Date: | 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: |
| 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. |
