Document revision date: 30 March 2001

## OpenVMS VAX Version 7.3
Upgrade and Installation Manual

Previous | Contents | Index

### 9.3.1 Writing a Transport Interface

For information about writing a transport interface, refer to the VMS DECwindows Transport Manual.

The transport interface image's file name must have the following format where name is the unique transport name:

DECW$TRANSPORT_name (for transports supplied by Compaq)
DECW_TRANSPORT_name (for customer-written transports)

### 9.3.2 Installing the Transport Interface Image

Install the image as a protected image in the SYS$SHARE directory (as defined by an executive mode logical name). Compaq recommends that you install the image by adding the following line to SYS$MANAGER:SYSTARTUP_VMS.COM:

    $ INSTALL CREATE SYS$SHARE:DECW_TRANSPORT_name/OPEN/SHARED-
    /HEADER_RESIDENT/PROTECTED

You can also include this command in a startup file that SYSTARTUP_VMS calls.

To use this transport with the DECwindows server, customize the server startup as described in Section 9.1.

## 9.4 Using the Example Transport

DECwindows has an example transport interface based on the Compaq TCP/IP Services for OpenVMS layered product. It is similar to the DECwindows TCP/IP transport interface, except it includes its own source files and it uses a different port number (5000). You can run the example transport interface simultaneously with the TCP/IP transport interface.

If you have installed Compaq TCP/IP Services for OpenVMS software, you can install and use the example transport by doing the following:

1. Copy the example transport to the SYS$SHARE directory as follows:

       $ COPY DECW$EXAMPLES:DECW$TRANSPORT_EXAMPLE.EXE SYS$SHARE:/PROT=W:RE

2. Add the following line to SYS$MANAGER:SYSTARTUP_VMS.COM:

       $ INSTALL CREATE SYS$SHARE:DECW$TRANSPORT_EXAMPLE /OPEN /SHARED-
       /HEADER_RESIDENT /PROTECTED

3. Customize the private server startup as described in Section 9.1 for TCP/IP, except use the transport name "EXAMPLE". For example, you might add the following line:

       $ DECW$SERVER_TRANSPORTS == "DECNET,LOCAL,TCPIP,EXAMPLE"

4. Reboot the workstation, or restart DECwindows.
5. Customize TCP/IP security as described in the Using DECwindows Motif for OpenVMS manual, but use the transport name "EXAMPLE" instead of "TCPIP".
6. Create a DECterm window on the workstation and enter the following command:

       $ SET DISPLAY /CREATE /NODE=your_node /TRANSPORT=EXAMPLE

   Substitute the node name of your workstation for your_node.
   Remember that the same transport must be running on both the client and server. It is not necessary, however, for the client and the server to be on the same system.
7. Run any DECwindows application from the DECterm window. It now uses the example transport to display graphics on your workstation screen. For example, enter the following command to run the clock:

       $ RUN SYS$SYSTEM:DECW$CLOCK

## Chapter 10
Using VMSTAILOR and DECW$TAILOR

This chapter describes how to add (tailor on) or remove (tailor off) optional OpenVMS VAX files and DECwindows support files from your system disk using VMSTAILOR and DECW$TAILOR. You will need your OpenVMS VAX software media kit to tailor on files. Any site-specific customization that has been done to a class will be lost when that class is tailored off.

## 10.1 Using VMSTAILOR

To add or remove unwanted OpenVMS VAX files from the system disk, use VMSTAILOR. For example, if you are not running DECnet for OpenVMS, and you do not need the network support files, you can remove those files using VMSTAILOR. If you later decide you want to run DECnet for OpenVMS, you can add the necessary files at any time using VMSTAILOR and your OpenVMS VAX distribution media. (Note that you cannot tailor files on or off an alternate device.)

### 10.1.1 How VMSTAILOR Works

VMSTAILOR has three phases:

1. VMSTAILOR asks if you want to tailor your system by adding files (tailor on) or by deleting files (tailor off).
2. If you choose to tailor files on, VMSTAILOR lists each class of OpenVMS VAX files and asks if you want to include them on the system disk. If you choose to tailor files off, VMSTAILOR lists each class of files and asks if you want to delete them from the system disk.
3. VMSTAILOR adds or deletes the files you indicated from the system disk. If you are tailoring files on, you must load your OpenVMS VAX distribution media in a drive available to the system. If your distribution media consists of more than one piece, put the first piece of the media into the drive.

