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.
Work file	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 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 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 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.