optimize manage extend natural object handler – basic topics (sysobjh) james bando software ag,...

Optimize Manage Extend

NaturalNaturalObject Handler – Basic TopicsObject Handler – Basic Topics

(SYSOBJH)(SYSOBJH)

James BandoSoftware AG, Inc.

2Natural Object Handler (SYSOBJH) 20070508 Copyright 2006, 2007 Software AG, Inc.

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 WorkshopsSee http://www.softwareagusa.com/webedreg/mentoring/index.asp.

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)


General InformationGeneral Information


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.


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.


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.


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


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).


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.


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.


Choices You Must Make

1. 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.

2. What is the unload environment? Mainframe, Unix/Linux, or Windows.

3. What is the load/scan/delete/find/restart environment? Mainframe, Unix/Linux, or Windows.

4. What kind of Natural objects to be processed? Source/cataloged/either/both/STOWed objects.

5. What transfer file format is to be used? Internal (source and/or cataloged objects) or transfer (source objects).

6. What transfer file media is going to be used? Operating system file or Natural Connection file.

7. What user interface is going to be used to execute the command(s)? On-line (wizard/advanced), batch, or user-written (using OBJHAPI).


Commands

UNLOAD

[WITH ]

[WHERE ]

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

select-clause( selection workplan )

parameter-clause( parameter workplan )

options-clause( option workplan )


Commands

LOAD

[WITH ]

[WHERE ]

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)





Commands

LOADALL

[WITH ]

[WHERE ]

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)




Commands

SCAN

[WHERE ]

Scan a transfer file for selected objects. Objects that can be scanned for





Commands

SCANALL

[WHERE ]

Scan all objects on a transfer file. Objects that can be scanned for




Commands

DELETE

[WHERE ]

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




Commands

FIND

[WHERE ]

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)




Commands

FINDLIB

[WHERE ]

Find libraries in FNAT/FUSER. Objects that can be found

Natural libraries




Commands

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


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).


View Function (CUI/GUI)

View 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)


GO Function (CUI/GUI)

GO HOME (Yeah!!)

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

Go to main menu

These are

useful on-line.


SHOW Function (CUI/GUI)

SHOW STATUSDisplay workplan information, trace settings, Natural Security settings, etc.

SHOW STATISTICDisplay counts of objects processed.

SHOW LAST RESULTDisplay last return code and message.

SHOW LAST MESSAGEDisplay last unload/load/scan messages.

SHOW PROFILEDisplay SYSOBJH profile.

SHOW REPORTDisplay latest report file.

SHOW TRACEDisplay trace file.


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.


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 PROFILERead SYSOBJH profile.

COMMANDS Display list of commands.


WORK Files

WORK File 1 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. Contains the unloaded objects in transfer or internal format.

WORK File 8 Used if Entire Connection is used. 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


UnloadUnload


SYSOBJH Main Menu

Choose Unload01:13:38 ***** Natural Object Handler ***** 2006-11-26User 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.


Unload Menu

Choose if you want to enter everything or use a procedure workplan.

01:14:08 ***** Natural Object Handler ***** 2006-11-26User 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.


Unload Wizard, Options

Choose Wizard options01:15:06 ***** Natural Object Handler ***** 2006-11-26User 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---PF3- --PF9---PF10--PF11--PF12--- Help Exit Cmds Canc

Leave blank to use internal format.

Transfer format written using Unicode UTF-8.

Mark if you want to change options.Must choose one of these.

Mark to use a workplan of type OPTION. Also enter name.



Unload Options

Enter UNLOAD options01:16:03 ***** Natural Object Handler ***** 2006-11-26User 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 Cipher 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.Mark to clear report member

and start new report.Writes report to member

in workplan library.

Enter report member name or select from list.

Choose other options as desired


Unload Wizard, Parameters

Choose whether or not to use UNLOAD parameters01:17:26 ***** Natural Object Handler ***** 2006-11-26User 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

We will set global parameters to see what they are.

Must choose one of these.


Unload Parameters

Enter UNLOAD parameters01:17:52 ***** Natural Object Handler ***** 2006-11-26User 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'.


Unload Wizard, Select Unload Type

Choose UNLOAD type01:19:15 ***** Natural Object Handler ***** 2006-11-26User 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


Unload Wizard, Natural Library Objects

Enter selection criteria01:19:35 ***** Natural Object Handler ***** 2006-11-26User 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


Unload Natural Library Objects, Details

Enter more selection criteria01:20:15 ***** Natural Object Handler ***** 2006-11-26User 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 0001 to 9999 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)


Unload Natural Library Objects, Types

