1. Natural Object Handler – Basic Topics (SYSOBJH)
James Bando
Software AG, Inc.

2. Presentation Notes
Unless otherwise specified, information in this presentation pertains to Natural 4.2 and Adabas 8.1.
Some screen-captures are abbreviated in the interest of clarity and conciseness.
Software AG Systems Engineering Services Mentoring Workshops See
IBM Assembler Programming for Administrators (5 days)
SuperNatural: A Practical Guide Workshop (4 days)
Using Adabas Review (3 days)
Natural Security (2 days)
Natural for Unix Internals (3 day)
EntireX Performance and Tuning (1 day)
A Linux Technician's Primer (1 day)

3. General Information

4. SYSOBJH Replaces SYSTRANS and NATLOAD/NATUNLD utilities.
SYSOBJH Functions
Unload/Load objects using operating system file as the transfer file.
Scan a transfer file.
Locate objects in your environment (FIND and FINDLIB commands).
Can process files created with SYSTRANS and NATUNLD.
SYSTRANS and NATLOAD/NATUNLD
No longer documented as of V4.2. (However, documentation is available on the CD in the archive folder.)
Will be discontinued in next version of Natural.
Will no longer be enhanced.

5. Glossary
Command A word that causes processing of Natural, Natural-related, or Adabas objects.
Function A process in the SYSOBJH Graphical User Interface (GUI) or Character User Interface (CUI) that affects how you use the interface.
Transfer file The physical file that will be used as output for the UNLOAD command or input for the LOAD[ALL] and SCAN[ALL] commands.
Transfer file format The byte format used to store the data on the transfer file, either character (transfer) or binary (internal).
Transfer file method The I/O method used to store the transfer file, either an operating system file or a Natural Connection file.
Workplan A predefined set of commands, objects, options, or parameters.

6. Transfer File Formats Internal format Transfer format
Binary data on the transfer file.
Compatible with NATLOAD / NATUNLD.
Same platform only (m/f  m/f, open systems  open systems).
Transfer source and/or cataloged objects.
Character data on the transfer file.
Compatible with SYSTRANS.
Cross-platform. (m/f  PC, open systems  PC, m/f  open systems).
Transfer source objects only.
Internal format
Transfer format

7. Transfer File Objects Objects processed by SYSOBJH
Natural library objects (including user error messages)
Natural system error messages
Natural DDMs
Natural command processors
Natural-related objects
DL/I subfiles
Natural profiles
Natural editor profiles
Parameter ("SYSPARM") profiles
Map profiles
Device profiles
Debug (TEST) profiles
FDTs
New
New
New
New
New
New

8. SYSOBJH User Interfaces
Wizards
Lead you through the most common functions.
You can use them to create direct commands that you can use in batch without actually executing the function on-line.
Advanced
You navigate all the screens and make all the selections.
Fewer screens than wizards, but there are no prompts.
Commands
Useful in batch.
Useful on-line if you want to do something specific.
API
Issue commands from a Natural program.
CALLNAT 'OBJHAPI'.
Documentation and sample program: SYSOBJH(DOC-API).

9. Function/Command/CUI/GUI Syntax
Commands have up to four parts.
Example: UNLOAD Y* LIB YSAJGB OBJTYPE N WITH LIBRARY YSAJGB NEWLIBRARY ZSAJGB NEWUSERID CHNGELIB WHERE REPORT YPGMS
Command Name
Examples: UNLOAD, LOAD, SCAN, RESTART
Selection criteria
Example: Y* LIB YSAJGB OBJTYPE N
Parameters (WITH clause)
Example: WITH LIBRARY YSAJGB NEWLIBRARY ZSAJGB NEWUSERID CHNGELIB
Options (WHERE clause)
Example: WHERE REPORT YPGMS
Wizards make it easy to enter these four parts.

10. Items of Interest Generic names
In most cases, you can use generic values (*, >, <) where an object name or library name is specified.
Not all functions, options, etc. apply to every type of object for every command. For example, you cannot DELETE an FDT from an Adabas database, but you can UNLOAD, LOAD, or FIND an FDT.

11. Choices You Must Make What command do you want to use?
UNLOAD, LOAD, LOADALL, SCAN, SCANALL, DELETE, FIND object(s), FINDLIB library(ies), RESTART, EXECUTE a procedure workplan, or DISPLAY STATISTICS.
What is the unload environment?
Mainframe, Unix/Linux, or Windows.
What is the load/scan/delete/find/restart environment?
What kind of Natural objects to be processed?
Source/cataloged/either/both/STOWed objects.
What transfer file format is to be used?
Internal (source and/or cataloged objects) or transfer (source objects).
What transfer file media is going to be used?
Operating system file or Natural Connection file.
What user interface is going to be used to execute the command(s)?
On-line (wizard/advanced), batch, or user-written (using OBJHAPI).

12. Commands select-clause UNLOAD [WITH ] [WHERE ] ( selection workplan )
Unload selected objects to a transfer file.
Objects that can be unloaded
Natural library objects (including user error messages)
Natural system error messages
Natural command processor sources
Natural-related objects
DDMs
FDTs
parameter-clause
( parameter workplan )
options-clause
( option workplan )

13. Commands select-clause LOAD [WITH ] [WHERE ] ( selection workplan )
Load selected objects from a transfer file.
Objects that can be loaded
Natural library objects (including user error messages)
Natural system error messages
Natural command processor sources
Natural-related objects
DDMs
FDTs (FDTs are loaded, but you must still define the files, for example using AOS)
parameter-clause
( parameter workplan )
options-clause
( option workplan )

14. Commands LOADALL [WITH ] [WHERE ] parameter-clause
Load all objects from a transfer file.
Objects that can be loaded
Natural library objects (including user error messages)
Natural system error messages
Natural command processor sources
Natural-related objects
DDMs
FDTs (FDTs are loaded, but you must still define the files, for example using AOS)
parameter-clause
( parameter workplan )
options-clause
( option workplan )

15. Commands select-clause SCAN [WHERE ] ( selection workplan )
Scan a transfer file for selected objects.
Objects that can be scanned for
Natural library objects (including user error messages)
Natural system error messages
Natural command processor sources
Natural-related objects
DDMs
FDTs
options-clause
( option workplan )

16. Commands SCANALL [WHERE ] options-clause ( option workplan )
Scan all objects on a transfer file.
Objects that can be scanned for
Natural library objects (including user error messages)
Natural system error messages
Natural command processor sources
Natural-related objects
DDMs
FDTs
options-clause
( option workplan )

