CHGWSGA (Change Workstation Gateway Attributes)

Purpose

The Change Workstation Gateway Attributes (CHGWSGA) command is used to change configurable 5250/Hypertext Markup Language (HTML) Workstation Gateway (WSG) attributes. The changes take effect the next time the WSG server is started either by the Start TCP/IP (STRTCP) command or by the Start TCP/IP Server (STRTCPSVR) command.

Restrictions: You must have *IOSYSCFG special authority to use this command.

Optional Parameters

AUTOSTART Specifies whether to autostart the Workstation Gateway server when TCP/IP is started by the STRTCP command. When the Workstation Gateway is started by the STRTCPSVR command, this parameter is ignored and the Workstation Gateway server is started regardless of the value of this parameter. If the Workstation Gateway server has already been started, any subsequent STRTCPSVR requests for Workstation Gateway are ignored.

*SAME: The value of AUTOSTART does not change if it was previously set. Otherwise, *NO is used.

*NO: Do not start the Workstation Gateway server when the STRTCP command is run. If you do not intend to use the Workstation Gateway, set this parameter to *NO.

*YES: Start the Workstation Gateway server when the STRTCP command is issued.

NBRCLT Specifies the number of client sessions that each Workstation Gateway server job will handle. The number of Workstation Gateway server jobs is managed internally to ensure that at least 15 to 20 client sessions are always available for use. This allows the number of server jobs to either increase or decrease depending on the activity for the Workstation Gateway at a given time, in order to maintain the 15 to 20 client session availability.

*SAME: The NBRCLT value does not change if it was previously set. Otherwise, 20 is used.

*DFT The number of clients per server job is set to the default value of 20.

number-of-clients: Each Workstation Gateway server job will handle this number of client sessions. The valid range is 1 through 50 clients per server job.

INACTTIMO Specifies the number of minutes the system allows a Workstation Gateway session to remain inactive before it is ended. When a WSG session is inactive longer than the specified length of time, it is ended.

Note: It may take the system an additional 1 to 120 seconds to end the inactive session.

*SAME: The timeout value does not change if it was previously set; otherwise, 10 minutes is used.

*DFT: The timeout value is set to the default of 10 minutes.

inactivity-timeout: Specify an inactive timeout period in minutes. The valid range is 0 through 60 minutes. A value of zero means that there is no timeout.

DTARQSTIMO Specifies the number of seconds the system allows a WSG session to wait from the time a WSG client connects to the time all the request data is received by the WSG session from the client.

*SAME: The timeout value does not change if previously set. Otherwise, 10 seconds is used.

*DFT: The timeout value is set to the default of 10 seconds.

data-request-timeout: Specify an data request timeout period is seconds. The valid range is 1 through 1200 seconds.

DSPSGN Specifies whether to allow the AS/400 Sign On panel to be displayed when a Workstation Gateway request comes in from a World Wide Web (WWW) browser.

Note: The WSG server only recognizes generic, default AS/400 sign-on panels. Customized sign-on panels may or may not be recognized. If you want to use the display sign on option and your sign-on screen is customized, you will need to test this function to ensure that it works. If the WSG server does not recognize your sign-on panel, you may want to use the default sign-on panel to make this work.

*SAME: The display sign-on value that was previously set does not change; otherwise, *NO is used.

*NO: Do not display the AS/400 Sign On Panel.

*YES: Display the AS/400 Sign On Panel.

ACCLOG Specifies whether or not all accesses to the Workstation Gateway will be logged. If *YES is specified, access log records will be placed in physical file QATMTLOG in library QUSRSYS.

*SAME: The value does not change if it was previously set; otherwise, *NO is used.

*NO: No access logging will be done.

*YES: All access to the Workstation Gateway will be logged.

TOPBNRURL Specifies what Universal Resource Locator (URL) should be used to display information on the top of the World Wide Web (WWW) browser display. The default is to have no top banner URL.

*SAME: The TOPBNRURL value does not change if it was previously set. Otherwise, *NONE is used.

*NONE: No top banner URL is specified.

top-banner-URL: Specifies what URL to use for the top banner.

BOTBNRURL Specifies what Universal Resource Locator (URL) should be used to display information on the bottom of the World Wide Web (WWW) browser display. The default is to have no bottom banner URL.

*SAME: The BOTBNRURL value does not change if it was previously set. Otherwise, *NONE is used.

*NONE: No bottom banner URL is specified.

