The port configuration file (/etc/ddfa/pcf)
contains timer, connection, and data information for the related
output device. The outgoing connection daemon, ocd,
uses this information to manage outgoing Telnet connections from
the HP-UX device file to the server port. The pcf
file is required only for outgoing connections.
Each entry in the dp file which defines
an outgoing dedicated port must refer to a port configuration file.
In most cases, it is appropriate to use the default port configuration
file, /etc/ddfa/pcf.
You can use the same port configuration file for more than one dedicated
port. Therefore, most entries in the dedicated port file will contain
/etc/ddfa/pcf as the last field.
Whenever a pcf parameter or entry is
changed, the ocd process created by that
entry must be restarted in order to activate those changed parameters.
Each entry in the pcf file is a field-value
pair on a separate line. Each field-value pair is separated by a
colon (:) or one or more spaces.
The master pcf file
is in /usr/examples/ddfa/pcf.
The master file should always be copied to another directory, such
as /etc/ddfa/pcf.
The copy should be modified and referenced in the dp
file.
HP recommends that you create the /etc/ddfa
directory to contain the pcf and dp
files.
The pcf file contains the following
entries and defaults:
- telnet_mode: enable
Performs data transfer using the Telnet protocol.
This option must be enabled when used
with the DTC.
- timing_mark:
enable
Uses the Telnet timing mark negotiation at the end
of the data transfer. If this is enabled, then all data is output
from the server buffers to the device before the buffers are flushed.
- telnet_timer:
120
Sets the timeout for the timing mark and binary
negotiation to 120 seconds. If the negotiation does not complete
within 120 seconds, an error message is logged to /var/adm/syslog/syslog.log,
and the error is sent to the user application program. Its range
is 1 to MAXINT.
- binary_mode:
disable
Transfers data in ASCII mode when this is disabled.
Do not ignore processing of special characters such as XON/XOFF.
If set to "enable," the data transfer over the network will be in
binary mode and treatment of special characters (for example XON
and XOFF) will not occur.
Because there is no flow control, data integrity cannot be
guaranteed when binary mode is enabled.
If binary mode is disabled, it may still be negotiated by
the application program setting IXON to 0 (zero) in the TERMIO data
structure.
- open_tries:
1500
Sets the number of connection retries to 1500. If
the retry process fails to make a connection, an error message is
logged to /var/adm/syslog/syslog.log. The
error message is also transmitted to the user application program.
The retry process can be interrupted by sending the SIGUSR2 signal
to the ocd process using the kill
-17 command. Its range is 1 to MAXINT. Zero causes exponential
increments for times between retries, such as 1, 2, 4, 8, 16 and
so on.
- open_timer:
30
Sets the time between retries for making a connection
to 30 seconds. Its range is 1 to MAXINT. Zero causes infinite retries.
- close_timer:
5
Sets the time between an application program's close
call and the actual close of the connection to zero (0) seconds.
The connection will be closed and opened after every file is sent
to the device. Setting the timer to a value other than zero avoids
the overhead of opening and closing the connection when a spooler
spools several files at a time. The connection closes after the
specified length of time. Setting the timer to a high value effectively
leaves the connection permanently open. Its range is 1 to MAXINT.
- status_ request:
disable
Disables the sending of a status request to a device.
If enabled, a status request is sent to the device. The device replies
with a status such as busy or ready.
- status_timer:
30
Sets the timeout for receipt of a status reply to
30 seconds. If no status reply is received in that time period,
an error message is logged to /var/adm/syslog.syslog.log.
An error is also sent to the user application program. Its range
is 1 to MAXINT. Zero causes MAXINT retries.
- eightbit:
disable
Causes the eighth data bit (bit 7) to be stripped
by the pty. If enabled, the eighth data bit is not stripped.
- tcp_nodelay:
enable
Causes data to be sent to the LAN as soon as it
is received by TCP. If disabled, data will be sent using normal
TCP timing.