Commands › YSTRW2ESVR - Start Web Option Server › Parameters

Parameters

The following are Web Option server (YSTRW2ESVR) parameters:

W2ELIB (Web Option library)

Specifies the Web Option product library processed by the server job.

Y2WEB

The Web Option server is started and processes the default Y2WEB Web Option product library.

library-name

Specifies a Web Option product library

AUDIT (Audit type)

The Web Option router program writes audit data when the Web Option jobs starts and finishes or when errors occur during the running of those jobs. Audit data can be used to see who accessed the IBM i using the Web Option, when they accessed the IBM i and how they accessed the IBM i.

*FILE

Audit data is written to the Web Option Audit file YW2EAUDP. Data is written to this file sequentially, but it can be viewed in a number of ways using the various logical files built over YW2EAUDP.

*MSGQ

Audit data is written to the Web Option server message queue WEB2E_SVR as individual messages.

*NONE

No audit data is written.

CLEAR (Clear audit record)

Specifies whether any previous audit data is cleared prior to new audit data being written by this Web Option server job.

*NO

Audit data written by this job is appended to audit data from any previous Web Option server jobs.

*YES

Audit data from previous Web Option server jobs is deleted.

RESTART (Restart Web Option server)

Specifies whether the Web Option environment should be restarted. Restarting the Web Option environment causes the Web Option server and auditor jobs to re-initialize themselves with the latest control values and skeletons: it does not affect any Web Option client jobs that are currently running. These jobs continue to run, although they use any changed control values.

When the Web Option environment restarts, the following data is re-initialized.

The object groups within the MLS Syntax file that are used by both the MLS generator and by the JIT processor are reloaded from file. These object groups are: *HTTP, *HTML, *HEAD, *BODY, *HEADER, *FOOTER, and *BODYEND, plus any linked object groups.

All Web Option control values are reloaded from file.

Note: A change to the YNBRSVR Web Option control value takes effect only when the Web Option server is started with RESTART(*NO) .

*NO

The Web Option server is started as normal.

*YES

If a Web Option server is currently running, it is re-initialized using any changed control values and skeletons. If a Web Option server is not currently running, it is started as normal.

INSTVALS (Instance Start up Value)

Specifies additional startup values to be used for this Web Option server instance. These values are used to override any control values defined for this Web Option environment.

Note: These Instance startup values remain in effect until the Web Option server instance is ended using the End Web Option Server (YENDW2ESVR) command or until it is restarted using the Start Web Option Server (YSTRW2ESVR) command specifying RESTART(*YES) and with either INSTVALS(*DEFAULT) or a non-blank INSTVALS parameter value.

Specify the instance startup values using the following format:

INSTVALS('-name value -name value')

-name

Defines the 7-character name of a Web Option control value in lower case and immediately preceded by a minus-sign.

value

Defines the override value to use for this Web Option server instance.

Specify multiple Instance startup values, with each name/value pair separated by blanks. For example:

INSTVALS('-ynbrsvr 1 -yurltyp *ABSOLUTE -yrtrmwt 30')

Any Web Option control value not specified in the INSTVALS parameter uses its default value stored in the YW2EVALRFP file. Invalid or nonexistent values are ignored.

Note: The YDFTTTL and YDFTUSR Web Option control values cannot be overridden using the INSTVALS parameter. The YNBRSVR Web Option control value is ignored if RESTART(*YES) is also specified.

blank-value

If RESTART(*YES) is specified, any instance startup override values that are currently in effect will remain in effect. If RESTART(*NO) is specified, the Web Option server starts using default values.

*DEFAULT

If RESTART(*YES) is specified, any instance startup override values that are currently in effect are cleared and the Web Option server instance is restarted using default values. If RESTART(*NO) is specified, the Web Option server starts using default values.

instance-startup-values

Specifies a string of one or more instance startup name/value pairs. These values overwrite all values specified for the INSTVALS parameter in a previous invocation of the Start Web Option Server (YSTRW2ESVR) command and override the default values for the specified Web Option control values for the Web Option server instance.