HP OpenVMS Systems Documentation

Specify one of the following speeds: 50, 75, 100, 134, 150, 300, 600, 1200, 1800, 2400, 3600, 4800, 7200, 9600, 19200, 38400, 57600, 76800, or 115200. If your line allows split speed, you can specify different speeds for input and output. If you only specify one speed, it is used for both input and output.

/TRANSMIT_ACCM=mask-value,...

Description

Use the SET command to specify the communications characteristic of a terminal device. Communications characteristics such as address compression, flow control, and line speed determine how data is transmitted and received. These characteristics take effect as soon as you invoke the CONNECT or DIAL_OUT command.

Note If you you invoke a SET command from the DCL command line (for example, PPPD SET/MTU=1000 tta0), the utility assumes you wish to connect and attempt to start a PPP connection on the specified device.

PPPD> SET/PERMANENT TTA0:
%PPPD-I-CONNECTTERM, converting connection on device _TTA0: to a
Point-to-Point connection

In this example, the SET command is setting up a permanent network connection over the serial port TTA0.

SHOW

Allows you to display the communication characteristics for a specific terminal.

Format

SHOW device-name[:]

Parameter

device-name[:]

Supplies the name of the device whose characteristics are to be displayed. The device name has the form ddcu where dd is the device code, c is the controller designation, and u is the unit number. LAN devices are specified as the name of the device that is unit 0. For example, the first terminal device on a LAN is specified as TTA0, the second as TTB0.

Qualifiers

/ADDRESS_COMPRESSION

Indicates whether the address compression is on or off.

/ALL[=BRIEF] (default)

/ALL[=LONG]

Displays all the current device and communication settings. BRIEF formats the output for the screen. LONG displays each setting on a separate line.

/COUNTERS=(keyword,...)

Shows the current values for the specified counter(s). You can specify one or more of the following keywords with this qualifier:

Keyword	Description
ALL	Displays all counters.
BAD_FCS_PACKETS	Displays the count of packets with bad frame check sequence (FCS).
DATA_LOST	Displays the count of lost characters that were reported by hardware.
DROPPED_CHARACTERS	Displays the count of all characters thrown away.
FRAMING_ERRORS	Displays the count of characters with framing errors.
LONG_PACKETS	Displays the count of packets longer than the current maximum receive unit setting (MRU).
RECEIVED_PACKETS	Displays the count of total packets received.
RUNT_PACKETS	Displays the count of packets with too few characters.
TOTAL_CHARACTERS	Displays the count of all characters received.
TRANSMITTED_PACKETS	Displays the count of total packets transmitted.

/ECHO=(FAILURE=value, INTERVAL=value)

Specifies the number of Link Control Protocol (LCP) echo requests and the interval (in milliseconds) between requests that must be sent without response before the line is considered down.

/FCS_SIZE

Shows the current receive and transmit FCS size in bits.

/FLOW_CONTROL=(keyword,...)

Shows the current flow control setting used over the asynchronous physical link. You can specify one of the following keywords with this qualifier:

Keyword	Description
HARDWARE	Uses RTS/CTS flow control. If using this control, the transmit Asynch Control Character Map (ACCM) can be 0x0, 0x0, 0x0, 0x60000000. Only valid for lines set to /MODEM or /COMMSYNCH.
XON_XOFF (default)	Uses band flow control. If using this control, the optimal transmit ACCM is 0xA0000, 0x0, 0x0, 0x60000000. Only valid for asynchronous lines.

/HANGUP

Displays the action that occurs when a session is terminated.

/MAGIC_NUMBER_RETRIES

Shows the number of attempts that are made to negotiate a magic number.

/MAXCONFIGURE

Shows the number of configure-request packets sent without acknowledgment before assuming that the peer is not responding.

/MAXFAILURE

Displays the number of configure-nak packets sent before sending a configure-ack and before assuming that the configuration is not converging.

/MAXTERMINATE

Shows the number of terminate-request packets sent without acknowledgment before assuming the peer is unable to respond.

/MRU

Displays the largest packet that the line can receive.

/MTU

Displays the largest packet that the line can transmit.

/NETWORK_PROTOCOL

Displays the current network protocol(s) allowed over the physical link.

/PASSIVE