bottom-banner-URL: Specifies what URL to use for the bottom banner.

HLPPNLURL Specifies the Universal Resource Locator (URL) to be used to display the help for the Workstation Gateway server.

*SAME: The HLPPNLURL value does not change if it was previously set. Otherwise, *NONE is used.

*NONE: No help panel URL is specified.

help-panel-URL: Specifies what URL to use to access help for the Workstation Gateway server.

CCSID If the character set and code page are not identified in the MIME header from the World Wide Web (WWW) browser, this value is used to determine the ASCII coded-character set identifier (CCSID) value to be used for translations when doing ASCII-to-EBCDIC and EBCDIC-to-ASCII mapping. Mapping is determined using the MIME header values or the specified ASCII CCSID and the EBCDIC default CCSID of the job.

Outgoing and incoming mapping can optionally be done with mapping tables defined in the TBLWSGOUT and TBLWSGIN parameters. Normally the TBLWSGOUT and TBLWSGIN parameters are set to the default of *CCSID or *DFT, with both indicating that the value used in the CCSID parameter is used for mapping.

If a mapping table is to be used for outgoing mapping, a table object can be specified in the TBLWSGOUT parameter. Then this table object is used for outgoing mapping instead of the CCSID value.

Incoming mapping can be changed to use a mapping table in the same manner by specifying a table object in the TBLWSGIN parameter. This mapping table would then override the specified CCSID value and be used for incoming mapping.

*SAME: The CCSID value that was previously set does not change; otherwise, 00819 (ISO 8859-1 8-bit ASCII) is used.

*DFT: The CCSID value is 00819 (ISO 8859-1 8-bit ASCII).

CCSID-value: The requested CCSID value is used. This value is validated to ensure a valid ASCII CCSID has been requested.

TBLWSGOUT Specifies the table object that is to be used to map all outgoing server data in WSG. Outgoing server data is mapped from EBCDIC to ASCII.

If a table object is specified for the TBLWSGOUT parameter, the table object is used for outgoing mapping. Otherwise, the CCSID parameter is used to determine outgoing mapping.

*SAME: The TBLWSGOUT value does not change if it was previously set; otherwise, *CCSID is used.

*CCSID: The CCSID parameter is used to determine outgoing mapping.

*DFT: The CCSID parameter is used to determine outgoing mapping.

The name of the outgoing mapping table can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

outgoing-mapping-table: Specify the table object to be used for mapping the outgoing WSG server data.

TBLWSGIN Specifies the table object that is used to map all incoming server data in WSG. Incoming server data is mapped from ASCII to EBCDIC.

If a table object is specified for the TBLWSGIN parameter, the table object is used for incoming mapping. Otherwise, the CCSID parameter is used to determine incoming mapping.

*SAME: The TBLWSGIN value does not change if it was previously set; otherwise, *CCSID is used.

*CCSID: The CCSID parameter is used to determine incoming mapping.

*DFT: The CCSID parameter is used to determine incoming mapping.

The name of the incoming mapping table can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

incoming-mapping-table: Specify the table object to be used for mapping the incoming WSG server data.

Examples

Example 1: Changing the Workstation Gateway attributes to automatically Start the WSG Server when the Start TCP/IP (STRTCP) CL command is issued.

CHGWSGA AUTOSTART(*YES)

This command indicates that the next time the STRTCP command is issued to start up TCP/IP and to automatically start the TCP/IP applications, the WSG server will be automatically started.

Example 2: Changing the WSG Attributes have each Workstation Gateway server job handle up to 30 client sessions.

CHGWSGA NBRCLT(30)

This command indicates that the next time WSG is started that each Workstation Gateway server will handle up to 30 client sessions.

Example 3: Using the WSG Server Mapping Tables

CHGWSGA TBLWSGOUT(*LIBL/TSTWSGO) TBLWSGIN(*LIBL/TSTWSGI)

This command indicates that the next time the WSG server is started, the server has the following characteristics:

° The ASCII-to-EBCDIC and EBCDIC-to-ASCII conversion is not done with a CCSID value, but instead the outgoing and incoming mapping tables are used.

° A copy of the information found in the table object named TSTWSGO is used for mapping outgoing data in WSG. The table object is found in one of the libraries in the library list.

° A copy of the information found in the table object named TSTWSGI is used for mapping incoming data in WSG. The table object is found in one of the libraries in the library list.