17. Commands select-clause DELETE [WHERE ] ( selection workplan )
Delete selected objects from FNAT/FUSER/FDIC.
Objects that can be deleted
Natural library objects (including user error messages)
Natural system error messages
Natural command processor sources
Natural-related objects
DDMs
options-clause
( option workplan )

18. Commands select-clause FIND [WHERE ] ( selection workplan )
Find selected objects in FNAT/FUSER/FDIC/DB.
Objects that can be found
Natural library objects (including user error messages)
Natural system error messages
Natural command processor sources
Natural-related objects
DDMs
FDTs (find one FDT in an Adabas database)
options-clause
( option workplan )

19. Commands select-clause FINDLIB [WHERE ] ( selection workplan )
Find libraries in FNAT/FUSER.
Objects that can be found
Natural libraries
options-clause
( option workplan )

20. Commands RESTART member-name Restart an interrupted load function.
A restart member must have been specified during the load function.

21. Commands
EXECUTE ( procedure-workplan ) Note: Parentheses are required.
Executes a workplan of type PROCEDURE.
A procedure workplan is a set of direct commands (such as, UNLOAD or LOAD) that will be executed together either on-line or in batch.
A procedure workplan allows you to maintain a set of commands in one place that will be executed in many places (such as, several batch jobs).

22. View Function (CUI/GUI)
View object source code in FNAT/FUSER/FDIC/DB.
Objects that can be viewed
Natural library objects (including user error messages)
Natural system error messages
Natural command processor sources
Natural-related objects
DDMs
FDTs (can only get a list of FDTs – cannot display contents of an FDT)

23. These are useful on-line.
GO Function (CUI/GUI)
GO HOME (Yeah!!)
Go to main menu
GO UNLOAD Go to unload menu
GO LOAD Go to load menu
GO SCAN Go to scan menu
GO RESTART Go to restart load menu
GO ADMIN Go to administration menu
GO VIEW Go to view menu
GO FIND Go to find menu
These are useful on-line.

24. SHOW Function (CUI/GUI)
SHOW STATUS Display workplan information, trace settings, Natural Security settings, etc.
SHOW STATISTIC Display counts of objects processed.
SHOW LAST RESULT Display last return code and message.
SHOW LAST MESSAGE Display last unload/load/scan messages.
SHOW PROFILE Display SYSOBJH profile.
SHOW REPORT Display latest report file.
SHOW TRACE Display trace file.

25. SET Function (CUI/GUI)
Use SET command to display the menu of settings.
Set trace on/off/location.
Set free format editing on/off.
Set display of execution messages on/off.
Set advanced command display on/off.

26. Other Useful Functions (CUI/GUI)
CLEAR Fill current map with initial values.
INIT Set default values for the SYSOBJH.
SETTINGS Change unload/load/scan settings and options.
READ PROFILE Read SYSOBJH profile.
COMMANDS Display list of commands.

27. WORK Files WORK File 1 WORK File 7 WORK File 8
Used if Entire Connection is not used.
Contains the unloaded objects in transfer or internal format.
WORK File 7
Used if Entire Connection is used.
WORK File 8
Internal work file.
Open systems-only WORK files
WORK file 4 Report file.
WORK file 6 Restart data (load only).
WORK file 10 Trace file

28. Unload

29. SYSOBJH Main Menu Choose Unload
01:13: ***** Natural Object Handler *****
User SAJGB Main Menu -
Select the desired function:
X Unload objects or a whole application from your Natural environment
_ Load objects or an application into your Natural environment
_ Scan work file contents
_ View objects in the Natural environment
_ Administrate the Object Handler environment,
process Workplans and direct commands
Mark this field to avoid Object Handler wizards:
_ Advanced user
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Unld Load Scan View Admin Cmds Canc
Subsequent screens will be condensed. Screens will not contain any prompts.

30. Requires a COMMAND PROCEDURE workplan.
Unload Menu
Choose if you want to enter everything or use a procedure workplan.
01:14: ***** Natural Object Handler *****
User SAJGB Unload Wizard -
You can unload all Natural objects into Natural work files
to transport them to another system.
The unloaded Natural work files can be loaded with the
load function of the Object Handler.
Select the desired function:
X Unload objects into Natural work file(s).
_ Start Object Handler command procedure.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Back Next Cmds Canc
Requires a COMMAND PROCEDURE workplan.

31. Unload Wizard, Options Choose Wizard options
01:15: ***** Natural Object Handler *****
User SAJGB Unload Wizard, Options -
If you want to unload data in Transfer format, mark this field:
_ Transfer format _ Unicode work file
If you want to use a PC his fiel
_ Use PC work file
If you use a PC work file enter the PC work file name. If the path and
the name do not fit into the field, press PF1 to specify a longer value.
PC File __________________________________________________
Select the desired option to be used.
Mark 'Set additional options', to use additional options.
X Use default options X Set additional options
_ Use Option Workplan Name ________ _ List Option Workplan
_ Select Option Workplan
Please enter options.
Command ===>
Enter-PF1---PF2---PF PF9---PF10--PF11--PF12---
Help Exit Cmds Canc
Leave blank to use internal format.
Transfer format written using Unicode UTF-8.
Must choose one of these.
Mark if you want to change options.
Mark to use a workplan of type OPTION. Also enter name.
Mark to use a workplan of type OPTION. Also enter name.

32. The options listed depend on the function.
Unload Options
Enter UNLOAD options
01:16: ***** Natural Object Handler *****
User SAJGB Unload Options -
Work File and Report Options:
X Write report _ Start new report
Report text member YPGMS___ _ Select text member
XREF Options: FDIC Settings:
_ Yes (unload XREF data) DBID/FNR _____ / _____
X No (ignore XREF data) Password
Cipher
FSEC Settings:
DBID/FNR _____ / _____
Password
The name for the report text member must not be blank.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc
The options listed depend on the function.
Writes report to member in workplan library.
Mark to clear report member and start new report.
Enter report member name or select from list.
Choose other options as desired

33. Unload Wizard, Parameters
Choose whether or not to use UNLOAD parameters
01:17: ***** Natural Object Handler *****
User SAJGB Unload Wizard, Parameters -
Use parameters if you want to unload the objects with modified settings.
The corresponding object properties in the work file will differ from
the original values according to the parameter settings.
Select the desired options to be used.
Mark 'Set global parameters', to use additional parameters.
_ Do not use parameters
X Use global parameters X Set global parameters
_ Use Parameter Workplan Name ________ _ List Parameter Workplan
_ Select Parameter Workplan
Mark one parameter field.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit PaSet SelWP LstWP Back Next Cmds Canc
Must choose one of these.
We will set global parameters to see what they are.