Indicates whether this is a passive or active line.

/PERMANENT

Indicates whether this is a permanent or transient (nonpermanent) line.

/PROTOCOL_COMPRESSION

Shows the status of protocol field compression.

/RECEIVE_ACCM

Displays the value of the current receive ACCM for asynchronous ports.

/RESTART_TIMER

Displays the interval used to time transmission of request packets.

/SPEED

Indicates the current input and output speeds of the line.

/TRANSMIT_ACCM

Displays the value of the current transmit ACCM for asynchronous ports.

Description

The SHOW command allows you display the current terminal and communication settings. To display all available settings, use the /ALL qualifier.

PPPD> SHOW/ALL=BRIEF TTA0:
Line TTA1: is being used for PPP connections

Debug trace:     OFF       Debug mailbox:
Address comp:    OFF       Max configure:        10  Restart timer:        30
ASN port name:   ASN13     Max failure:           5
Echo failure:           0  Max terminate:         2  Receive ACCM:   FFFFFFFF
Echo intervals:         0  MRU:                1500  Transmit ACCM:  FFFFFFFF
Flow control:    XON/XOFF  MTU:                1500                  00000000
Hangup:          DEFAULT   Mode:           ACTIVE                    00000000
Line type:       TRANSIENT Net protocol:   TCP/IP                    60000000
Magic retries:          0  Protocol comp:  OFF                       00000000
Input speed:     DEFAULT   Receive FCS:          16                  00000000
Output speed:    DEFAULT   Transmit FCS:         16

Counter totals for line TTA0:

Bad FCS packets:                   0   Packets received:                  4
Data lost (chars):                 0   Packets transmitted:               6
Dropped chars:                     0   Runt packets:                      0
Framing errors:                    0   Total chars received:            179
Long packets:                      0

The command in this example displays the current PPP characteristics assigned to port TTA1.

17.1 POLYCENTER Software Installation Utility Description

• Install, reconfigure, or remove software products.
• Display information from the software product database, such as the names of installed products, the names of patches applied, product dependencies, the names of files provided by product, and historical information about past operations.
• List the software product kits from the source directory that are available for installation.
• Create a software product kit in sequential or reference format.
• List the contents of a software product kit or extract files from the kit, such as release notes or files you specify.
• Perform other operations such as establishing default configuration choices offered by a product, copying a product kit or converting it to a different format, and registering information about a product in the product database.

The POLYCENTER Software Installation utility installs, removes, and performs other operations on layered software products.

Format

PRODUCT [subcommand product-name [/qualifiers]]

Parameters

subcommand

Specifies an operation you want the POLYCENTER Software Installation utility to perform.

product-name

Specifies the name of the product to which you want to apply the activity. Some subcommands do not require this parameter. You can use the asterisk (*) and the percent sign (%) wildcard characters for all or part of the product-name. You can specify a list of products separated by commas (,).

Description

To use the POLYCENTER Software Installation utility from the DCL prompt, enter the PRODUCT command, a subcommand, a product name, and optional qualifiers. For example:

$ PRODUCT INSTALL COBOL /VERSION=5.3

You can use the PRODUCT commands in command procedure files.

The following table describes PRODUCT commands.

Creates a product configuration file (PCF) for one or more products. Optionally uses the values in an existing PCF file to create the new PCF.

Format

PRODUCT CONFIGURE product-name[,...] [/qualifiers]

Parameter

product-name

Names the product, or list of products, for which product configuration files will be generated.

Qualifiers

/BASE_SYSTEM=base-system-name

Selects software products whose base system matches the one specified. The base system name identifies both a hardware platform and an operating system. The base system name AXPVMS denotes an OpenVMS Alpha product, VAXVMS denotes an OpenVMS VAX product, and VMS denotes a product applicable to either OpenVMS Alpha or VAX.

/CONFIGURATION=(keyword[,...])

Specifies how the configuration choices will be supplied. Keywords are:

CURRENT	This is the default. It uses values from the product database, which contains the current values recorded from the last time the product was installed or reconfigured.
PRODUCER	Uses values specified by the software manufacturer for this version of the product.
INPUT=pcf-name	Uses values from the specified product configuration file.
OUTPUT=pcf-name	Writes configuration choices to the specified product configuration file. If no file name is supplied, creates a file named DEFAULT.PCSI$CONFIGURATION in the current default directory.