The following is a list of classes and subclasses of OpenVMS VAX files that can be added or deleted by using VMSTAILOR. For a complete list of OpenVMS VAX files and their functions, refer to the OpenVMS System Manager's Manual, Volume 2: Tuning, Monitoring, and Complex Systems.

- Network Support

  > Incoming Remote File Access files
  > Incoming Remote Terminal files
  > Network Test files
  > Remote Task Loading

- Programming Support

  > Debugger utility (DEBUG)
  > Image Dump utility (ANALYZE/PROCESS_DUMP)
  > RMS Analyze and FDL Editor utilities (ANALYZE/RMS, ANALYZE/FDL)
  > Message utility (MESSAGE)
  > Object and Shareable Image libraries
  > MACRO libraries
  > MACRO assembler
  > SDL intermediary form of STARLET.MLB
  > Fortran required files
  > VAX C object libraries

- OpenVMS RMS Journaling Files
- System Programming Support

  > Files-11 ODS-1,ISO 9660, High Sierra ACPs
  > Monitor utility
  > Delta/XDelta debugger
  > System Dump Analyzer utility (ANALYZE/SYSTEM, ANALYZE/CRASH)
  > System Symbol Table file (SYS.STB)
  > Miscellaneous Symbol Table files

- Secure User's Environment

  > File Access Control List utilities
  > Print and Batch Queue utilities
  > Input Queue Symbiont (Card Reader)
  > Accounting Log Report Generator utility
  > DECdtm

- Utilities

  > Mail utility
  > DUMP utility
  > RUNOFF utility
  > Phone utility
  > OpenVMS Help library
  > OpenVMS System Messages Help Library
  > Foreign Terminal Support
  > LAT-11 terminal server (via Ethernet)
  > Standalone BACKUP
  > Error Log Report Generator utility (ANALYZE/ERROR)
  > DECTPU utility
  > Terminal Fallback facility
  > TECO editor
  > EDT documentation
  > National Character Set utility (NCS)

- VMS Workstation Support (VWS)

  > Workstation device support

- BLISS require files
- Miscellaneous Files

  > System map
  > LPA-11 support

- User Environment Test Package
- Example Files

### 10.1.2 Removing OpenVMS VAX Files

To remove unwanted files using VMSTAILOR, perform the following steps:

1. Log in to the SYSTEM account.
2. Enter the following command and press Return:

       $ RUN SYS$UPDATE:VMSTAILOR

   VMSTAILOR displays a description of the VMSTAILOR program and the following message:

       Do you want to tailor files "ON" or "OFF"?

3. Enter OFF to remove unwanted files and press Return.
   The VMSTAILOR program lists each group, or class, of files and its size in blocks. Files are grouped according to their function. For example, all the files required for network support are in one class. A file class is made up of many smaller groups called subclasses. You can eliminate an entire class of files, or you can eliminate one or more of its subclasses. For example:

       CLASS - Network support
                 Size of entire class (with subclasses): 1499
                 Size of common files required for any subclass: 1249
                 Do you wish to select the entire class (default = NO)?
          .
          .
          .

4. Decide which file classes or subclasses you do not need to support your system. The VMSTAILOR program displays step-by-step instructions. Follow these instructions to specify which classes or subclasses of files you want to remove.
5. VMSTAILOR deletes the files you selected and displays the names of those files. After it finishes, AUTOGEN runs automatically to make the adjustments that are necessary after system files are deleted. AUTOGEN also reboots the system.

Caution To cancel VMSTAILOR during the first and second phases, press Ctrl/C, Ctrl/Y, or Ctrl/Z. Canceling VMSTAILOR during the third phase can cause a partially tailored disk. For a description of each phase, see Section 10.1.1.

### 10.1.3 Adding OpenVMS VAX Files

To add optional OpenVMS VAX files that you previously removed, or that you chose not to install during the OpenVMS VAX installation procedure, do the following:

1. Log in to the SYSTEM account.
2. Load your distribution media in a drive available to the system. For example, if your distribution media is on a TK50 tape cartridge, load the first tape cartridge in a TK50 drive that is available to the system. Make sure the drive is on line and ready.
   If you are adding files from a compact disc on an InfoServer, first determine whether the SYSGEN parameter SCSNODE is defined on your system (see Section 5.5) or start the DECnet software, and then refer to step 2 of Section 7.2.
3. Enter the following command and press Return:

       $ RUN SYS$UPDATE:VMSTAILOR

   VMSTAILOR displays a description of the VMSTAILOR program and the following message:

       Do you want to tailor files "ON" or "OFF"?

4. Enter ON to add files and press Return.
   The VMSTAILOR program lists each group, or class, of files and its size in blocks. Files are grouped according to their function. For example, all the files required for network support are in one class. A file class is made up of many smaller groups called subclasses. You can add an entire class of files, or you can add one or more of its subclasses. For example:

       CLASS - Network support
                 Size of entire class (with subclasses): 1499
                 Size of common files required for any subclass: 1249
                 Do you wish to select the entire class (default = NO)?
          .
          .
          .

5. Decide which file classes or subclasses you need to add. VMSTAILOR displays step-by-step instructions. Follow these instructions to specify which classes or subclasses of files you want to add.
6. VMSTAILOR adds the files you specified and displays the names of the files. After the files have been added, AUTOGEN runs automatically to make the adjustments that are necessary after system files are added. AUTOGEN also reboots the system.

Caution To cancel VMSTAILOR during the first and second phases, press Ctrl/C, Ctrl/Y, or Ctrl/Z. Canceling VMSTAILOR during the third phase can cause a partially tailored disk. For a description of each phase, see Section 10.1.1.

After adding files to the system disk, apply any updates that affect them. OpenVMS VAX update procedures create a .TXT file that contains a description of patched files. This file usually has the following format: SYS$UPDATE:VMSUn06n.TXT.

For example, assume that you do not need the OpenVMS Phone utility (PHONE) and you run VMSTAILOR to remove those files. Later, you decide you want to use Phone. Run VMSTAILOR to return the Phone files to the system disk; then, apply any OpenVMS VAX update that has occurred since Version 7.3 that affected the Phone utility.

### 10.1.4 Sample Session

Example 10-1 shows how to add all Network Support files and selected Programming Support files to a system disk.

Example 10-1 Sample VMSTAILOR Session

    $ RUN SYS$UPDATE:VMSTAILOR
       .
       .
       .
     Do you want to tailor files "ON" or "OFF"? ON
    TAILOR-ON
    ---------
     You will now be prompted with a list of the classes and subclasses of
     OpenVMS Vax files that are optional. The size of each class and subclass
     is included in the list. This will help you decide whether or not you
     want to add a class or subclass to your system.

     Under some classes, there is a set of common files that is required in order
     for any subclasses to work. These files are added when you ask
     for either the entire class or any of its subclasses.

    Total size of the system disk is 2376153 blocks.
    Total space used on the system disk is 2241252 blocks.
    Total space left on the system disk is 134901 blocks.

    CLASS - Network support
              Size of entire class (with subclasses): 1499
              Size of common files required for any subclass: 1249
              Do you wish to select the entire class (default = NO)? YES
    CLASS - Programming Support
              Size of entire class (with subclasses): 14706
              Size of common files required for any subclass: 0
              Do you wish to select the entire class (default = NO)?
              Do you wish to select any of its subclasses (default = NO)? )YES
              Select the subclasses that you wish to provide:
                 SUBCLASS - Debugger utility (DEBUG) (4690 blocks) [NO]: YES
                 SUBCLASS - Image Dump utility (ANALYZE/PROCESS_DUMP) (48 blocks) [NO]: YES
                 SUBCLASS - RMS Analyze and FDL Editor utilities (ANALYZE/RMS, ANALYZE/FDL)-
                 (374 blocks) [NO]:YES
                 SUBCLASS - Message utility (MESSAGE) (49 blocks) [NO]:
                 SUBCLASS - Object and Shareable Image libraries (4311 blocks) [NO]: YES
                 SUBCLASS - Macro libraries (2293 blocks) [NO]:
                 SUBCLASS - Macro assembler (457 blocks) [NO]:
                 SUBCLASS - SDL intermediary form of STARLET.MLB (1957 blocks) [NO]:
                 SUBCLASS - FORTRAN require files (51 blocks) [NO]:
                 SUBCLASS - VAX-C object libraries (471 blocks) [NO]:
    CLASS - RMS journaling files
              Size of entire class (with subclasses): 155
              No subclasses in this tailor class.
              Do you wish to select the entire class (default = NO)?
    CLASS - System programming Support
              Size of entire class (with subclasses): 2286
              Size of common files required for any subclass: 93
              Do you wish to select the entire class (default = NO)?
              Do you wish to select any of its subclasses (default = NO)?
    CLASS - Secure User's Environment
              Size of entire class (with subclasses): 919
              Size of common files required for any subclass: 0
              Do you wish to select the entire class (default = NO)?
              Do you wish to select any of its subclasses (default = NO)?

       .
       .
       .
    Files have been selected
    Do you wish to add all of the options selected? YES
    Creating temporary command file, please wait...
    * Enter device containing OpenVMS distribution media: mua0:

       .
       .
       .

