Environment
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
Note: Show Host Files is not available if you are connected to a CICS host.
To use Show Host Files:
- Connect a configured terminal session using Reflection Desktop 16, Reflection 2014 or Reflection 2011, and logon to your host.
- In the Transfer group on the Session ribbon, click File Transfer.
- 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.
- 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:
- On the Reflection Session ribbon, click File Transfer in the Transfer group.
- In the center of the Transfer dialog box, click the Setup button.
- 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.