Query String Options


You can specify options on the query string of the URL that initializes a Webulator/400 session to change the behavior of that interactive Webulator/400 session.

URL Syntax

The query string is specified on the initial URL after the complete Webulator/400 path has been specified. It starts with a ? followed immediately by the list of query string value pairs separated by an &. Assuming that your Webulator/400 session URL is www.xyz.com/www5250, the syntax would be like this: www.xyz.com/www5250?KEYWORD1=VALUE&KEYWORD2=VALUE.

Spaces are not allowed inside the query string, you must substitute a + for all embedding spaces.

Valid Keywords

The following query string keywords are valid:

Restrictions

The Signon Method value must be either USER ALLOWSIGNONOVERRIDE or USEAUTHENTICATION ALLOWSIGNONOVERRIDE for Webulator/400 to recognize the PGM, MENU or LIB query string keywords.

There are no restrictions on using the FIELD1 or KEYBOARD keywords.

Considerations

Care should be taken before enabling the ALLOWSIGNONOVERRIDE feature. When this feature is enabled, it allows you to override any of the initial signon values based on a HTML link. This may be useful if you wish to create a series of HTML links to some of your most popular applications but you don't want to create separate user profiles that have those applications as their initial program. In this case, you could use the query string keywords to override which application is called based on the HTML link regardless of the user profile that was used to signon. This flexibility does not come without additional security considerations. If you enable the ALLOWSIGNONOVERRIDE feature, any user that has access to that URL can also override the query string keywords to run any program that their user profile has access to. Please keep this in mind before enabling this feature.

There are no security considerations associated with the FIELD1 query string keyword. The inclusion of this keyword on the query string is the equivalent to the user typing it in themselves. They are not able to get access to any additional AS/400 programs or functions by using this feature. You may find this feature useful if you have a URL with a signon method of USER that brings up an AS/400 menu as its first screen. In this case, you would be able to create a series of HTML links to the same URL but with a different query string FIELD1 value that would automatically select the appropriate menu option for the user.

Keyboard Plugin Considerations

The KEYBOARD keyword requires the user to download and install the plugin software before being able to use this feature. The plugin is able to detect the AS/400 specific keys (e.g., Enter, Function Keys, etc) and return the screen to the AS/400 without requiring the user to press a browser submit button. Please note that this feature was added in Version 1.1a. If you are running Version 1.1, you must download and install the WBL110001 PTF available on I/NET's FTP site (FTP.INETMI.COM). Future releases of Webulator/400 may include the selection of this option in the regular configuration commands. When this happens, this keyword will be ignored if left on Webulator/400 URLs.

Please see the Keyboard Plugin section for more information about installing and configuring the Webulator/400 keyboard plugin.

Examples

The following examples are assuming that your Webulator/400 URL is www.xyz.com/www5250,.

If you would like the user to automatically start the program called MYPROG in the MYLIB library, you would use the following URL: www.xyz.com/www5250?PGM=MYPGM&LIB=MYLIB.

If you would like the user to automatically take option 1 from the menu called MYMENU in the MYLIB library, you would use the following URL: www.xyz.com/www5250?MENU=MYMENU&LIB=MYLIB&FIELD1=1.

You can also use the FIELD1 keyword to call an initial program that accepts dynamic parameters. Please be aware that in order to do this, you must give the user access to a command line which may not always be desirable for security reasons. Assume that the program MYPGM accepts parameters. You could call this program with the following URL: www.xyz.com/www5250?FIELD1=CALL+MYLIB/MYPGM+PARM('PARM1'+'PARM2').

If you would like the use the keyboard plugin, you would use the following URL: www.xyz.com/www5250?KEYBOARD=Y.