Enter more selection criteria01:20:15 ***** Natural Object Handler ***** 2006-11-26User 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


Unload Natural Library Objects, Properties

Enter more selection criteria01:20:52 ***** Natural Object Handler ***** 2006-11-26User 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


Unload Natural Library Objects, Exceptions

Enter more selection criteria01:21:07 ***** Natural Object Handler ***** 2006-11-26User 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

allexception

criteria arenot

processed.


Unload Wizard

UNLOAD command created by the Wizard01:21:33 ***** Natural Object Handler ***** 2006-11-26User 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.


Unload Wizard

Command has been processed01:21:33 ***** Natural Object Handler ***** 2006-11-26User 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


Unload Report

Report (left side)01:22:15 ***** Natural Object Handler ***** 2006-11-26User SAJGB - Display Unload Report - Position 1 - 78 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


Unload Report

Report (middle)01:23:20 ***** Natural Object Handler ***** 2006-11-26User SAJGB - Display Unload Report - Position 71 - 148 Type S/C DBID/FNR Date Time User Mode Size Version DDM ---- --- ----------- ---------- -------- -------- ---- -------- -------- ---- Src 156/21 2006-11-26 00:46:29 SAJGB R 112 4.2.1 Cat 156/21 2006-11-26 00:46:29 SAJGB R 3184 4.2.1 Src 156/21 2006-11-26 00:48:40 SAJGB R 523 4.2.1 Cat 156/21 2006-11-26 00:48:40 SAJGB R 2976 4.2.1 Src 156/21 2006-11-26 00:47:47 SAJGB R 114 4.2.1 Cat 156/21 2006-11-26 00:47:47 SAJGB R 3140 4.2.1 Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit < > -- - + ++ Cmds Canc


Unload Report

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


Unload Report

Choose to unload more objects or "done"01:23:45 ***** Natural Object Handler ***** 2006-11-26User SAJGB - Display Unload Report - Position 141 - 218 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


SYSOBJH Main Menu, Unload Finished

Start a new Wizard01:24:28 ***** Natural Object Handler ***** 2006-11-26User 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


List Saved Report

LOGON WORKPLAN -> L * *01:25:27 ***** NATURAL LIST COMMAND ***** 2006-11-26User SAJGB - LIST Objects in a Library - Library WORKPLAN Cmd Name Type S/C SM Version User ID Date Time --- *________ *__________ *__ * *______ *________ *__________ *________ LI YPGMS Text S S 4.2.01 SAJGB 2006-11-26 01:22:02

01:26:44 Text YPGMS Library WORKPLAN User SAJGB 2006-11-260001 *** Unload Objects *** 0002 0003 Library Object Name Type S/C DBID/FNR Date0004 -------- -------------------------------- ----------- --- ----------- ----0005 YSAJGB YEREP Program Src 156/21 20060006 YSAJGB YEREP Program Cat 156/21 20060007 YSAJGB YMENU Program Src 156/21 20060008 YSAJGB YMENU Program Cat 156/21 20060009 YSAJGB YVREP Program Src 156/21 20060010 YSAJGB YVREP Program Cat 156/21 20060011 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


List Saved Report

