Technical data

Setting Up and Managing TELNETSYM
23.5 Managing and Customizing Your Print Queues
If this logical name is not defined, TELNETSYM defaults to a wait period of 3
minutes between retries.
For example, to define a retry interval of 30 seconds, enter:
$ DEFINE /SYSTEM TCPIP$TELNETSYM_RETRY_INTERVAL "0 00:00:30.00"
23.5.5 Releasing a TELNETSYM Link
By default, TELNETSYM releases an established link at the end of a print job.
This behavior is useful when multiple systems contend for the same printer.
Configuring TELNETSYM to release the link at the end of a job allows other
systems to print quickly. However, this behavior can also be a disadvantage
because of the overhead involved with link creation for each print job.
When there is little or no contention for a printer, it is useful to configure
TELNETSYM to release the link only after a certain period of idle time has
passed. With this approach, TELNETSYM waits for the configured idle time to
elapse and then closes the link. This option works well within batch printing
applications.
Use the logical name TCPIP$TELNETSYM_IDLE_TIMEOUT to define the length
of time to wait before terminating an inactive link. Specify a value that is an
OpenVMS delta time.
For example, to define a link-idle-timeout of 10 minutes, enter:
$ DEFINE /SYSTEM TCPIP$TELNETSYM_IDLE_TIMEOUT "0 00:10:00.00"
Idle time occurs during printing as well as between print jobs. Any idle time on
the link can cause a timeout. Therefore, it is important to adjust the value of this
logical carefully.
23.5.6 Setting the Number of Execution Queues
The logical name TCPIP$TELNETSYM_STREAMS defines the number of
execution queues handled by each TELNETSYM process. The value you enter
(a number from 1 through 16) when defining this logical name is passed to
the PSM$PRINT system routine. The default is a maximum of 16 queues per
symbiont process.
Use this logical to turn TELNETSYM into a single-threaded symbiont (value=1)
in which each queue runs its own process. This makes diagnosing problems
easier and lessens the consequences of a failure.
If you are defining this logical name, define it once. Do not define it differently
for each TELNETSYM print queue.
23.6 Solving TELNETSYM Problems
To avoid potential problems with TELNET printing, be aware of the following
guidelines and considerations.
23.6.1 Using TCPIP$TELNETSYM for the First Time
If you use the public domain TELNET symbiont and want to switch to the TCP/IP
Services TELNET symbiont, you must change the value of the /PROCESSOR
qualifier on the TELNET symbiont queues. When you do this, include any
command procedures that start up the queues. Change:
/PROCESSOR=TELNETSYM
Setting Up and Managing TELNETSYM 23–7