Skip to content
Thoroughbred Software InternationalThoroughbred Software InternationalThoroughbred DocumentationDocs

*GPSD - Ghost Task Communication Utility

Purpose

This utility connects your terminal to a currently running (STARTed) ghost task. Once you are connected to the ghost task you can:

  • Look at what the ghost task is currently executing.
  • Initiate a program to run under the ghost task.
  • Modify the ghost task program to correct an error situation.

Any terminal or user task can communicate with any STARTed ghost task, but only one terminal or task can have a ghost task open at one time.

For more information on ghost tasks, refer to the related section in the Thoroughbred Basic Developer Guide and Basic Customization and Tuning Guide Volume I.

Procedure

To run this utility from Thoroughbred Basic Console Mode, type:

RUN “*GPSD” and press Enter.

To select this utility from the Thoroughbred Basic Utilities Menu, type one of the following:

G and press Enter.

*G and press Enter.

*GPSD and press Enter.

Menu option # and press Enter.

The following message is displayed:

ENTER GHOST ID

Enter a valid ghost task ID (G0 through G9, GA through GZ or Ga through Gz) for a STARTed ghost task. The system prompts:

COMMUNICATING WITH G#,
G# WILL NOW BE ATTACHED TO T#.
PRESS THE ESCAPE KEY TO BREAK.

(where: G# is the ghost task ID and T# is the terminal ID.)

Note: The ghost task is unavailable to all other terminals while it is attached to the terminal.

At this point the system enters Thoroughbred Basic Console Mode or returns to the program that started the utility. You can now make inquiries or modifications. To terminate the communication, press Escape. The system prompts:

THE ATTACHMENT BETWEEN G# AND T# HAS BEEN BROKEN

The system returns to the Thoroughbred Basic Utilities Menu.

Error Messages

NO GHOSTS ARE CONFIGURED
This message indicates that there are no ghost tasks specified for this user. Refer to the ghost task section in the Thoroughbred Basic Reference Manual.
TASK IS NOT CONFIGURED - <CR> TO CONTINUE
This message indicates that the ghost task specified was not configured in the IPLINPUT file for this user.
TASK IS NOT STARTED - <CR> TO CONTINUE
The specified ghost task has not been run. The user must initiate the desired ghost task by using the START directive. Please refer to the Functions, directives, and Variables section of this manual for more information on the START directive.

From the Thoroughbred Basic Utilities, version 8.9.1. Open this page in the PDF