LOGON WORKPLAN -> L * * (cont'd)

Line ----+---80----+---90----+--100----+--110----+--120----+--130----+--140----0001 0002 0003 Date Time User ID S/R Size Version DDM DBID/FNR Status 0004 ---------- -------- -------- --- -------- -------- ------------ ----------0005 2006-11-26 00:46:29 SAJGB R 112 4.2.1 Unloaded 0006 2006-11-26 00:46:29 SAJGB R 3184 4.2.1 Unloaded 0007 2006-11-26 00:48:40 SAJGB R 523 4.2.1 Unloaded 0008 2006-11-26 00:48:40 SAJGB R 2976 4.2.1 Unloaded 0009 2006-11-26 00:47:47 SAJGB R 114 4.2.1 Unloaded 0010 2006-11-26 00:47:47 SAJGB R 3140 4.2.1 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


ScanScan


SYSOBJH Main Menu

Choose Scan01:35:29 ***** Natural Object Handler ***** 2006-11-26User 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


Scan Wizard

Choose if you want to enter everything or use a procedure workplan.

01:36:12 ***** Natural Object Handler ***** 2006-11-26User 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


Scan Wizard, Options

Choose Wizard options01:36:30 ***** Natural Object Handler ***** 2006-11-26User 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


Scan Wizard, Select Scan Type

Choose object types to SCAN01:36:49 ***** Natural Object Handler ***** 2006-11-26User 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


Scan Wizard, Command

SCANALL command created by the Wizard01:37:15 ***** Natural Object Handler ***** 2006-11-26User 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


Scan Wizard, Completion

Command has been processed01:37:15 ***** Natural Object Handler ***** 2006-11-26User 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


Scan Report

Report (left side)01:37:54 ***** Natural Object Handler ***** 2006-11-26User SAJGB - Display Scan Report - Position 1 - 78 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


Scan Report

Report (middle)01:38:26 ***** Natural Object Handler ***** 2006-11-26User SAJGB - Display Scan Report - Position 71 - 148 Type S/C DBID/FNR Date Time User Mode Size Version DDM ---- --- ----------- ---------- -------- -------- ---- -------- -------- ---- Src / 2006-11-26 00:46:29 CHNGELIB R 112 4.2.1 Cat / 2006-11-26 00:46:29 CHNGELIB R 3184 4.2.1 Src / 2006-11-26 00:48:40 CHNGELIB R 523 4.2.1 Cat / 2006-11-26 00:48:40 CHNGELIB R 2976 4.2.1 Src / 2006-11-26 00:47:47 CHNGELIB R 114 4.2.1 Cat / 2006-11-26 00:47:47 CHNGELIB R 3140 4.2.1 Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit < > -- - + ++ Cmds Canc


LoadLoad


SYSOBJH Main Menu

Choose Load02:02:01 ***** Natural Object Handler ***** 2006-11-26User 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!


Load Wizard

Choose if you want to enter selection criteria, parameters, and options or use a procedure workplan.

02:04:28 ***** Natural Object Handler ***** 2006-11-26User 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.


Load Wizard, Options

Choose Wizard options02:04:58 ***** Natural Object Handler ***** 2006-11-26User 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.



Load Options

Enter LOAD options02:06:23 ***** Natural Object Handler ***** 2006-11-26User 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.


Load Wizard, Parameters

Choose whether or not to use LOAD parameters02:10:26 ***** Natural Object Handler ***** 2006-11-26User 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.


Load Parameters

Enter LOAD parameters02:10:53 ***** Natural Object Handler ***** 2006-11-26User 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).


Load Wizard, Select Load Type

Choose LOAD type02:12:43 ***** Natural Object Handler ***** 2006-11-26User 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


Load Wizard, Natural Library Objects

Enter selection criteria02:13:59 ***** Natural Object Handler ***** 2006-11-26User 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


Load Natural Library Objects, Details

Enter more selection criteria02:14:53 ***** Natural Object Handler ***** 2006-11-26User 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 0001 to 9999 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


Load Natural Library Objects, Types

Enter more selection criteria02:14:53 ***** Natural Object Handler ***** 2006-11-26User 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


Load Natural Library Objects, Properties

Enter more selection criteria02:15:41 ***** Natural Object Handler ***** 2006-11-26User 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


Load Natural Library Objects, Exceptions

Enter more selection criteria02:16:05 ***** Natural Object Handler ***** 2006-11-26User 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


Load Wizard

LOAD command created by the Wizard02:16:33 ***** Natural Object Handler ***** 2006-11-26User 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?


Load Wizard

Command has been processed02:16:33 ***** Natural Object Handler ***** 2006-11-26User 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


Load Report

Report (left side)02:17:33 ***** Natural Object Handler ***** 2006-11-26User SAJGB - Display Load Report - Position 1 - 78 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


Load Report

Report (middle)02:17:59 ***** Natural Object Handler ***** 2006-11-26User SAJGB - Display Load Report - Position 71 - 148 Type S/C DBID/FNR Date Time User Mode Size Version DDM ---- --- ----------- ---------- -------- -------- ---- -------- -------- ---- Src 156/21 2006-11-26 00:46:29 CHNGELIB R 112 4.2.1 Cat 156/21 2006-11-26 00:46:29 CHNGELIB R 3184 4.2.1 Src 156/21 2006-11-26 00:48:40 CHNGELIB R 523 4.2.1 Cat 156/21 2006-11-26 00:48:40 CHNGELIB R 2976 4.2.1 Src 156/21 2006-11-26 00:47:47 CHNGELIB R 114 4.2.1 Cat 156/21 2006-11-26 00:47:47 CHNGELIB R 3140 4.2.1 Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit < > -- - + ++ Cmds Canc


Load Report