## 10.2 Using DECW$TAILOR

You can use DECW$TAILOR to add or remove some or all DECwindows X11 display server, base support, and fonts files from the system disk. For example, if you are not planning to use the DECwindows PEX (PHIGS Extensions to X) support, you can remove those files. Later, if you decide you want DECwindows programming support, you can add the files to the system disk using DECW$TAILOR and your DECwindows distribution media. You cannot tailor files on or off an alternate device.

Note To add or remove DECwindows Motif for OpenVMS VAX files, refer to the DECwindows Motif Version 1.2--3 for OpenVMS Installation Guide. DECW$TAILOR will only tailor on or off those DECwindows display server, base support, and font files, with the exception of the required files, supplied on the OpenVMS VAX kit.

### 10.2.1 How DECW$TAILOR Works

DECW$TAILOR has three phases:

- DECW$TAILOR asks if you want to tailor your system by adding files (tailor on) or by deleting files (tailor off).
- If you choose to tailor files on, DECW$TAILOR lists each class of DECwindows files and asks if you want to include them on the system disk. If you choose to tailor files off, DECW$TAILOR lists each class of DECwindows files and asks if you want to delete them from the system disk.
- DECW$TAILOR adds or deletes the files you indicated from the system disk. If you are tailoring files on, you must load your DECwindows distribution media in a drive that is available to the system. For example, if your OpenVMS VAX distribution kit is on a TK50 tape cartridge, load the second tape cartridge, which contains the DECwindows support files, into a TK50 drive that is available to the system.

### 10.2.2 DECwindows Files You Can Tailor

The following is a list of classes and subclasses of DECwindows files that you can add or delete using DECW$TAILOR. For a list of DECwindows files and their functions, see Appendix E.

- DECwindows base support files --- If you plan to install the separate DECwindows Motif for OpenVMS VAX layered product, you must add the base support files.
- DECwindows workstation support files --- If you are installing DECwindows support on a workstation or in a cluster that includes workstations or if you intend to install the DECwindows Motif for OpenVMS VAX layered product, you need the workstation support files. Otherwise, you do not need them.

  Note If you tailor device support files ON or OFF, the system reboots.

- 100 dots/inch video font files --- By default, some workstation monitors (for example, a VR150, VR160, or VR295) display 100 dots/inch, which gives you a more readable display when you run DECwindows applications. If your workstation monitor cannot display 100 dots/inch fonts (for example, a VR260 or VR290), you can save disk space by not selecting this option. For more information about the capabilities of your particular monitor, refer to the owner's guide for your monitor.
- 75 dots/inch video font files --- If your workstation monitor cannot display 75 dots/inch, you can save disk space by not selecting this option. For more information about the capabilities of your particular monitor, refer to the owner's guide for your monitor.

### 10.2.3 Removing DECwindows Files

