Starting X Clients or the Session Manager on a VMS Host

  • Document ID:7021670
  • Creation Date:30-Mar-2000
  • Modified Date:25-Mar-2018
    • Micro Focus Products:
      Reflection X (legacy 14.1)

Environment

Reflection X version 13.0 through 14.x
Digital Equipment Corp. PATHWORKS
VMS System

Situation

Reflection X includes client files that enable you to start individual X clients or the DECwindows Session Manager on a VMS host using either TCP/IP or DECnet transports. This technical note explains how to locate and use these client files.

Resolution

If Your Transport is TCP/IP

  • KB 7021798 provides preconfigured Reflection templates designed to connect to a VMS host using Telnet or SSH.
  • We recommend configuring Reflection to use PCX$SERVER.COM to start individual X clients or the DECwindows Session Manager, using the Telnet connection method. PCX$SERVER.COM is included with DECwindows and PATHWORKS for OpenVMS and is installed on the VMS host.

For instructions, see Using PCX$SERVER.COM (TCP/IP only).

  • If you have the third-party product "MultiNet for OpenVMS v4.3 (TCP/IP Networking Solution)" installed and configured on your VMS host, you can use XDMCP (direct or broadcast) to connect to your VMS host to start the DECwindows Session Manager. This product allows you to run DECnet applications directly over TCP/IP, without modification.
  • If for some reason you cannot use PCX$SERVER.COM, (for example, PCX$SERVER.COM is not available on the host), Attachmate provides files for starting individual X clients or the DECwindows Session Manager. For more details, see KB 7021770.

If Your Transport is DECnet

  • Configure Reflection to start individual X clients or the DECwindows Session Manager using the PCX$SERVER connection method. PCX$SERVER should be installed on both the host and PC. PCX$SERVER is included with DECwindows, PATHWORKS for OpenVMS, and PATHWORKS client software.

For instructions, see Using PCX$SERVER as a Connection Method (DECnet only).

Using PCX$SERVER.COM (TCP/IP only)

Reflection X installs client files for use in starting individual X clients or the DECwindows Session Manager over TCP/IP. These client files make calls to the PCX$SERVER.COM file on the host, so that X clients or the Session Manager can be started using the recommended PCX$SERVER method.

First, verify that PCX$SERVER.COM is on the host. (Look for it in SYS$SYSTEM.) Then, follow the steps below.

  1. Start Reflection X.
  2. Click File > Open Client File and navigate to the "Documents and Settings\<All Users>\Templates\Attachmate\Reflection\X\1033\VMS" folder.
  3. Select one of the client files listed below, and then click Open.
    Application
    		Client File and Command Line
    X Client
    (DECterm, by default. See note below.)
    		pcxtcp.rxc
    @sys$system:pcx$server.com 4,%#%,0,TCPIP,%IP% $create/term/detach
    Session Manager
    		smpcxtcp.rxc
    @sys$system:pcx$server.com 4, %#%, 0, TCPIP, %IP% decw$startlogin.exe

The Reflection window appears with the client file selected. Verify that the command line in the Reflection window matches the command line in the table above.

Note: Pcxtcp.rxc opens a DECterm, by default. To open an X client directly, delete $create/term/detach in the command line and enter decw$ followed by the name of the X client you want to start. For example, to start the calculator, you would change the command line to:

@sys$system:pcx$server.com 4,%#%,0,TCPIP,%IP% decw$calc.exe
  1. In the Connection Settings portion of the Reflection X window, enter the host name, user name, and password. Click Connect.

Using PCX$SERVER as a Connection Method (DECnet only)

Reflection X installs two client files for starting individual X clients or the DECwindows Session Manager using PCX$SERVER over DECnet. Follow the steps below.

  1. Start Reflection X.
  2. Click File > Open Client File and navigate to the "Documents and Settings\<All Users>\Templates\Attachmate\Reflection\X\1033\VMS" folder.
  3. Select one of the client files listed below, and then click Open.
    Application
    		Client File and Command Line
    X Client
    (DECterm, by default. See note below.)
    		pcxserv.rxc
    %DN%,decw$terminal.exe
    Session Manager
    		sm_pcx.rxc
    %DN%,decw$startlogin.exe

The Reflection window appears with the client file selected. Verify that the command line in the Reflection window matches the command line in the table above.

Note: Pcxtcp.rxc opens a DECterm, by default. To open an X client directly, delete terminal.exe in the command line and enter the name of the X client you want to start. For example, to start the calculator, you would change the command line to:

%DN%, decw$calc.exe
  1. In the Connection Settings portion of the Reflection X window, enter the host name, user name, and password. Click Connect.

Additional Information

Legacy KB ID

This article was originally published as Attachmate Technical Note 1227.