Templates

You can use the Templates tab of Software Services to work with software services templates. The templates can be used to provision z/OS software.

Templates

Basic properties of the software services templates are shown in a table. You can display additional information for a template with the View action.

Domain administrators can use View By Domain to control which templates are included in the table. Select a domain from the list to cause the table to include just the templates that are associated with that domain. This control is displayed only if you are an administrator for one ore more domains.

For a description of the columns in the table, see Columns in the Templates table. For a description of the actions that you can take for templates, refer to Actions for templates.

Columns in the Templates table

Table 1. Columns in the Templates table
Column	Description
Template Name	Name of the template.
Version	Version of the template.
State	State of the template, which might indicate actions that are required. A Draft Pending Approval state indicates that the template has approval records that must be approved. A Draft Missing Required Approver state indicates that a runAsUser element in a definition file has no approval elements. To continue, either: Edit the definition using the Workflow Editor task, and add an approver. Add a domain approver, with the Resource Management task. A Pending Security Update state indicates that security permissions are being processed. No requests are allowed against the entry while it is in this state, so some actions might be disabled. When the security update is complete, the state changes. Click Refresh to see the change. A Security Update Failed state indicates that a failure occurred in processing security permissions.
Software Type	Type of software, for example DB2 or MQ.
Domain	Domain that the template is associated with.
Description	Description of the template.
Last Modified	Time and date that the template was last modified.
Created On	Time and date that the template was created.
Created By	User ID of the user who created the template.

Actions for templates

The actions are described in the following tables:

General actions. Actions that apply to templates. No selection is required. See Table 2.
Targeted actions. Actions that apply to the selected items. To use a targeted action, you must select one or more items. See Table 3.
Table actions. Actions that apply to the entire table. No selection of table items is required. See Table 4.

Table 2. General actions for the Templates table
Action	Description
Add Template	Display the Add window to add a template with associated workflow, action, and input variable definitions. This is the first step in preparing a template for use in provisioning software. You must be a domain administrator. For more information, see Defining a domain administrator.

Table 3. Targeted actions for the Templates table
Action	Description
View	Display more properties of a template, including information about variables for use with the workflow, approvers, and actions that are defined with the actions definition XML file.
Modify	Display the Modify window so that you can modify the properties of the selected template, including the workflow definition file. The template must be in one of the draft states.
Refresh Template	Refresh any workflow definition, action definition, or workflow variable input files that were modified outside of z/OSMF since the template was created. If the files were changed outside of z/OSMF, Refresh Template is required for the Publish action. If you use the Workflow Editor task to modify the files, then Refresh Template is not required. The template must be in one of the draft states.
Associate Tenant	Display the Associate Tenant pop-up window, which allows you to associate a tenant with the template, using the Resource Management task.
Approvals	Displays the Approve window for approving the pending approval records associated with the template. Pending approval records are indicated in the State column of the table.
Test Run	Display the Test Run window to test run the template. You can test run a template to confirm that it successfully creates a software services instance. The template remains open for further changes. Test Run creates a workflow, starts the workflow, and creates a software services instance in being-provisioned state. Before you use Test Run, all approval records must be approved. The template must have been added to a tenant, which you do with the Resource Management task. The template must be in a draft or draft approved state.
Publish	Publish a template.This action locks the template, preventing any further modification, and puts it in the published state. You can then use the Run action to create a software instance. Before you use Publish, all approval records must be approved. The template must be in one of the draft states, or archived. Note: If the workflow definition, action definition, or input variable files were modified since the template was created, you must use the Refresh Template action before the Publish action to use the modified files.
Run	Display the Run window to run the template. The template must be in the published state, and must have been added to a tenant, which you do with the Resource Management task. Run creates a workflow, starts the workflow, and creates a corresponding software services instance.
Create Based On	Create a new template based on an existing template. The new template has the same associated files (workflow definition, action definition, variable input, and documentation) as the original.
Create New Version	Create a new version of an existing template. The new version has the same name as the original entry, and is associated with the same domain and tenants. However, it has new source files. The version is reflected in the Version column of the templates table. The template that you create a new version of must be in the published or archived state. The new version is created in the draft state. There cannot already be a version in the draft state.
Archive	Archive a published template. The state is changed to archived. No further instances can be created from the template. Any existing instances cannot be removed. Use the Publish action to return the template to the Published state.
Remove	Remove the template or templates from the software services catalog. All system resources that were generated for the template are also removed.

Table 4. Table actions for the Templates table
Action	Description
Select All	Select all of the items in the table.
Deselect All	Clear all of the items in the table.
Configure Columns	Select the columns to display in the table, specify the order of those columns, and designate which columns are fixed in position when the table is scrolled horizontally.
Hide Filter Row	Remove the filter row from view. If the filter row is displayed in the table, the Hide Filter Row action is listed. Otherwise, the Show Filter Row action is listed.
Show Filter Row	Display the filter row. If the filter row is displayed in the table, the Hide Filter Row action is listed. Otherwise, the Show Filter Row action is listed.
Clear Sorts	Clear the sort from all of the columns in the table. When you use this action, the column defaults to a descending sort.
Clear Search	Clear the search.