PH-STATUS

Displays status information on each TIPH process, as recorded in the PH-HISTORY file.

Syntax

PH-STATUS {taskId portNumber} {option}

Syntax Elements

taskId The name of the TIPH task you specified in the PH-START procedure.

To display all TIPH processes in the PH-HISTORY file that have run on the specified port number, type an asterisk (*) in place of the task-id name.

portNumber The TIPH port number that is running the TIPH process you want to display.

Option

P Printer. Sends the status information to the printer. If you do not specify the P option, the information is displayed on the terminal screen.

Comments

If you specify the task-id name and the port number, the information on the TIPH process running on the specified port is displayed.

If you specify the task-id name and do not specify the port number, the PH-STATUS screen is displayed along with the system message, INPUT FOR LINE#nnnn.

If you do not specify the task-id name and the port number, all TIPH processes are displayed.

If you specify the P option the PH-STATUS screen is directed to the printer instead of the terminal screen.

Screen Field Definitions

The information displayed on the PH-STATUS screen is described below:

TASK-ID  Name of the TIPH process specified in the PH-START procedure.

LINE  The port number running the TIPH process.

ACCOUNT  Name of the account that the TIPH process is logged onto.

STARTER-ACC  Name of the account that started the TIPH process.

DATE  Date the TIPH process started.

TIME  Time the TIPH process started.

STATUS  Current TIPH process status (see Status Codes below).

OP  Options assigned to the TIPH process. Note that if you assign the H option to a job, this option is not displayed on the PH-STATUS screen as it is a function of the starting of the TIPH, not the TIPH itself.

OUTFL#  Spooler print job number that contains the terminal output.

Status Codes

A  TIPH process is Active.

D  No Disk Space.

K  TIPH process was aborted by the PH-KILL command.

Q  Print job table is full.

T  TIPH process Terminated normally.

X  Abnormal abort. TIPH process was aborted by the process itself because the input statement was encountered with no more stacked input.

Comments

If the PH-STATUS screen contains more than one page, press RETURN to display the next.

For a discussion on how to clear the status information from the PH-STATUS screen, refer to the description of the PH-HISTORY file.

Example

This example displays all TIPH processes recorded in the PH-HISTORY file.

:PH-STATUS

The PH-STATUS screen is displayed.

TASK-ID...LINE ACCOUNT... STARTER-ACC DATE........ TIME.... STATUS OP OUTFL#
FS        4    SYSPROG    DOC         06 OCT 1991  08:17:55   T            3
LGRADE    6    REG        ADM         06 OCT 1991  10:30:37   A     T 
S.INV     7    INV        MASTER      06 OCT 1991  13:00:12   K            1
CMP.BP    12   CHRIS      CHRIS       06 OCT 1991  15:04:59   T            2
4 ITEMS LISTED
: