Managing Virtual Devices for the Client
The workstation gateway server uses virtual devices to direct output to client
devices. The AS/400 workstation gateway server support automatically selects (and
creates, if necessary) these devices for you.
Youmust allow the workstation gateway server to configure virtual controllers and
devices automatically.The QAUTOVRT system value specifies the maximum
number of devices that the system automatically configures. Use the

Change

System Value

(CHGSYSVAL) command to change the value of the QAUTOVRT
system value. For example, specifying the following command string changes the
number of virtual devices that you can allocate on a system to 50:
CHGSYSVAL SYSVAL(QAUTOVRT) VALUE(50)
Note: QAUTOVRT has been changed for Version4 Release 1 to support numeric
values of 0 through 32500 and a special value of *NOMAX.
Todetermine and set the maximum number of users you want signed on to the
AS/400 system at any time, perform the following steps:
1. Set the QAUTOVRT value to the maximum value of 32500 or use the *NOMAX
value.
2. Let your users use pass-through, TELNET,the workstation gateway server, and
the virtual terminal application program interface until you decide that the
number of virtual devices created is sufficient for normal system operation.
3. Change the QAUTOVRT value from 32500 to the number of virtual devices you
require for normal system operation.
If you have never allowed automatic configuration of virtual devices on your system,
the QAUTOVRT value is 0.A workstation gateway server connection attempt then
fails because the workstation gateway server does not create more than the
specified QAUTOVRT devices (zero). If you try to sign on, you receive a message
(TCP2504) indicating that the Web browser session has ended and the connection
is closed. In addition, the QTGTELNETS job in the QSYSWRK subsystem on the
AS/400 TELNET server sends a message (CPF8940) indicating that a virtual device
cannot be automatically selected.
If you change the QAUTOVRT value to 10, the next Web browser connection
attempt causes the workstation gateway server to create a virtual device. The
server creates this virtual device because the number of virtual devices on the
controller (0) is less than the number specified in the QAUTOVRT (10). Even if you
change the specified number to 0 again, the next user attempting a Web connection
succeeds. When a Web connection attempt fails because the AS/400 server cannot
create a virtual device, the system sends the CPF87D7 message the system
operator message queue.
The workstation gateway server uses the following conventions for naming virtual
controllers and devices:
vVirtual controllers are named QPACTLnn.
vVirtual device descriptions are named QPADEVxxxx.
When automatically configuring virtual devices with the workstation gateway server,
the workstation gateway server does not delete virtual devices, even if the number
of devices attached to the virtual controllers that are automatically configured
exceeds the QAUTOVRT limit.
322 OS/400 TCP/IPConfiguration and Reference V4R4