Download presentation
Presentation is loading. Please wait.
Published byAshlie Chandler Modified over 10 years ago
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
Similar presentations
© 2025 SlidePlayer.com Inc.
All rights reserved.