Specifying CL commands for invoking your application

Use the Specify CL Commands page to indicate the CL commands that are used to launch your application. Each CL command is an entry point into your application and is displayed as a submit button in the welcome page that the WebFacing Tool generates. You can have as many entry points as you want.

For each project, an index.jsp file is generated. The links in the index.jsp file correspond to the text that you enter in the Command label field. After your project has been deployed as a Web application, when a user clicks one of the buttons, the application is launched for browser access using the corresponding CL command.

For each command, there are the following options:
  • CL command that is used as an entry point into your application
  • Command label that is used for the button text on the invocation page
  • Invocation name that is used to uniquely identify the invocation
  • Sign on preference
Note: After the project is created you can modify these options by editing the properties for your WebFacing project or by right-clicking the CL command folder of your WebFacing project and selecting Add. This displays the Specify CL Commands dialog.

Using the Specify CL Commands page:

  1. Enter the command in the CL command field. For example, if you were calling the program ORDENTR in the library APILIB, enter the command CALL APILIB/ORDENTR . If your program requires users to enter interactive parameters, you can supply a CL command in the following format: CALL PROGRAM PARM(&PARMNAME). Using this format, an entry field will be created on the invocation page. The value the user types in this field is passed when the user clicks the invocation button for the application.
  2. Enter a label for the command in the Command label field. The text for the label becomes the text for the button users click to invoke your program. If you leave this field blank, the text you entered in the CL command field is used by default.
  3. (Optional) Depending on your requirements, enter a unique value in the Invocation name field. In general you can accept the default value that is assigned. The default values are named INV1, INV2, and so on for each command that you enter. One reason to enter a unique name is if you are using programmatic invocation with WebFacing applications. Programmatic invocation allows you to call WebFacing applications from other Web applications using a defined set of arguments. One of the arguments is inv which refers to the invocation name of your CL command. If you have an application that is using programmatic invocation and you require a specific name for the inv argument, enter that name in the Invocation name field.
  4. Choose sign on method. Choose Prompt for signon or Specify i5/OS signon values. If Prompt for signon is chosen, users will be prompted for a user ID and password when they use the application. If Specify i5/OS signon values is chosen, the values you enter in the User ID and Password field are submitted automatically when the user invokes the program.
    Note: Ensure that the library that contains the program object referred to by your command is available in the library list for the user ID that is used to sign on to the application.
  5. Click Add. The values you have chosen are added to the command list. If you want to change the order of the HTML links that launch your program, select one of the items in the command list and click Move Up or Move Down. If you want to delete or modify one of the commands, select the item in the command list and click Delete or Modify.

Related concepts
Introducing the WebFacing Tool
Related tasks
Opening the WebFacing perspective
Selecting the source members to convert
Choosing a Web style
Finishing the project and converting your DDS source
Analyzing the conversion logs
Related information
WebFacing Tool -- current DDS keyword support

Feedback