muxadm(1M) muxadm(1M)
NAME
muxadm - administration of the DPTG2 monitor
SYNOPSIS
/usr/sbin/muxadm -F -a path -d device [-h host] [-l label]
[-s service]
/usr/sbin/muxadm -I [-t level] [-f file] [-v version] [-r retry] [-x]
pmtag
/usr/sbin/muxadm -T [-t level] pmtag
/usr/sbin/muxadm -S [-i svrtag] pmtag
/usr/sbin/muxadm -R pmtag
/usr/sbin/muxadm -V
/usr/sbin/muxadm -?
DESCRIPTION
muxadm facilitates the administration and configuration of DPTG2 moni-
tors. muxadm has, for example, the -R option, with which an entry
specific to DPTG2 monitor is output to the pmtab file in the correct
format.
In addition, a monitor incarnation can be generated with the -I
option; this type of incarnation can be removed using the -R option.
The -V option provides stdout with the version number of the pmtab-
specific format.
The monitor status and the status of the connections it is monitoring
are displayed using the -S option.
Finally, trace mode can be selected and stopped using the -T option.
Each option has a series of arguments, which are explained in detail
below.
Option -F (Format)
With this option, a DPTG2 monitor-specific part of a pmtab entry is
returned to stdout without line feed. The format of this entry corre-
sponds to the version number provided by the -V option (see below).
Other options and arguments include:
-a path
This is the path name of the administrator channel via which the
multiplexer is to be connected to a line. Specification of this
name can be relative or absolute. If the path name is specified
relatively, the directory /dev/dptg is sought.
Page 1 Reliant UNIX 5.44 Printed 11/98
muxadm(1M) muxadm(1M)
Warning: Specification of the path name is mandatory (otherwise
diagnostic error, No. 5, ENOADM occurs).
-d device
This option is used to select the physical connection of the
device device which is to be monitored.
If it is a direct connection, the name given here is that of the
asynchronous tty port. This name can be specified relative to
/dev/term or absolutely.
If it is a remote connection via TCP/IP, the absolute port number
is specified.
Warning: Specification of device is mandatory (otherwise diag-
nostic error No. 6, ENODEV occurs).
-h host
With this option, the host on which the multiplexer connection is
to be made is specified (PC or a terminal server). If it is a
direct connection, the name of the host is localhost, or it can
be omitted completely. This field remains empty by default. Spec-
ification of the remote host is made either symbolically (corre-
sponding to an /etc/hosts entry), or in Internet (dot) notation.
-l label
With this option, label denotes a tag in /etc/ttydefs, after
which the monitor must set the physical line parameters. The file
is only evaluated in the case of a direct connection. If this
option is not used, the tag 9600 is used.
Modification of the physical line parameters via a DPTG2 monitor
can only be carried out by changing this label tag.
-s service
This option determines whether the DPTG2 monitor must carry out a
load service before the DPTG2 protocol can begin. This load ser-
vice is specified in more detail with the argument service. If
service has the value N, no load service is carried out (e. g. in
the case of the connection of a PC emulation). If the value is Y,
the load service is carried out. Here, the DPTG2 terminal deter-
mines which workstation program is loaded (setting in the
terminal's SETUP menu). As a third option, the path name of the
workstation program can be specified. If only a relative path
name was selected, the disk program relative to /opt/xb is
sought. The default value is Y.
Option -I (Install)
This option controls the way in which sac(1M) creates a DPTG2 monitor
incarnation (muxmon) with the name pmtag. An entry is made in the file
/etc/saf/sactab. Other options and arguments include:
Page 2 Reliant UNIX 5.44 Printed 11/98
muxadm(1M) muxadm(1M)
-t level
With this option, trace mode is set when the muxmon monitor is
initialized. The argument level specifies the trace level. Trace
levels are:
0 No output (trace mode switched off).
1 Output of error messages only.
2 Output of trace information and the contents of data structures.
The default value is 0 (trace mode switched off).
-f file
The DPTG2 monitor uses /var/saf/pmtag/trace as a trace file by
default. You can write the trace output to another file with this
option by creating a DPTG2 monitor incarnation. The argument file
must specify the absolute path name of this file.
-v version
The selectable version here is the version tag for the formats of
/etc/saf/pmtag/pmtab entries. If this option is not used, the
format is identified by the version which can also be obtained
using the muxadm -V command.
-x This option specifies that the sac(1M) process of this DPTG2 mon-
itor incarnation is always started as disabled. If this option is
not used, the monitor is started as enabled.
-r retry
This option starts a muxmon, whose retry counter is set to the
value retry. For information on the functions of the retry
counter, see -r for muxmon(1M).
Option -T (Trace)
This option is used to switch on and off trace mode. This is done by
means of signals sent to the monitor with the specified pmtag. Another
option is:
-t level
The trace mode of the muxmon monitor is set with this option. The
argument level specifies the trace level. The trace levels are:
0 No output (trace mode switched off).
1 Output of error messages only.
2 Output of trace information and the contents of data structures.
The default value is 0 (trace mode switched off).
Page 3 Reliant UNIX 5.44 Printed 11/98
muxadm(1M) muxadm(1M)
Option -S (Status)
With this option, the DPTG2 monitor for pmtag is requested to write
it's own status and the status of the connections it is monitoring to
the file /var/saf/pmtag/state. The contents of this file are output to
stdout. Another option is:
-i svrtag
When this option is used, the entire status file is not output.
Instead, the file is searched for the tag svrtag, and the
appropriate line is output. The search is carried out with
fgrep(1), so that in the event of an error, the fgrep diagnostics
texts can be viewed.
Option -V (Version)
This option outputs the version tag of the DPTG2 monitor-specific
pmtab format to stdout (without line feed). This command can be used
when generating a DPTG2 monitor incarnation (sacadm -a).
Option -R (Remove)
With this option, the muxmon(1M) incarnation is removed from the SAF
system (Service Access Facility). The pmtag specified is removed from
the file /etc/saf/sactab. The command used is sacadm(1M).
Option -? (Help)
The command syntax is displayed on stderr.
WARNING
Trace mode should only be switched on for a short period of time, so
that the trace file does not become too large.
DIAGNOSTICS
If no error occurs, muxadm terminates with the return value 0. In the
event of an error, the return values have the following meanings:
1 = Illegal option was used (EILLOPT)
2 = Command was called without any parameters (ENOPARAM)
3 = No command options were specified (ENOCMD)
4 = Command requires a pmtag (ENOTAG)
5 = Command requires specification of an administrator channel
(ENOADM)
6 = Command requires specification of a device (port) name (ENODEV)
7 = Command can only be executed by superuser (EPERM)
8 = The service tag specified does not exist (-i option) (ESVRTAG)
9 = The monitor tag specified does not exist (ENOMON)
Page 4 Reliant UNIX 5.44 Printed 11/98
muxadm(1M) muxadm(1M)
Entries under Logging 3.0 are made under the component number 36 and
the error number 7.
FILES
/etc/saf/sactab
/etc/saf/pmtag/pmtab
/var/saf/pmtag/state
/var/saf/pmtag/trace
SEE ALSO
muxmon(1M), sac(1M), sacadm(1M), dptg2(7).
Page 5 Reliant UNIX 5.44 Printed 11/98