34. Objects that match these criteria …
Unload Parameters
Enter UNLOAD parameters
01:17: ***** Natural Object Handler *****
User SAJGB Unload Parameters -
Parameter Check Value New Value
Object name _______________________________ _______________________________
Library .... YSAJGB___ ZSAJGB__
Date/Time .. ___________ / _________ __________ / ________
User ID .... ________ CHNGELIB
Terminal ID ________ ________
Lang. codes ________ ________
Error number difference (+/-nnnn) _____
FDT DBID/FNR _____ / _____ _____ / _____
Command ===> X
Enter-PF1---PF2---PF3---PF4---PF5---P
Help Exit
Unload parameters are applied before objects are written to the transfer file.
Objects that match these criteria …
… will be changed to these values. For object name, library, date/time, user ID, and terminal ID, if asterisk notation is used, the constant value determines the number of characters that will be replaced.
Example: Specifying 'XY*' in the New Value User ID will change the first two characters of the user ID of all objects matching the Check Values to 'XY'.

35. Unload Wizard, Select Unload Type
Choose UNLOAD type
01:19: ***** Natural Object Handler *****
User SAJGB Unload Wizard, Select Unload Type -
Select the object type for unload.
You can unload objects of different object types sequentially
in separate steps.
X Natural library objects only
_ Natural system error messages only
_ Natural command processor sources only
_ Natural-related objects only
_ DDMs only
_ FDTs only or
_ Use Selection or List Workplan
Mark one object type.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Back Next Cmds Canc

36. Unload Wizard, Natural Library Objects
Enter selection criteria
01:19: ***** Natural Object Handler *****
User SAJGB Unload Wizard, Natural Library Objects -
Select Natural library objects to be unloaded.
You can unload objects with different selection criteria
sequentially in separate steps.
Library YSAJGB __ DBID/FNR _____ / _____ _ Select DBID/FNR
_ Select library
Object name Y*_______________________________
Error number from 0001 to 9999
Details
X More detailed specification of objects
If you want to use a more detailed selection, mark Details.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit SeLib Detai Back Next Cmds Canc

