Creating a new service

Creating a service means associating a job stream to a service that can then be submitted from a mobile device.

1. Tap the Self-Service Catalog section to launch the application.
2. Tap the Catalogs section to display a list of available catalogs. A catalog is a container of services.
3. Tap a catalog name to open it. The Services page opens.
4. Tap Toolbar to display the editing toolbar, if it is not already shown on the screen. The editing toolbar displays at the bottom of the page.
5. Click Create to create a new service.
6. Specify the new service information, optionally associating a description to better identify it. Mandatory fields are marked by an asterisk. Optionally, specify a priority to assign this service more or less preeminence over the others. If assigned during the service creation, priority cannot be changed by TWSWEBUIAnalyst users who submit the service.
   
7. Optionally, tap Icon to view a list of all the available icons that can characterize the service. Set Enabled to No if you want to make this service inactive so that users cannot submit it until it is enabled again.
   Note: Users with TWSWEBUIAdministrator role can see and submit disabled services. Whereas, users with TWSWEBUIAnalyst role cannot see a disabled service, even if the service was associated to their role.
8. Tap Engine to open a list of available engines and choose the one on which the job stream that you want to associate to the new service is scheduled to run. The engine connection that you select must satisfy the following requirements:
   • On the Dynamic Workload Console, the engine must be shared with the Dashboard Application Services Hub groups to which all the users who create and submit the service belong.
   • The engine credentials must be shared on the Dynamic Workload Console, selecting the Share credentials check box in the Engine Connection Properties panel of the Dynamic Workload Console.
9. To search for a specific engine, pull down the page to open the Search text box and enter a string contained by the engine name you are searching for
10. Tap Job stream to open a list of job streams defined on the selected engine and choose the job stream that you want to associate to the service. To search for a specific job stream, pull down the page to open the Search text box and enter a string contained by the job stream name you are searching for.
11. Define variable validation criteria. If you are creating a service that runs on a z/OS engine, you can select a variable table by tapping Variable Table. You can then define variable validation criteria for only the promptable variables defined in the table in the Variable Validation section, and associate different series of key-value variables to the same service, making it more flexible and reusable.

    If you are creating a service that runs on a distributed engine, and the job stream selected has a variable table associated to it, then the variables defined in the table are listed in the Variable Validation section.

    See Defining variable validation criteria for more information about the criteria you can specify.

12. Save the service.
13. In the Services page, tap Roles and the service name to open the list of Dashboard Application Services Hub roles that can be associated to this service. Select only the roles that you want to authorize to see and use this service:
    
    If the new service is not associated to any role, by default it is only available to TWSWEBUIAdministrator.