This function is used to maintain Object Handler Workplans.
For information on Workplans and the syntax that applies, refer to the sections Workplans and Direct Commands.
The Object Handler provides the option to use the administration wizard which determines the processing sequence, or to use the administration function for advanced users.
Note that you can set the default library for Workplans by using the Workplan-Library entry of the Profile option. See also the section Profile Settings.
Note:
The administration wizard offers a restricted set of
administration functions that does not provide the option to create, modify,
delete, export or import Workplans. To get the full set of administration
functions, activate advanced-user mode.
This section covers the following topics:
The administration wizard provides the Next and Back command buttons to navigate between the windows (steps). Use the Cancel command button to cancel the processing sequence.
To invoke the administration wizard
In the Welcome to the Natural Object Handler window, remove the mark from the Advanced user check box if required (not selected by default) and choose the Administration button.
The Administration Wizard window appears.
Instructions for using the functions provided in the Administration Wizard window are explained in the following section:
This function is used to list the contents of all Workplans that are available in the Workplan library.
To list and check Workplans
In the initial Administration Wizard window, choose List and Check Workplan.
A window appears with the text boxes Workplan Name and Workplan Type.
Enter the name of a Workplan.
Or:
From the drop-down list box, choose a name from the list of
Workplans available.
Choose the Next command button.
A window appears with the contents of the Workplan specified.
Choose the Next command button.
The Object Handler checks the syntax and displays the result.
Note that this step does not apply to Workplans of the types TEXT and LIST.
Choose the Next command button.
The initial Administration Wizard window appears.
In the initial Administration Wizard window, choose Start Object Handler command procedure.
A window appears with the Procedure name text box.
Enter the name of a Workplan of the type PROCEDURE.
Or:
From the drop-down list box, choose a name from the
list of all Workplans available.
Choose the Next command button.
A window appears with the contents of the Workplan specified.
Choose the Next command button.
The Object Handler executes the command procedure and displays the result.
Choose the Next command button.
The initial Administration Wizard window appears.
For instructions, see the corresponding function Change Workplan Library described in Advanced User Administration.
To invoke the administration function in advanced-user mode
In the Welcome to the Natural Object Handler window, select the Advanced user check box and choose the Administration button.
The Administration window appears with a table of all Workplans available in your Workplan library (see also Change Workplan Library below).
The following columns are provided:
| Column | Explanation |
|---|---|
| Name | The name of the Workplan. |
| Type | The type of Workplan: see Types of Workplan in the section Workplans. |
| Description | The description of the Workplan. |
| User | The ID of the user who last modified the Workplan. |
| Date | The date and time of the last modification. |
If the Workplan library does not contain any Workplan, the table is empty.
To terminate the administration function in advanced-user mode
From the Object menu, choose Close.
Or:
Choose the standard Windows close button.
This section covers the following topic:
Listed below are the options provided in the Workplan table, along with explanations and instructions on how to apply them to a Workplan:
| Option | Explanation/Instruction |
|---|---|
|
Sorts Workplans by the columns Name, Type, Description, User or Date. Select the entire column by which you want to sort the table and double-click on this column. Alternatively, select the column by which you want to sort the table and, from the context or Edit menu, choose Sort Objects. |
|
|
Creates a new Workplan. From the Object menu, select New Workplan and the type of Workplan. Depending on the editing option chosen by selecting or not selecting Free Format Editing from the Options menu, the following applies:
For information on the syntax used, see the section Direct Commands. |
|
|
Modifies an existing Workplan. Select the Workplan required and double-click on it. Alternatively, select the Workplan required and, from the context or Object menu, choose Edit. |
|
| Selects and opens a Workplan from a list of all Workplans
available.
From the Object menu, choose Open Workplan and, in the Workplan window, enter the name of a Workplan or select a Workplan from the drop-down list box. In the window provided, you can edit the Workplan. For information on the syntax used, see the section Direct Commands. |
|
|
Deletes a Workplan. Select the Workplan required and, from the context or Object menu, choose Delete. |
|
|
Verifies that the correct syntax is used in a Workplan. Select the Workplan required and, from the context or Object menu, choose Check. Note that the Check option does not apply to Workplans of the type TEXT or LIST. |
|
|
Executes a Workplan of the type PROCEDURE. Select the Workplan required and, from the context or Object menu, choose Execute. |
|
|
Imports a Workplan into the file system. Select any Workplan and, from the context or Object menu, choose Import. |
|
|
Exports a Workplan from the file system. Select one or more Workplans and, from the context or Object menu, and choose Export. |
This function is used to change the Workplan library. All Workplans must be stored in a Workplan library, as otherwise Workplans cannot control data processing, such as the function Select OPTION Workplan.
This section covers the following topics:
To change the Workplan library in a local environment
From the Actions menu, choose Change Workplan Library.
Or:
Using the administration wizard, in the initial
Administration window, select the option button
Change Workplan library and then choose the
Next command button.
A window appears with the following items:
Enter or select the data required.
Choose the OK command button.
Or:
Using the administration wizard, choose the
Next command button.
The Workplan library has been changed, and the window appears from where the function Change Workplan Library was invoked (for the administration wizard, this is the initial Administration window).
In remote environments, the function Change Workplan Library also provides the option to specify permanent files for reports, traces and restarts of load functions (see also the sections Tools and Restart Load).
In remote environments, report, trace and restart data is written to Natural objects (members) of the type Text in the Workplan library. The Object Handler assigns them temporary names and automatically deletes them after two days. When using Change Workplan Library with the Use permanent text member check box selected, data can be stored in permanent text members that are kept until overwritten by new data or intentionally deleted by the user.
To change the Workplan library in a remote environment and specify
permanent record files
In the initial Administration window, choose the option button Change Workplan library.
A window appears with the following items:
| Item | Explanation |
|---|---|
| Library | See Library above. |
| DBID | See DBID above. |
| FNR | See FNR above. |
| Password | The Adabas password of the Adabas file where the Workplan library is located. |
| Cipher key | The Adabas cipher code of the Adabas file where the Workplan library is located. |
| Work file text members | To specify a text member for storing report, restart or
trace data, select the relevant Use permanent text member
check box and enter the name of a Natural object of the type Text in the
corresponding text box:
For report data, see also
Reports in the
section Tools. |
Enter the data required and confirm your changes by choosing the OK command button or by choosing ENTER.
