Use the New Generation Properties wizard
to create a generation properties file for the main flow of your program.
Note: After the New Generation Properties wizard closes, Enterprise
Service Tools automatically opens the new generation properties file
in the generation properties editor so that you can edit the generation
properties.
To create a generation properties file for a flow:
Start the New Generation Properties wizard:
In the EST Project Explorer, right-click the flow for
which you want to generate a new generation properties file (for example,
MySFP_0001.seqflow).
Select .
The New Generation Properties wizard opens.
Note: Alternatively,
to start the wizard, you can follow these steps:
From the workbench's main menu, select .
The New Generation Properties wizard opens.
If you have not selected a flow, then you can specify the
flow on the first page of the wizard.
On the first page of the New Generation Properties wizard,
titled
New File:
- File name
Type the name that you want to use for the new
generation properties file. The default name is new_generation_props.sfgen.
- Description
Type a description of the generation properties file if you
wish.
- Destination project
Select the service flow project in which you want to create
the new generation properties file. The default
value is the current service flow project (the service flow project
containing the folder, subfolder, or artifact that you right-clicked
in step 1).
- Flow
Expand the list and select the flow for which you want to create
a generation properties file.
Important: - Be sure to select from the list the actual flow for which you
want to create a generation properties file.
- The list is sorted alphabetically, and therefore the item at the
top of the list is always the first item in the sort (such as AAAFlow_01.seqflow).
- Functionally the first item in the list is also the default item,
because by default the first item in the list is selected.
Caution: If you right-click a flow in Step
1, that flow is not selected by default in the list of flows. If you
click Next without selecting the actual flow
that you want to use, then the flow that you want to use is taken
to be the currently selected flow, that is the first item in the sort
(AAAFlow_01.seqflow). The result is that your new
generation properties file is filled with contents from the wrong
flow and is placed in the wrong subfolder.
- Reuse properties from most recently saved generation properties
files:
- Select this check box if you want the wizard to
set the generation properties of the flow node and the invoke nodes
in the new generation properties file to the most recently saved values
for those nodes (see Reuse properties from the most recently saved generation
properties file).
Important: This option makes
it easy for you to set the generation properties for the nodes of
an invoked flow, residing in the new generation properties file for
the main flow (for example, GPMain.sfgen),
to the same values that you have already set for the generation properties
of those same nodes residing in the generation properties file for
the invoked flow (GPInvoked01.sfgen).
- Validate flows against runtimes
If this check box is selected,
then when you
click
Next the wizard validates whether the
selected flow can be used to generate runtime code for each of the
supported runtime environments.
- This level of validation checks only whether the types of the
nodes in the selected flow are valid for each of the supported runtime
environments. A more thorough validation is done when the code is
generated for the runtime environment.
- The results of this validation display on the next page of the
wizard. If the selected flow can be used to generate code for a runtime
environment based on this level of validation, then the selection
for that runtime environment is available.
Click Next to go to the
next page.
CICS Service Flow
Runtime Levels 1.0 and 2.0
On the
Runtime
selection page, select the runtime environment for which
you want the wizard to create a generation properties file:
- CICS Service Flow Runtime: Level 1.0
- CICS Service Flow Runtime: Level 2.0
- Host Access Transformation Services
Note: If you selected the check box Validate flows
against runtimes on the previous page of the wizard, and
if the flow that you selected contains a type of node that is invalid
for a runtime environment, then the selection for that runtime environment
is disabled.
Table 1 shows
which versions of CICS® Transaction
Server for z/OS® and the CICS Service Flow Feature (Service
Flow Runtime) correspond to
CICS Service Flow Runtime:
Level 1.0 and
CICS Service Flow Runtime: Level
2.0 (also see
Supported runtime environments for each project type):
Table 1. CICS Service
Flow Runtime levels| Runtime level: |
CICS Service
Flow Feature (Service Flow Runtime): |
CICS Transaction
Server for z/OS: |
| CICS Service Flow Runtime: Level
1.0 |
- CICS Service Flow Runtime
for CICS Transaction Server
for z/OS V3.1
|
- CICS Transaction Server
for z/OS V3.1 without APAR
PK83534
|
| CICS Service Flow Runtime: Level
2.0 |
- CICS Service Flow Runtime
for CICS Transaction Server
for z/OS V3.2
|
- CICS Transaction Server
for z/OS V4.1
- CICS Transaction Server
for z/OS V3.2
- CICS Transaction Server
for z/OS V3.1 with APAR PK83534
|
Click Finish.
The following actions are performed:
The wizard creates an initial generation properties file for
the runtime environment that you selected and places the file in a
subfolder of the Generation folder
of the service flow project (see Subfolders in which generation properties files and runtime output files are stored).
The wizard then closes.
As a convenience, Enterprise Service Tools automatically opens
the new generation properties file in the generation properties editor.