37. Unload Natural Library Objects, Details
Enter more selection criteria
01:20: ***** Natural Object Handler *****
User SAJGB Unload Natural Library Objects, Details -
Location: Object Types:
Library YSAJGB___ _ Select X Natural programming objects
DBID/FNR .... _____ / _____ X Error messages
Passw./Ciph /
Objects:
Object name . Y*_______________________________
_ Use Predict set Set number __ Set user ________
Programming Object Options:
S/C-Kind .... A (S/C/A/W/B Source/Cataloged/Any/Stowed/Both)
Natural types *______________ _ Select Natural types
Properties
_ Add/change properties for selection (date, user ID, ..)
Error Messages:
Error number to Language codes *_______
S/L-Kind .... A (S/L/A Short/Long/Any)
Exceptions
_ Add/change exception criteria for selection
Press ENTER to continue or mark Properties or Exceptions field.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit SeLib Types Prope Excep Cmds Canc
"Natrual Library Objects" includes error messages, by default.
Source only
Cataloged only
Any kind
Stowed (S/C timestamps match)
Both (Source & cataloged must exist) `

38. Unload Natural Library Objects, Types
Enter more selection criteria
01:20: ***** Natural Object Handler *****
User S Select Object Types
Loc ! !
L ! Select the Natural programming object type(s) you want ! cts
D ! to process by marking the field before the type name, or !
P ! press PF7 to select all, or PF8 to deselect all fields. !
! !
Obj ! X Program X Map X Global Data Area !
O ! !
_ ! X Subprogram X Dialog X Local Data Area !
Pro ! !
S ! X Subroutine X Text X Parameter Data Area !
N ! !
Pro ! X Helproutine _ DDM X Report !
_ ! !
Err ! X Copycode X Processor X Class !
E ! !
S ! X Function !
Exc
_ Add/change exception criteria for selection
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit All Desel Canc

39. Unload Natural Library Objects, Properties
Enter more selection criteria
01:20: ***** Natural Object Handler *****
User SAJGB Unload Library Objects, Properties -
Natural Programming Objects:
User ID _________
Programming mode . A (S/R/A Structured/Report/Any)
Natural version .. _________
Object Date:
X Select all objects (no date check)
_ Select objects modified between ... __________ ________ (date, time)
and ... __________ ________ (date, time)
_ Select objects modified on __________ ________ (date, time)
Object Size:
X Select all objects (no size check)
_ Select objects with size between .. __________ and __________ (bytes)
_ Select objects with size __________ (bytes)
Press ENTER to continue.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc

40. Unload Natural Library Objects, Exceptions
Enter more selection criteria
01:21: ***** Natural Object Handler *****
User SAJGB Unload Library Objects, Exceptions -
Location: Object Types:
Library _________ _ Select _ Natural programming objects
_ Error messages
Objects:
Object name . _________________________________
Programming Objects Options:
S/C-Kind .... _ (S/C/A Source/Cataloged/Any)
Natural types _______________ _ Select Natural types
Properties
_ Add/change properties for selection (date, user ID, ..)
Error Messages:
Error number ____ to ____ Languages ________
S/L-Kind .... _ (S/L/A Short/Long/Any)
Press ENTER to continue or mark Properties field.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit SeLib Types Prope Cmds Canc
Objects matching all exception criteria are not processed.

41. Can use the wizard to create direct commands.
Unload Wizard
UNLOAD command created by the Wizard
01:21: ***** Natural Object Handler *****
User SAJGB Unload Wizard -
The following command will be processed.
To change the settings, press PF7 (Back). To confirm the settings and
to execute the command, press ENTER or PF8 (Next).
UNLOAD Y* LIB YSAJGB OBJTYPE NE FMNUM 1 TONUM 9999 WITH LIBRARY YSAJGB
NEWLIBRARY ZSAJGB NEWUSERID CHNGELIB WHERE REPORT YPGMS
Please press PF7 (Back) or ENTER/PF8 (Next).
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Save Back Next Cmds Canc
Can use the wizard to create direct commands.

42. Unload Wizard Command has been processed
01:21: ***** Natural Object Handler *****
User SAJGB Unload Wizard -
The following command will be processed.
To change the settings, press PF7 (Back). To confirm the settings and
to execute the command, press ENTER or PF8 (Next).
UNLOAD Y* LIB YSAJGB OBJTYPE NE FMNUM 1 TONUM 9999 WITH LIBRARY YSAJGB
! !
! Function completed successfully !
! Press ENTER to continue !
Press ENTER to continue.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc

43. Unload Report Report (left side)
01:22: ***** Natural Object Handler *****
User SAJGB Display Unload Report -
Position
Status Library Object Name Object Type S/C
Unloaded YSAJGB YEREP Program Src
Unloaded YSAJGB YEREP Program Cat
Unloaded YSAJGB YMENU Program Src
Unloaded YSAJGB YMENU Program Cat
Unloaded YSAJGB YVREP Program Src
Unloaded YSAJGB YVREP Program Cat
Bottom of data reached.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit > Cmds Canc

44. Unload Report Report (middle)
01:23: ***** Natural Object Handler *****
User SAJGB Display Unload Report -
Position
Type S/C DBID/FNR Date Time User Mode Size Version DDM
Src 156/ :46:29 SAJGB R
Cat 156/ :46:29 SAJGB R
Src 156/ :48:40 SAJGB R
Cat 156/ :48:40 SAJGB R
Src 156/ :47:47 SAJGB R
Cat 156/ :47:47 SAJGB R
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit < > Cmds Canc

45. Unload Report Report (right side)
01:23: ***** Natural Object Handler *****
User SAJGB Display Unload Report -
Position
n DDM DBID/FNR
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit < Cmds Canc

46. Unload Report Choose to unload more objects or "done"
01:23: ***** Natural Object Handler *****
User SAJGB Display Unload Report -
Position
n DDM DBID/FNR
! !
! Do you want to continue the unload function? !
! _ Yes X No !
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc

47. SYSOBJH Main Menu, Unload Finished
Start a new Wizard
01:24: ***** Natural Object Handler *****
User SAJGB Main Menu -
Select the desired function:
_ Unload objects or a whole application from your Natural environment
_ Load objects or an application into your Natural environment
_ Scan work file contents
_ View objects in the Natural environment
_ Administrate the Object Handler environment,
process Workplans and direct commands
Mark this field to avoid Object Handler wizards:
_ Advanced user
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Unld Load Scan View Admin Cmds Canc

48. List Saved Report LOGON WORKPLAN -> L * *
01:25: ***** NATURAL LIST COMMAND *****
User SAJGB LIST Objects in a Library Library WORKPLAN
Cmd Name Type S/C SM Version User ID Date Time
--- *________ *__________ *__ * *______ *________ *__________ *________
LI YPGMS Text S S SAJGB :22:02
01:26:44 Text YPGMS Library WORKPLAN User SAJGB
*** Unload Objects ***
0002
0003 Library Object Name Type S/C DBID/FNR Date
0005 YSAJGB YEREP Program Src 156/
0006 YSAJGB YEREP Program Cat 156/
0007 YSAJGB YMENU Program Src 156/
0008 YSAJGB YMENU Program Cat 156/
0009 YSAJGB YVREP Program Src 156/
0010 YSAJGB YVREP Program Cat 156/
0011
0012 Function completed successfully.
0013
***** End of list *****
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Print Exit Prev Next < > Canc

49. List Saved Report LOGON WORKPLAN -> L * * (cont'd)
Line
0001
0002
0003 Date Time User ID S/R Size Version DDM DBID/FNR Status
:46:29 SAJGB R Unloaded
:46:29 SAJGB R Unloaded
:48:40 SAJGB R Unloaded
:48:40 SAJGB R Unloaded
:47:47 SAJGB R Unloaded
:47:47 SAJGB R Unloaded
0011
0012
0013
***** End of list *****Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Print Exit Prev Next < > Canc

50. Scan

51. SYSOBJH Main Menu Choose Scan
01:35: ***** Natural Object Handler *****
User SAJGB Main Menu -
Select the desired function:
_ Unload objects or a whole application from your Natural environment
_ Load objects or an application into your Natural environment
X Scan work file contents
_ View objects in the Natural environment
_ Administrate the Object Handler environment,
process Workplans and direct commands
Mark this field to avoid Object Handler wizards:
_ Advanced user
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Unld Load Scan View Admin Cmds Canc

52. Scan Wizard
Choose if you want to enter everything or use a procedure workplan.
01:36: ***** Natural Object Handler *****
User SAJGB Scan Wizard -
You can scan objects from transfer and non-transfer work files
or execute a command procedure.
Select the desired function:
X Scan objects from Natural work file(s).
_ Start Object Handler command procedure.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Back Next Cmds Canc

53. Scan Wizard, Options Choose Wizard options
01:36: ***** Natural Object Handler *****
User SAJGB Scan Wizard, Options -
If the work file contains data in Transfer format, mark this field:
_ Transfer format
If you want to use a PC work file, mark this field:
_ Use PC work file
If you use a PC work file enter the PC work file name. If the path and
the name do not fit into the field, press PF1 to specify a longer value.
PC File __________________________________________________
Select the desired option to be used.
Mark 'Set additional options', to use additional options.
X Use default options _ Set additional options
_ Use Option Workplan Name ________ _ List Option Workplan
_ Select Option Workplan
Please enter options.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit OpSet SelWP LstWP Back Next Cmds Canc

54. Scan Wizard, Select Scan Type
Choose object types to SCAN
01:36: ***** Natural Object Handler *****
User SAJGB Scan Wizard, Select Scan Type -
Select the object type for scan.
You can scan all objects from the work file or you can scan
objects of different object types sequentially in separate steps.
X Scan all objects from the work file
or scan selected objects from the work file:
_ Natural library objects only
_ Natural system error messages only
_ Natural command processor sources only
_ Natural-related objects only
_ DDMs only
_ FDTs only or
_ Use Selection or List Workplan
Mark one object type.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Back Next Cmds Canc

55. Scan Wizard, Command SCANALL command created by the Wizard
01:37: ***** Natural Object Handler *****
User SAJGB Wizard -
The following command will be processed.
To change the settings, press PF7 (Back). To confirm the settings and
to execute the command, press ENTER or PF8 (Next).
SCANALL WHERE REPORT
Please press PF7 (Back) or ENTER/PF8 (Next).
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Save Back Next Cmds Canc

56. Scan Wizard, Completion
Command has been processed
01:37: ***** Natural Object Handler *****
User SAJGB Wizard -
The following command will be processed.
To change the settings, press PF7 (Back). To confirm the settings and
to execute the command, press ENTER or PF8 (Next).
SCANALL WHERE REPORT
! !
! Function completed successfully !
! Press ENTER to continue !
Press ENTER to continue.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc

57. Scan Report Report (left side)
01:37: ***** Natural Object Handler *****
User SAJGB Display Scan Report -
Position
Status Library Object Name Object Type S/C
Scanned ZSAJGB YEREP Program Src
Scanned ZSAJGB YEREP Program Cat
Scanned ZSAJGB YMENU Program Src
Scanned ZSAJGB YMENU Program Cat
Scanned ZSAJGB YVREP Program Src
Scanned ZSAJGB YVREP Program Cat
Bottom of data reached.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit > Cmds Canc

58. Scan Report Report (middle)
01:38: ***** Natural Object Handler *****
User SAJGB Display Scan Report -
Position
Type S/C DBID/FNR Date Time User Mode Size Version DDM
Src / :46:29 CHNGELIB R
Cat / :46:29 CHNGELIB R
Src / :48:40 CHNGELIB R
Cat / :48:40 CHNGELIB R
Src / :47:47 CHNGELIB R
Cat / :47:47 CHNGELIB R
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit < > Cmds Canc

59. Load

60. For the Daniel Boone in you!
SYSOBJH Main Menu
Choose Load
02:02: ***** Natural Object Handler *****
User SAJGB Main Menu -
Select the desired function:
_ Unload objects or a whole application from your Natural environment
X Load objects or an application into your Natural environment
_ Scan work file contents
_ View objects in the Natural environment
_ Administrate the Object Handler environment,
process Workplans and direct commands
Mark this field to avoid Object Handler wizards:
_ Advanced user
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Unld Load Scan View Admin Cmds Canc
For the Daniel Boone in you!

61. Requires a PROCEDURE workplan.
Load Wizard
Choose if you want to enter selection criteria, parameters, and options or use a procedure workplan.
02:04: ***** Natural Object Handler *****
User SAJGB Load Wizard -
You can load objects from transfer and non-transfer work files
into the Natural environment or execute a command procedure.
Select the desired function:
X Load objects from Natural work file(s).
_ Start Object Handler command procedure.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Back Next Cmds Canc
Requires a PROCEDURE workplan.

62. Load Wizard, Options Choose Wizard options
02:04: ***** Natural Object Handler *****
User SAJGB Load Wizard, Options -
If the work file contains data in Transfer format, mark this field:
_ Transfer format
If you want to use a PC work file, mark this field:
_ Use PC work file
If you use a PC work file enter the PC work file name. If the path and
the name do not fit into the field, press PF1 to specify a longer value.
PC File __________________________________________________
Select the desired option to be used.
Mark 'Set additional options', to use additional options.
X Use default options X Set additional options
_ Use Option Workplan Name ________ _ List Option Workplan
_ Select Option Workplan
Please enter options.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit OpSet SelWP LstWP Back Next Cmds Canc
Leave blank to use internal format.
Must choose one of these.
Mark if you want to change options.
Mark to use a workplan of type OPTION. Also enter name.

63. Can specify text member where restart information is stored.
Load Options
Enter LOAD options
02:06: ***** Natural Object Handler *****
User SAJGB Load Options -
Work File Options:
Work file __________________________________________________
X Write report _ Start new report
Report text member ZPGMSIN_ _ Select text member
_ Write restart information
Restart text member ________ _ Select text member
Replace Options: XREF Options: FDIC Settings:
X Do not replace _ Yes DBID/FNR _____ / _____
_ Replace all X No Password ________
_ Replace obsolete _ Force Cipher ________
_ Replace except newer _ Doc FSEC Settings:
_ Special DBID/FNR _____ / _____
Number to process: Version check: Password ________
_____ _ Check version Cipher ________
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit WorkF RepoF RestF Cmds Canc
Can specify text member where restart information is stored.

64. Load Wizard, Parameters
Choose whether or not to use LOAD parameters
02:10: ***** Natural Object Handler *****
User SAJGB Load Wizard, Parameters -
Use parameters if you want to load the objects with modified settings.
The corresponding object properties will differ from those
given in the work file according to the parameter setting.
Select the desired options to be used.
Mark 'Set global parameters', to use additional parameters.
Do not use parameters
X Use global parameters X Set global parameters
_ Use Parameter Workplan Name ________ _ List Parameter Workplan
_ Select Parameter Workplan
Mark one parameter field.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit PaSet SelWP LstWP Back Next Cmds Canc
We will set global parameters to see what they are.

65. Load Parameters Enter LOAD parameters
02:10: ***** Natural Object Handler *****
User SAJGB Load Parameters -
Parameter Check Value New Value
Object name _________________________________ ________________________________
Library .... _________ ________
Date/Time .. ___________ / _________ __________ / ________
User ID .... ________ ________
Terminal ID ________ ________
Lang. codes ________ ________
Error number difference (+/-nnnn) _____
FDT DBID/FNR _____ / _____ _____ / _____
System files for load:
Load FNAT: DBID _____ FNR _____ Password ________ Cipher ________ _ Select
Load FUSER: DBID _____ FNR _____ Password ________ Cipher ________ _ Select
Load NCP: DBID _____ FNR _____ Password ________ Cipher ________
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc
Load parameters are applied before objects are stored on the target(s).

66. Load Wizard, Select Load Type
Choose LOAD type
02:12: ***** Natural Object Handler *****
User SAJGB Load Wizard, Select Load Type -
Select the object type for load.
You can load all objects from the work file or you can load
objects of different object types sequentially in separate steps.
_ Load all objects from the work file
or load selected objects from the work file:
X Natural library objects only
_ Natural system error messages only
_ Natural command processor sources only
_ Natural-related objects only
_ DDMs only
_ FDTs only or
_ Use Selection or List Workplan
Mark one object type.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Back Next Cmds Canc
Default

67. Load Wizard, Natural Library Objects
Enter selection criteria
02:13: ***** Natural Object Handler *****
User SAJGB Load Wizard, Natural Library Objects -
Select Natural library objects to load.
You can load objects with different selection criteria
sequentially in separate steps.
Library *________ _ Select library
Object name *________________________________
Error number from 0001 to 9999
Details
X More detailed specification of objects
If you want to use a more detailed selection, mark Details.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit SeLib Detai Back Next Cmds Canc

68. Load Natural Library Objects, Details
Enter more selection criteria
02:14: ***** Natural Object Handler *****
User SAJGB Load Natural Library Objects, Details -
Location: Object Types:
Library *________ _ Select X Natural programming objects
X Error messages
Objects:
Object name . *________________________________
Programming Object Options:
S/C-Kind .... A (S/C/A Source/Cataloged/Any)
Natural types *______________ _ Select Natural types
Properties
_ Add/change properties for selection (date, user ID, ..)
Error Messages:
Error number to Language codes *_______
S/L-Kind .... A (S/L/A Short/Long/Any)
Exceptions
_ Add/change exception criteria for selection
Press ENTER to continue or mark Properties or Exceptions field.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit SeLib Types Prope Excep Cmds Canc

69. Load Natural Library Objects, Types
Enter more selection criteria
02:14: ***** Natural Object Handler *****
User S Select Object Types
Loc ! !
L ! Select the Natural programming object type(s) you want ! cts
! to process by marking the field before the type name, or !
! press PF7 to select all, or PF8 to deselect all fields. !
! !
Obj ! X Program X Map X Global Data Area !
O ! !
! X Subprogram X Dialog X Local Data Area !
Pro ! !
S ! X Subroutine X Text X Parameter Data Area !
N ! !
Pro ! X Helproutine _ DDM X Report !
_ ! !
Err ! X Copycode X Processor X Class !
E ! !
S ! X Function !
Exc
_ Add/change exception criteria for selection
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit All Desel Canc

70. Load Natural Library Objects, Properties
Enter more selection criteria
02:15: ***** Natural Object Handler *****
User SAJGB Load Library Objects, Properties -
Natural Programming Objects:
User ID _________
Programming mode . A (S/R/A Structured/Report/Any)
Natural version .. _________
Object Date:
X Select all objects (no date check)
_ Select objects modified between ... __________ ________ (date, time)
and ... __________ ________ (date, time)
_ Select objects modified on __________ ________ (date, time)
Object Size:
X Select all objects (no size check)
_ Select objects with size between .. __________ and __________ (bytes)
_ Select objects with size __________ (bytes)
Press ENTER to continue.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc

71. Load Natural Library Objects, Exceptions
Enter more selection criteria
02:16: ***** Natural Object Handler *****
User SAJGB Load Library Objects, Exceptions -
Location: Object Types:
Library _________ _ Select _ Natural programming objects
_ Error messages
Objects:
Object name . _________________________________
Programming Objects Options:
S/C-Kind .... _ (S/C/A Source/Cataloged/Any)
Natural types _______________ _ Select Natural types
Properties
_ Add/change properties for selection (date, user ID, ..)
Error Messages:
Error number ____ to ____ Languages ________
S/L-Kind .... _ (S/L/A Short/Long/Any)
Press ENTER to continue or mark Properties field.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit SeLib Types Prope Cmds Canc

72. Load Wizard LOAD command created by the Wizard
02:16: ***** Natural Object Handler *****
User SAJGB Load Wizard -
The following command will be processed.
To change the settings, press PF7 (Back). To confirm the settings and
to execute the command, press ENTER or PF8 (Next).
LOAD * LIB * OBJTYPE NE FMNUM 1 TONUM 9999 WHERE REPORT ZPGMSIN
Please press PF7 (Back) or ENTER/PF8 (Next).
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Save Back Next Cmds Canc
Why try to figure out how to code a direct command for batch when the wizard will do it for you?

73. Load Wizard Command has been processed
02:16: ***** Natural Object Handler *****
User SAJGB Load Wizard -
The following command will be processed.
To change the settings, press PF7 (Back). To confirm the settings and
to execute the command, press ENTER or PF8 (Next).
LOAD * LIB * OBJTYPE NE FMNUM 1 TONUM 9999 WHERE REPORT ZPGMSIN
! !
! Function completed successfully !
! Press ENTER to continue !
Press ENTER to continue.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc

74. Load Report Report (left side)
02:17: ***** Natural Object Handler *****
User SAJGB Display Load Report -
Position
Status Library Object Name Object Type S/C
Loaded ZSAJGB YEREP Program Src
Loaded ZSAJGB YEREP Program Cat
Loaded ZSAJGB YMENU Program Src
Loaded ZSAJGB YMENU Program Cat
Loaded ZSAJGB YVREP Program Src
Loaded ZSAJGB YVREP Program Cat
Bottom of data reached.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit > Cmds Canc

75. Load Report Report (middle)
02:17: ***** Natural Object Handler *****
User SAJGB Display Load Report -
Position
Type S/C DBID/FNR Date Time User Mode Size Version DDM
Src 156/ :46:29 CHNGELIB R
Cat 156/ :46:29 CHNGELIB R
Src 156/ :48:40 CHNGELIB R
Cat 156/ :48:40 CHNGELIB R
Src 156/ :47:47 CHNGELIB R
Cat 156/ :47:47 CHNGELIB R
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit < > Cmds Canc

76. Load Report Choose to unload more objects or "done"
02:19: ***** Natural Object Handler *****
User SAJGB Display Load Report -
Position
Type S/C DBID/FNR Date Time User Mode Size Version DDM
Src 156/ :46:29 CHNGELIB R
Cat
Src ! ! .2.1
Cat ! Do you want to continue the load function? ! .2.1
Cat ! _ Yes X No ! .2.1
! !
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc

77. Main Menu, Load Finished
Start a new Wizard
02:19: ***** Natural Object Handler *****
User SAJGB Main Menu -
Select the desired function:
_ Unload objects or a whole application from your Natural environment
_ Load objects or an application into your Natural environment
_ Scan work file contents
_ View objects in the Natural environment
_ Administrate the Object Handler environment,
process Workplans and direct commands
Mark this field to avoid Object Handler wizards:
_ Advanced user
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Unld Load Scan View Admin Cmds Canc

78. List Saved Report LOGON WORKPLAN -> L * *
02:19: ***** NATURAL LIST COMMAND *****
User SAJGB LIST Objects in a Library Library WORKPLAN
Cmd Name Type S/C SM Version User ID Date Time
--- *________ *__________ *__ * *______ *________ *__________ *________
__ YPGMS Text S S SAJGB :22:02
LI ZPGMSIN Text S S SAJGB :17:06
02:20:34 Text ZPGMSIN Library WORKPLAN User SAJGB
*** Load Objects ***
Processing Load File created on at 01:22
0003
0004 Library Object Name Type S/C DBID/FNR Date
0006 ZSAJGB YEREP Program Src 156/
0007 ZSAJGB YEREP Program Cat 156/
0008 ZSAJGB YMENU Program Src 156/
0009 ZSAJGB YMENU Program Cat 156/
0010 ZSAJGB YVREP Program Src 156/
0011 ZSAJGB YVREP Program Cat 156/
0012
0013 Function completed successfully.
0014
***** End of list *****
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Print Exit Prev Next < > Canc

79. Target Library
List of objects that were loaded into the target library
02:28: ***** NATURAL LIST COMMAND *****
User SAJGB LIST Objects in a Library Library ZSAJGB
Cmd Name Type S/C SM Version User ID Date Time
--- *________ *__________ *__ * *______ *________ *__________ *________
__ YEREP Program S/C R CHNGELIB :46:29
__ YMENU Program S/C R CHNGELIB :48:40
__ YVREP Program S/C R CHNGELIB :47:47
3 Objects found
Top of List.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Print Exit Sort > Canc

80. Workplans

81. Create New Workplan
02:37: ***** Natural Object Handler *****
User SAJGB Main Menu -
Select the desired function:
_ Unload objects or a whole application from your Natural environment
_ Load objects or an application into your Natural environment
_ Scan work file contents
_ View objects in the Natural environment
X Administrate the Object Handler environment,
process Workplans and direct commands
Mark this field to avoid Object Handler wizards:
_ Advanced user
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Unld Load Scan View Admin Cmds Canc

82. Create New Workplan
02:38: ***** Natural Object Handler *****
User SAJGB Administration -
In this part of the Object Handler you can administrate and
execute Workplans.
This functionality is recommended for advanced users only.
Select the desired function:
_ List the available Workplans in the Workplan library
X Create a new Workplan
_ Change the Workplan library
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit List Creat Edit Back Next ChLib Cmds Canc

83. Create New Workplan Selection Option Parameter
23:01: ***** Natural Object Handler *****
User SAJGB Create a New Workplan -
Select the type of the new Workplan:
_ Procedure
X Selection
_ List
_ Option
_ Parameter
_ Text
Mark this field for free format editing:
_ Free Format Editing
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Proce Selec List Optio Param Text Cmds Canc
Wizards are provided for:
Selection
Option
Parameter
Free format editors are provided for:
Procedure
List
Text
Free format editors are optional for:
Selection
Option
Parameter

84. Workplans
Procedure Sequence of fully-specified commands separated by semicolons.
Selection Selection criteria for objects used in SYSOBJH commands.
List List of objects used in SYSOBJH commands.
Option LOAD/UNLOAD options, for example, report settings used in SYSOBJH commands.
Parameter LOAD/UNLOAD parameters, for example, old name and new name used in SYSOBJH commands.
Text Text for documentation purposes.

85. Create New Workplan
Choose function that the selection criteria will be used for
23:02: ***** Natural Object Handler *****
User SAJGB Type of new Selection Workplan -
Select the function for which the new Selection Workplan
is to be used:
X Unload into work files.
_ Load/Scan work files.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Unld Load Cmds Canc

86. Create New Workplan Choose UNLOAD type
23:03: ***** Natural Object Handler *****
User SAJGB Select Unload Type -
Select the object type for unload:
X Natural library objects
_ Natural system error messages
_ Natural command processor sources
_ Natural-related objects
_ DDMs
_ FDTs
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc

87. Create New Workplan Enter selection criteria
23:03: ***** Natural Object Handler *****
User SAJGB Unload Natural Library Objects -
Objects:
Process objects: Programming Objects and Error Messages
DBID/FNR _____ / _____ _ Select DBID/FNR
Password/Cipher /
Library YSAJGB___ _ Select library
Object name ... Y*_______________________________
Error number to
Details
X More detailed specification of objects
Specify selection data or mark Details field and press ENTER to continue.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit SeLib DBIDs Detai Cmds Canc

88. Create New Workplan Enter more selection criteria
23:05: ***** Natural Object Handler *****
User SAJGB Unload Natural Library Objects, Details -
Location: Object Types:
Library YSAJGB___ _ Select X Natural programming objects
DBID/FNR .... _____ / _____ Error messages
Passw./Ciph /
Objects:
Object name . Y*_______________________________
_ Use Predict set Set number __ Set user ________
Programming Object Options:
S/C-Kind .... A (S/C/A/W/B Source/Cataloged/Any/Stowed/Both)
Natural types P______________ _ Select Natural types
Properties
_ Add/change properties for selection (date, user ID, ..)
Error Messages:
Error number ____ to ____ Language codes *_______
S/L-Kind .... A (S/L/A Short/Long/Any)
Exceptions
_ Add/change exception criteria for selection
Press ENTER to continue or mark Properties or Exceptions field.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit SeLib Types Prope Excep Cmds Canc

89. Create New Workplan Enter name of workplan
23:06: ***** Natural Object Handler *****
User SAJGB Save Workplan -
Enter the name and the description of the new Workplan:
Workplan name UNLDY _
Workplan description Unload Y* programs (no other types) from YSAJGB.__
__________________________________________________
Enter Workplan name and description.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc

90. Create New Workplan
Contents of selection workplan in library WORKPLAN.
23:14:45 Text UNLDY Library WORKPLAN User SAJGB
0001 TYPE SELECTION /* VERSION=03.01 NATURAL VERSION= PL=2 AUTHOR=SAJGB
0002 /* Unload Y* programs (no other types) from YSAJGB.
0003 Y* LIB YSAJGB OBJTYPE N NATTYPE P
***** End of list *****

91. Unload using Selection Workplan

92. Unload Using Selection Workplan
Go through Unload Wizard screens until you get to this screen.
23:09: ***** Natural Object Handler *****
User SAJGB Unload Wizard, Select Unload Type -
Select the object type for unload.
You can unload objects of different object types sequentially
in separate steps.
Natural library objects only
_ Natural system error messages only
_ Natural command processor sources only
_ Natural-related objects only
_ DDMs only
_ FDTs only or
X Use Selection or List Workplan
Mark one object type.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Back Next Cmds Canc

93. Unload Using Selection Workplan
Enter selection workplan
Parameter and option screens are used as before until …
23:10: ***** Natural Object Handler *****
User SAJGB Unload Wizard, Selection or List -
Enter name of List or Selection Workplan to unload objects.
You can unload objects with different selection criteria
sequentially in separate steps.
Name .... UNLDY___ _ List Workplan
_ Select Workplan
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Li-WP SelWP Back Next Cmds Canc

94. Unload Using Selection Workplan
Command created by the Wizard
23:11: ***** Natural Object Handler *****
User SAJGB Unload Wizard -
The following command will be processed.
To change the settings, press PF7 (Back). To confirm the settings and
to execute the command, press ENTER or PF8 (Next).
UNLOAD ( UNLDY ) WHERE REPORT
Please press PF7 (Back) or ENTER/PF8 (Next).
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Save Back Next Cmds Canc

95. Unload Using Selection Workplan
Unload completed
23:11: ***** Natural Object Handler *****
User SAJGB Unload Wizard -
The following command will be processed.
To change the settings, press PF7 (Back). To confirm the settings and
to execute the command, press ENTER or PF8 (Next).
UNLOAD ( UNLDY ) WHERE REPORT
! !
! Function completed successfully !
! Press ENTER to continue !
Press ENTER to continue.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Cmds Canc

96. Unload Using Selection Workplan
Report (left side)
23:12: ***** Natural Object Handler *****
User SAJGB Display Unload Report -
Position
Status Library Object Name Object Type S/C
Unloaded YSAJGB YEREP Program Src
Unloaded YSAJGB YEREP Program Cat
Unloaded YSAJGB YMENU Program Src
Unloaded YSAJGB YMENU Program Cat
Unloaded YSAJGB YVREP Program Src
Unloaded YSAJGB YVREP Program Cat
Bottom of data reached.
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit > Cmds Canc

97. Batch

98. Batch Tips
You can code SYSOBJH direct commands by hand or you can stop by my house and re-pave my driveway.
Create direct commands on-line using the SYSOBJH Wizards, then cut-and-paste them into your batch JCL.
Use workplans to create repeatable selection criteria, commands, parameters, and options.
Prior to Natural I004, you either (1) got a report printed and stored in workplan library or (2) no report at all. Natural I004 added the option BATCHREPORT -- which will cause a report to be printed, but not to be stored in the workplan library.

99. Batch Tips
Statistics
Prior to Natural 4.2.1, batch did not produce any statistics.
As of Natural 4.2.2, statistics can be printed using the DISPLAY STATISTICS command.
Example.
//CMSYNIN DD *
SYSOBJH UNLOAD ( UNLDY ) WHERE REPORT
DISPLAY STATISTICS
STOP
Produces statistics shown on the following slide.

100. Batch Tips
Statistics
Total number of objects Work file records
Natural libraries
Natural source objects Natural cataloged objects
Natural sources replaced Natural cataloged replaced
Natural sources not replaced Natural cat. not replaced
Cat. subroutines rejected
Error messages
Short error messages Long error messages
Error messages replaced Long error messages rejected
Error messages not replaced
Command Processor sources
Cmd. processors replaced Cmd. processors not replaced
External objects
External objects replaced External obj. not replaced
Natural-related objects
Related objects replaced Related obj. not replaced
Adabas FDTs
Adabas FDTs replaced Adabas FDTs not replaced

101. Batch Input The following four command sets unload the same objects.
SYSOBJH UNLOAD ( UNLDY ) WHERE REPORT
STOP
FIN
Using Selection Workplan (command was copied-and-pasted from the UNLOAD Wizard).
SYSOBJH UNLOAD Y* LIB YSAJGB OBJTYPE N WHERE REPORT
STOP
FIN
"SYSOBJH" and UNLOAD command on command line.
SYSOBJH
UNLOAD YMENU LIB YSAJGB OBJTYPE N WHERE REPORT
UNLOAD YEREP LIB YSAJGB OBJTYPE N WHERE REPORT
UNLOAD YVREP LIB YSAJGB OBJTYPE N WHERE REPORT
STOP
FIN
"SYSOBJH" and UNLOAD commands on separate lines.
Commands were partially copied from the UNLOAD Wizard, then manually modified.
SYSOBJH
UNLOAD YMENU LIB YSAJGB OBJTYPE N %
WHERE REPORT
UNLOAD YEREP LIB YSAJGB OBJTYPE N WHERE REPORT
UNLOAD YVREP LIB YSAJGB OBJTYPE N WHERE REPORT
STOP
FIN
SYSOBJH direct command on separate line can be continued.
WHERE clause sets options.

102. Batch Input NATUNLD and SYSOBJH commands are not compatible.
NEXT NATUNLD
Input Command Data or '.' to exit ...
DATA UNLOAD ALL YMENU FROM YSAJGB TO ZSAJGB
00:27: ***** NATURAL NATUNLD UTILITY *****
User SAJGBOBJ Unload Programming Objects -
Object Object Src Vers. Target Source Date and Time User ID
Name Type Cat Level Library DBID/FNR of Save or Cat
YMENU Program Src ZSAJGB / :48:40 SAJGB
YMENU Program Cat ZSAJGB / :48:40 SAJGB
NEXT SYSOBJH
Input Command Data or '.' to exit ...
DATA UNLOAD ALL YMENU FROM YSAJGB TO ZSAJGB
Page
SYSOBJH: Error occurred during direct command processing!
Error: 8012
Unknown object to process.
Processing 'YMENU'.
Error detected in OCNCMDIN.
SYSOBJH terminates with condition code 40

103. Options Clause WHERE REPORT saves reports in workplan library.
See documentation for more options.
SYSOBJH UNLOAD ( UNLDY ) WHERE REPORT
STOP
FIN
Since no member name is specified, the member name will be created by SYSOBJH.
01:08: ***** NATURAL LIST COMMAND *****
User SAJGB LIST Objects in a Library Library WORKPLAN
Cmd Name Type S/C SM Version User ID Date Time
*_ *__________ *__ * *______ *________ *__________ *________
LI Text S S SAJGBOBJ :27:12
LI Text S S SAJGBOBJ :27:12

104. Options Clause WHERE REPORT saves reports in workplan library.
01:11:50 Text Library WORKPLAN User SAJGB
0001 NYEREP YSAJGB S/C P :46:29S
0002 NYMENU YSAJGB S/C P :48:40S
0003 NYVREP YSAJGB S/C P :47:47S
***** End of list *****
01:12:19 Text Library WORKPLAN User SAJGB
*** Unload Objects ***
0002
0003 Library Object Name Type S/C DBID/FNR Date
0005 YSAJGB YEREP Program Src 156/
0006 YSAJGB YEREP Program Cat 156/
0007 YSAJGB YMENU Program Src 156/
0008 YSAJGB YMENU Program Cat 156/
0009 YSAJGB YVREP Program Src 156/
0010 YSAJGB YVREP Program Cat 156/
0011
0012 Function completed successfully.
0013
***** End of list *****

105. Natural Object Handler – Basic Topics (SYSOBJH)
The End