Choose to unload more objects or "done"02:19:01 ***** Natural Object Handler ***** 2006-11-26User SAJGB - Display Load Report - Position 71 - 148 Type S/C DBID/FNR Date Time User Mode Size Version DDM ---- --- ----------- ---------- -------- -------- ---- -------- -------- ---- Src 156/21 2006-11-26 00:46:29 CHNGELIB R 112 4.2.1 Cat +----------------------------------------------------+ .2.1 Src ! ! .2.1 Cat ! Do you want to continue the load function? ! .2.1 Src ! ! .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


Main Menu, Load Finished

Start a new Wizard02:19:27 ***** Natural Object Handler ***** 2006-11-26User 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


List Saved Report

LOGON WORKPLAN -> L * *02:19:56 ***** NATURAL LIST COMMAND ***** 2006-11-26User SAJGB - LIST Objects in a Library - Library WORKPLAN Cmd Name Type S/C SM Version User ID Date Time --- *________ *__________ *__ * *______ *________ *__________ *________ __ YPGMS Text S S 4.2.01 SAJGB 2006-11-26 01:22:02 LI ZPGMSIN Text S S 4.2.01 SAJGB 2006-11-26 02:17:06

02:20:34 Text ZPGMSIN Library WORKPLAN User SAJGB 2006-11-260001 *** Load Objects *** 0002 Processing Load File created on 2006-11-26 at 01:22 0003 0004 Library Object Name Type S/C DBID/FNR Date0005 -------- -------------------------------- ----------- --- ----------- ----0006 ZSAJGB YEREP Program Src 156/21 20060007 ZSAJGB YEREP Program Cat 156/21 20060008 ZSAJGB YMENU Program Src 156/21 20060009 ZSAJGB YMENU Program Cat 156/21 20060010 ZSAJGB YVREP Program Src 156/21 20060011 ZSAJGB YVREP Program Cat 156/21 20060012 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


Target Library

List of objects that were loaded into the target library02:28:24 ***** NATURAL LIST COMMAND ***** 2006-11-26User SAJGB - LIST Objects in a Library - Library ZSAJGB Cmd Name Type S/C SM Version User ID Date Time --- *________ *__________ *__ * *______ *________ *__________ *________ __ YEREP Program S/C R 4.2.01 CHNGELIB 2006-11-26 00:46:29 __ YMENU Program S/C R 4.2.01 CHNGELIB 2006-11-26 00:48:40 __ YVREP Program S/C R 4.2.01 CHNGELIB 2006-11-26 00: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


WorkplansWorkplans


Create New Workplan

02:37:10 ***** Natural Object Handler ***** 2006-11-26User 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


Create New Workplan

02:38:14 ***** Natural Object Handler ***** 2006-11-26User 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


Create New Workplan

23:01:39 ***** Natural Object Handler ***** 2006-11-26User 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


Workplans

ProcedureSequence of fully-specified commands separated by semicolons.

SelectionSelection criteria for objects used in SYSOBJH commands.

ListList of objects used in SYSOBJH commands.

OptionLOAD/UNLOAD options, for example, report settings used in SYSOBJH commands.

ParameterLOAD/UNLOAD parameters, for example, old name and new name used in SYSOBJH commands.

TextText for documentation purposes.


Create New Workplan

Choose function that the selection criteria will be used for23:02:27 ***** Natural Object Handler ***** 2006-11-26User 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


Create New Workplan

Choose UNLOAD type23:03:15 ***** Natural Object Handler ***** 2006-11-26User 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


Create New Workplan

Enter selection criteria23:03:29 ***** Natural Object Handler ***** 2006-11-26User 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


Create New Workplan

Enter more selection criteria23:05:20 ***** Natural Object Handler ***** 2006-11-26User 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


Create New Workplan

Enter name of workplan23:06:43 ***** Natural Object Handler ***** 2006-11-26User 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


Create New Workplan

Contents of selection workplan in library WORKPLAN.

23:14:45 Text UNLDY Library WORKPLAN User SAJGB 2006-11-26

