
	Version 6.3.8 for OpenVMS	SEARCH CONTENTS \| PDF PAGE PDF BOOKS \| HOME UP PREV NEXT

— Tools and Utilities —

Workplans

Workplans define individual standard procedures for command execution, object selection and parameter or option settings which can be used to further automate function processing.

Workplans are Natural objects of the type Text. They are, by default, stored in the library WORKPLAN located in the current FUSER system file.

This section covers the following topics:

Creating, Selecting and Modifying Workplans
Contents of Workplans
Examples of Workplans
Referencing Workplans

Creating, Selecting and Modifying Workplans

You can use the administration function (see the relevant section) to create a Workplan, select a Workplan from a list, modify a Workplan, or change the default library for Workplans. The default library can also be changed by specifying the Workplan-Library parameter in your Object Handler profile (see Profile Settings).

Contents of Workplans

A Workplan consists of a header (generated by the Object Handler) and an associated instructional or textual part. Instructional parts contain Object Handler commands and parameter and/or option settings. Textual parts contain plain text only. Header and instructional or textual parts can contain comments (for example, the short description of the Workplan) that must start with the delimiter characters /* and are restricted to one line.

There are six types of Workplan: PROCEDURE, SELECTION, LIST, PARAMETER, OPTION and TEXT.

The table below lists the valid headers (to be entered if creating a Workplan outside the Object Handler) for the corresponding types of Workplan and describes the contents of the instructional or textual part. Additionally, it provides cross references to the clauses that apply when specifying Object Handler direct commands. The Object Handler direct commands provided are explained in the section Direct Commands.

Valid Headers	Contents	Related Topic in Direct Commands
`TYPE PROCEDURE`	An Object Handler command procedure. This Workplan can contain any combination of Object Handler commands available for PROCEDURE. Enter a sequence of commands separated by semicolons (;).	Basic Command Syntax
`TYPE SELECTION`	Selection criteria for objects. This Workplan can be used in Object Handler Workplan commands.	`select-clause`
`TYPE LIST`	A list of objects. This Workplan can be used in Object Handler Workplan commands.	`select-clause` Object List - LIST Workplan
`TYPE PARAMETER`	Parameters for the unload or load function. This Workplan can be used to change attributes for the objects to be processed such as the name of a new target library where objects are loaded. `TYPE PARAMETER` can be used in Object Handler Workplan commands.	`parameter-setting`
`TYPE OPTION`	Options for the unload or load function, for example, report settings. This Workplan can be used in Object Handler Workplan commands.	`option-setting`
`TYPE TEXT`	Comments or any other text that can be used for documentation purpose.	Not applicable

Examples of Workplans

The following table lists examples of instructional parts contained in a Workplan.

Workplan Type	Instruction	Explanation
PROCEDURE	`FINDLIB * LIB TEST`	Check whether the library TEST exists.
PROCEDURE	`UNLOAD A* LIB TEST`	Unload from the library TEST into Work File 1 all Natural programming objects and shared resources starting with `A`, and all user-defined error messages; write the report into Work File 4.
SELECTION	`* LIB TEST`	Process all objects from the library TEST.
TEXT	`This is a Workplan comment.`	Any text.

This section covers the following topic:

Example of Workplan Contents

Example of Workplan Contents

The following is an example listing of a PROCEDURE Workplan where the UNLOAD command is executed:

TYPE PROCEDURE /* VERSION=03.01 NATURAL VERSION=04.02.01 PL=0 AUTHOR=SAG DATE=2006-07-20 09:40:12
/* unload from library TEST with target library PROD01       
UNLOAD * LIB TEST OBJTYPE N                                  
WITH NEWLIBRARY PROD01                                       
WHERE REPORT MYREP01

Referencing Workplans

You can reference a Workplan by using Object Handler menu functions or direct commands (see also the section Direct Commands).

The following syntax applies when referencing a Workplan with the Object Handler direct commands described in the section Direct Commands.

( `workplan-name`
	[ `LIBRARY` `library-name` ]
	[`DBID` `dbid` [`FNR` `fnr` ] ] [`NAME` `vsam-name` ]
	[`CIPHER` `cipher` ]
		`PASSWORD` `PSW`	`password`
)

The syntactical options are explained in the following section:

Keyword Explanation

Keyword Explanation

The table below describes the keywords and values that apply to the syntax for referencing Workplans.

Keyword	Values	Default Value
`workplan-name`	The name of the Natural text member in the Workplan library to be used as the Workplan.	No default
`LIBRARY`	The name of the library where the Workplan is located.	`WORKPLAN`
`DBID`	The ID of the Adabas database where the Workplan library is located.	`0` (current FNAT/FUSER)
`FNR`	The number of the Adabas file where the Workplan library is located.	`0` (current FNAT/FUSER)
`NAME`	Only applies to objects on mainframes. The name of a valid VSAM file where the Workplan library is located.	blank (current FNAT/FUSER)
`CIPHER`	Only applies to objects on mainframes. An 8-digit cipher code.	blank (current FNAT/FUSER)
`PASSWORD`	Only applies to objects on mainframes. An 8-character Adabas password.	blank (current FNAT/FUSER)

SEARCH CONTENTS | PDF PAGE PDF BOOKS | HOME UP PREV NEXT