To remove DECwindows files from the system disk, do the following:

1. Log in to the SYSTEM account.
2. Type the following command, and press Return:

       $ RUN SYS$UPDATE:DECW$TAILOR

   DECW$TAILOR displays information about the DECW$TAILOR program and displays the following message:

       Do you want to tailor files "ON" or "OFF"?

3. Type OFF to remove unwanted files, and press Return.
   The DECW$TAILOR program lists each group, or class, of files and its size in blocks. Files are grouped according to their function. For example, all the files required for DECwindows device support are in one class. A file class is made up of many small subclasses. You can eliminate an entire class of files, or you can eliminate one or more of its subclasses. For example:

       CLASS - DECwindows workstation support files
                 Size of entire class (with subclasses): 14301
                 Size of common files required for any subclass: 8937
                 Do you wish to select the entire class (default = NO)?
          .
          .
          .

4. Decide which file classes or subclasses you need to add. DECW$TAILOR displays step-by-step instructions. Follow these instructions to specify which of the classes or subclasses you want to remove.
5. DECW$TAILOR deletes the files you selected and displays the names of those files. If you deleted device support files, the system automatically shuts down and reboots.

Caution To cancel DECW$TAILOR during the first and second phases, press Ctrl/C, Ctrl/Y, or Ctrl/Z. Canceling DECW$TAILOR during the third phase can cause a partially tailored disk. For a description of each phase, see Section 10.2.1.

### 10.2.4 Adding DECwindows Files

To install DECwindows device support and font files after the OpenVMS VAX installation or to add optional DECwindows files that you previously chose not to install or that you removed, do the following:

1. Log in to the SYSTEM account.
2. Load the OpenVMS VAX distribution media containing the DECwindows save sets in a drive available to your system. For example, if your distribution media is a TK50 tape cartridge, load the second tape cartridge into a TK50 drive that is available to the system. Make sure the drive is on line and ready.
   If you are adding files from a compact disc on an InfoServer, first determine whether the SYSGEN parameter SCSNODE is defined on your system (see Section 5.5) or start the DECnet software, and then refer to step 2 of Section 7.2 in Chapter 7.
3. Enter the following command, and press Return:

       $ RUN SYS$UPDATE:DECW$TAILOR

   DECW$TAILOR displays information about the DECW$TAILOR program, and displays the following message:

       Do you want to tailor files "ON" or "OFF"?

4. Type ON to add files, and press Return.
   The DECW$TAILOR program lists each group, or class, of files and its size in blocks. Files are grouped according to their function. For example, all the files required for DECwindows device support are in one class. A file class is made up of many small subclasses. You can add an entire class of files, or you can add one or more of its subclasses. For example:

       CLASS - DECwindows workstation support files
                 Size of entire class (with subclasses): 14301
                 Size of common files required for any subclasses: 8937
                 Do you wish to select the entire class (default = NO)?
          .
          .
          .

5. Decide which file classes or subclasses you do not need to support your system. The DECW$TAILOR program displays step-by-step instructions. Follow these instructions to specify which of the classes or subclasses you want to add.
6. DECW$TAILOR installs the files you selected and displays the names of those files. If you added device support files, the system automatically shuts down and reboots.

Caution To cancel DECW$TAILOR during the first and second phases, press Ctrl/C, Ctrl/Y, or Ctrl/Z. Canceling DECW$TAILOR during the third phase can cause a partially tailored disk. For a description of each phase, see Section 10.2.1.

After adding files to the system disk, apply any updates that affect them. For example, suppose you delete the Version 7.3 DECwindows 100 dots/inch video font files. Later on, you are able to use the 100 dots/inch fonts, so you run DECW$TAILOR to return the files to the system disk. You must then apply any OpenVMS VAX update that has occurred since Version 7.3 that affected the 100 dots/inch video font files. OpenVMS VAX update procedures create a .TXT file that contains a description of modified files. This file is usually named with the following format: SYS$UPDATE:VMSUn05n.TXT1.

Note ##### 1 Examine this file to determine if the update patched the 100 dots/inch font files.

Previous | Next | Contents | Index

| privacy and legal statement |
6630PRO_014.HTML