The keywords CURRENT, PRODUCER, and INPUT are mutually exclusive. Each of these, however, can be used with the keyword OUTPUT. If you specify only one keyword, you can omit the parentheses.

/HELP

/NOHELP (default)

Controls whether detailed explanations of product options and informational text are displayed. The first time you install a product, these explanations can help you decide which options to select. When you perform subsequent installations or upgrades, you might choose the brief explanations to save time.

When /NOHELP is selected, you can request a detailed explanation about a question by performing one of the following actions at the prompt:

• Press the Help key or PF2 key
• Type ? and press the Return key

/KIT_ATTRIBUTES=keyword([,...])

Selects kits by kit type or kit format, or both. Keywords are:

FORMAT= format-type	Designates the format of the product kit as follows:     REFERENCE Reference format in which product files exist in a directory tree.     SEQUENTIAL Sequential format in which product files are placed in <full-product-name>.PCSI, a container file.
TYPE= kit-type	Specifies the type of product kit as follows:     FULL Layered product (application) software.     OPERATING_SYSTEM Operating system software.     MANDATORY_UPDATE A required correction to currently installed software. Functionally, this type of kit is the same as a patch kit.     PARTIAL An upgrade to currently installed software. Installation of this kit changes the version of the product.     PATCH A correction to currently installed software. Installation of this kit does not change the version of the product.     PLATFORM An integrated set of software products (also called a product suite).     TRANSITION Used to register information about a product that is installed but not recorded in the product database (for example, a product installed by VMSINSTAL). This kit does not provide product material.

/LOG

/NOLOG (default)

Displays messages as the POLYCENTER Software Installation utility performs the operation.

/PRODUCER=producer-name

Selects software products that the specified manufacturer produces.

/REMOTE

/NOREMOTE (default)

Uses the product database on a system other than the currently running system. This qualifier is primarily for use in command procedures that Compaq supplies. Incorrect use of this qualifier can corrupt the POLYCENTER Software Installation utility database, corrupt installed products, or cause other problems. In some cases, /REMOTE can be useful with the CONFIGURE and SHOW commands.

When you use /REMOTE, the following logical names must be defined:

• PCSI$SYSDEVICE must specify the physical disk name of the target system disk. This disk must be mounted and allocated to the process executing the PRODUCT command.
• PCSI$SPECIFIC must point to a system root on PCSI$SYSDEVICE. It must be defined in the following form, where x is a valid system root:

  PCSI$SYSDEVICE:[SYSx.]

Note that the definition of PCSI$SYSDEVICE and PCSI$SPECIFIC specify only where the utility will find or place its database.

/SOURCE=device-name:[directory-name]

Specifies the disk and directory where the utility searches for the software product kit or kits. If /SOURCE is not specified, the utility searches in the location defined by the logical name PCSI$SOURCE. If PCSI$SOURCE is not defined, and the /SOURCE qualifier is not specified, the POLYCENTER Software Installation utility searches the current default directory.

/SPAN_VERSIONS=keyword([,...])

Selects software products whose versions match the specified version criteria. The keywords are:

ABOVE=version	Selects versions greater than the version specified
BELOW=version	Selects versions less than the version specified
MINIMUM=version	Selects versions greater than or equal to the version specified
MAXIMUM=version	Selects versions less than or equal to the version specified

The ABOVE, BELOW, MINIMUM, and MAXIMUM keywords can be used alone or in combination. For example, /SPAN_VERSIONS=(MINIMUM=V2.1,BELOW=V3.0) selects versions greater than or equal to V2.1 and less than (but not including) V3.0. Using the MAXIMUM keyword instead of BELOW would select versions that include V3.0.

/VERSION=version-number

Selects software products that have the specified version.

Example

$ PRODUCT CONFIGURE EDITOR -
_$ /CONFIGURATION=(INPUT=EDITOR_REV1.PCF,OUTPUT=EDITOR_REV2.PCF)

      

The command in this example reads an existing PCF file named EDITOR_REV1.PCF for a product named EDITOR and then saves your changes in EDITOR_REV2.PCF.