Using the Show Host Files File Transfer Dialog in Reflection Desktop, Reflection 2014, or Reflection 2011

  • 7021498
  • 06-Jul-2007
  • 05-Jul-2018

Environment

Reflection Desktop (including Pro, or for IBM) 16.0 or higher
Reflection 2014
Reflection for IBM 2014
Reflection for IBM 2011
Reflection Standard Suite 2011

Situation

This technical note provides information on using the Show Host Files feature to display a list of files residing on a CMS or TSO host system with a 3270 IBM Host session in Reflection Desktop 16, Reflection 2014, or Reflection 2011.  Information for troubleshooting Show Host Files problems is also provided.

Resolution

The Show Host Files feature makes it possible to quickly retrieve a list of host file names from a 3270 IBM Host system.  The host files are displayed in a tree view, and the display you see depends on the protocol selected.  Reflection displays only those files that can be transferred using the currently selected transfer protocol.

Note: Show Host Files is not available if you are connected to a CICS host.

To use Show Host Files:

  1. Connect a configured terminal session using Reflection Desktop 16, Reflection 2014 or Reflection 2011, and logon to your host.
  2. In the Transfer group on the Session ribbon, click File Transfer.
  3. In the Transfer dialog box, click Setup. On the Protocol tab, select Mainframe under Protocol and select the proper system type (CMS or TSO) under Host system. Click OK.
  4. Click the Show Host Files button.

Using the Show Host Files Feature on CMS and TSO Systems

The process that Reflection uses to display a list of host files on the workstation differs between CMS and TSO systems.

CMS

On a CMS system, the Show Host Files button executes the LISTFILE command through the terminal session. The output of LISTFILE is then used to populate the Show Host Files list box with file names.

TSO

On a TSO system, the Show Host Files button executes the LISTCAT command through the terminal session. The output of the LISTCAT command is then used to populate the Show Host Files list box with file names.

Note: Some prior versions of Reflection required you to upload two Attachmate-supplied REXX execs to TSO to support the Show Host Files function. These files (WRQLDS and WRQLCAT) are no longer needed.

Troubleshooting Show Host Files Problems

If clicking the Show Host Files button does not display the host file list, follow these troubleshooting procedures in the order they are presented.

Verify Your Host Connection

Verify that you are connected to the host and that the correct system (CMS or TSO) has been selected. Follow these steps to change the system type, if necessary:

  1. On the Reflection Session ribbon, click File Transfer in the Transfer group.
  2. In the center of the Transfer dialog box, click the Setup button.
  3. On the Transfer Setup > Protocol tab, select Mainframe under Protocol and select the proper system type (CMS or TSO) under Host system. Click OK.

Verify That the Host Screen Can Accept Input

Verify that the host screen can accept and process command input. Not all host screens can accept commands. Being at the CMS or TSO command prompt is preferred, but you may also be in ISPF if you use Option 6.

Verify the CMS Command

If you are on a CMS system, logon to your host and enter the following command at the Ready; prompt:

LISTFILE

If you receive an error when attempting to run LISTFILE, contact your system administrator for assistance.

If the command runs without generating an error, contact Micro Focus Customer Support to trouble-shoot further problems with the Show Host Files functionality.

Verify the TSO Command

If you are on a TSO system, logon to your host and enter the following command at the READY prompt:

LISTCAT

If you receive an error when attempting to run LISTCAT, contact your system administrator for assistance.

If the command runs without generating an error, contact Micro Focus Customer Support to trouble-shoot further problems with the Show Host Files functionality.

Additional Information

Legacy KB ID

This document was originally published as Attachmate Technical Note 2213.