Document revision date: 30 March 2001

## OpenVMS System Management Utilities Reference Manual

Previous | Contents | Index

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,...

Identifies the starting Asynch Control Character Map (ACCM). This mask is used by the PPP driver to negotiate the final transmit ACCM for asynchronous ports. Specify a mask in the range of 0x0 to 0xFFFFFFFF. The default mask value is 0xFFFFFFFF, 0x0, 0x0, 0x60000000, 0x0, 0x0, 0x0. The masks are ordered from low-order longword to high-order longword. Specify the longword mask until the last mask bits are set. The remaining longwords are set to 0. With 8 longwords, there is 1 bit for every ASCII character position (from 0 to 255). The ASCII characters 0x20 through 0x3F and 0x5E cannot be quoted.

### 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.

## Chapter 17
POLYCENTER Software Installation Utility

## 17.1 POLYCENTER Software Installation Utility Description

You can use the POLYCENTER Software Installation utility to do the following:

- 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.

## 17.2 POLYCENTER Software Installation Utility Usage Summary

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.

## 17.3 PRODUCT Commands

The following table describes PRODUCT commands.

Command | Description
--- | ---
CONFIGURE | Creates a product configuration file (PCF)
COPY | Copies a software product kit or converts it to another format
EXTRACT FILE | Retrieves a specified file or files from a software product kit that is packaged in sequential format
EXTRACT PDF | Retrieves the product description file (PDF) from a software product kit that is packaged in sequential format
EXTRACT PTF | Retrieves the product text file (PTF) from a software product kit that is packaged in sequential format
EXTRACT RELEASE_NOTES | Retrieves the release notes from a software product kit that is packaged in sequential format
FIND | Displays the name of product kits found in a specified directory
INSTALL | Installs one or more software products and updates the product database
LIST | Lists a file or files contained in a specified product kit that is packaged in sequential format
PACKAGE | Creates a software product kit in either sequential or reference format.
RECONFIGURE | Modifies the configuration of an installed product and updates the product database
REGISTER PRODUCT | Records information in the product database about one or more installed products that are not yet registered in the database
REGISTER VOLUME | Records a change in volume label in the product database
REMOVE | Uninstalls one or more software products and updates the product database
SHOW HISTORY | Displays in chronological order the operations performed on software products
SHOW OBJECT | Displays information about objects created during software product installation
SHOW PRODUCT | Displays information about installed products
SHOW UTILITY | Displays information about the POLYCENTER Software Installation utility

## CONFIGURE

> 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.

Previous | Next | Contents | Index

| privacy and legal statement |
6048PRO_048.HTML