0001 TYPE SELECTION /* VERSION=03.01 NATURAL VERSION=04.02.01 PL=2 AUTHOR=SAJGB

0002 /* Unload Y* programs (no other types) from YSAJGB.

0003 Y* LIB YSAJGB OBJTYPE N NATTYPE P

***** End of list *****


Unload using Selection Unload using Selection WorkplanWorkplan


Unload Using Selection Workplan

Go through Unload Wizard screens until you get to this screen.23:09:40 ***** Natural Object Handler ***** 2006-11-26User 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



Enter selection workplan

Parameter and option screens are used as before until …

23:10:54 ***** Natural Object Handler ***** 2006-11-26User 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



Command created by the Wizard23:11:44 ***** Natural Object Handler ***** 2006-11-26User 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



Unload completed23:11:44 ***** Natural Object Handler ***** 2006-11-26User 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



Report (left side)23:12:37 ***** Natural Object Handler ***** 2006-11-26User SAJGB - Display Unload Report - Position 1 - 78 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


BatchBatch


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 4.2.1 I004, you either (1) got a report printed and stored in workplan library or (2) no report at all. Natural 4.2.1 I004 added the option BATCHREPORT -- which will cause a report to be printed, but not to be stored in the workplan library.


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.


Batch Tips

Statistics

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


Batch Input

The following four command sets unload the same objects.

SYSOBJH UNLOAD YMENU LIB YSAJGB OBJTYPE N % WHERE REPORT UNLOAD YEREP LIB YSAJGB OBJTYPE N WHERE REPORTUNLOAD YVREP LIB YSAJGB OBJTYPE N WHERE REPORTSTOP FIN

SYSOBJH UNLOAD Y* LIB YSAJGB OBJTYPE N WHERE REPORTSTOP FIN "SYSOBJH" and UNLOAD command on command line.

SYSOBJH direct command on separate line can be continued.

SYSOBJH UNLOAD ( UNLDY ) WHERE REPORTSTOP FIN Using Selection Workplan (command was copied-and-pasted from the UNLOAD Wizard).

SYSOBJH UNLOAD YMENU LIB YSAJGB OBJTYPE N WHERE REPORTUNLOAD YEREP LIB YSAJGB OBJTYPE N WHERE REPORTUNLOAD YVREP LIB YSAJGB OBJTYPE N WHERE REPORTSTOP FIN "SYSOBJH" and UNLOAD commands on separate lines.

Commands were partially copied from the UNLOAD Wizard, then

manually modified.

WHERE clause sets options.


Batch Input

NATUNLD and SYSOBJH commands are not compatible.NEXT NATUNLD Input Command Data or '.' to exit ...DATA UNLOAD ALL YMENU FROM YSAJGB TO ZSAJGB00:27:16 ***** NATURAL NATUNLD UTILITY ***** 2006-11-27 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 4.2.1 ZSAJGB 156/21 2006-11-26 00:48:40 SAJGB YMENU Program Cat 4.2.1 ZSAJGB 156/21 2006-11-26 00:48:40 SAJGB Input Command Data or '.' to exit ...

NEXT SYSOBJH Input Command Data or '.' to exit ...DATA UNLOAD ALL YMENU FROM YSAJGB TO ZSAJGB Page 1 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


Options Clause

WHERE REPORT saves reports in workplan library.

See documentation for more options.

01:08:23 ***** NATURAL LIST COMMAND ***** 2006-11-27User SAJGB - LIST Objects in a Library - Library WORKPLAN Cmd Name Type S/C SM Version User ID Date Time --- 1002712*_ *__________ *__ * *______ *________ *__________ *________ LI 10027124 Text S S 4.2.01 SAJGBOBJ 2006-11-27 00:27:12 LI 10027125 Text S S 4.2.01 SAJGBOBJ 2006-11-27 00:27:12

SYSOBJH UNLOAD ( UNLDY ) WHERE REPORTSTOP FIN

Since no member name is specified, the member name will be created by SYSOBJH.


Options Clause

WHERE REPORT saves reports in workplan library.01:11:50 Text 10027124 Library WORKPLAN User SAJGB 2006-11-270001 NYEREP YSAJGB S/C 156 21P2006-11-2600:46:29S0002 NYMENU YSAJGB S/C 156 21P2006-11-2600:48:40S0003 NYVREP YSAJGB S/C 156 21P2006-11-2600:47:47S***** End of list *****

01:12:19 Text 10027125 Library WORKPLAN User SAJGB 2006-11-270001 *** Unload Objects *** 0002 0003 Library Object Name Type S/C DBID/FNR Date0004 -------- -------------------------------- ----------- --- ----------- ----0005 YSAJGB YEREP Program Src 156/21 20060006 YSAJGB YEREP Program Cat 156/21 20060007 YSAJGB YMENU Program Src 156/21 20060008 YSAJGB YMENU Program Cat 156/21 20060009 YSAJGB YVREP Program Src 156/21 20060010 YSAJGB YVREP Program Cat 156/21 20060011 0012 Function completed successfully. 0013 ***** End of list *****


NaturalNaturalObject Handler – Basic TopicsObject Handler – Basic Topics

(SYSOBJH)(SYSOBJH)

optimize manage extend natural object handler – basic topics (sysobjh) james bando software ag,...

Documents

transfer file objects

natural connection file

natural object handler

natural related

processing of natural

version of natural

transfer source objects

character transfer