Pathway/iTS Management Programming Manual

TERM Commands

NonStop Pathway/iTS Management Programming Manual—426749-002

8-37

SUSPEND TCPTERM

Use the SUSPEND TCPTERM command to direct a specific TCP to temporarily

suspend execution of the SCREEN COBOL program. The TCPTERM object must be

running before it can be suspended.

This command can be used for debugging when it is important to preserve the TERM

object in its most recent state. The RESUME TERM or RESUME TCPTERM command

releases the suspension.

A TERM object is suspended as soon as it reaches a qualified state, which exists when

the following three conditions are met:

•

The TERM object has reached a SCREEN COBOL ACCEPT statement.

•

The SCREEN COBOL STOP-MODE special register is set to zero.

•

The TERM (if running under TMF auditing) is not in TMF transaction mode.

This command can be issued to configured and temporary TERM objects.

Continuation

To suspend all TERM objects under the control of a single TCP, initialize the ZTCP

field in ZPWY-MAP-SEL-TERM to the name of the TCP and initialize the ZTERM field

to ZPWY-VAL-ALLTERM. Reissue the command repeatedly, using the context token

returned by the PATHMON process, until no data is returned in the response buffer.

When you specify continuation, responses are returned only for TERM objects in the

RUNNING state. For more information, see Specifying Continuation on page 3-21.

Command Syntax

For tokens that may be present in the command and response buffers but are not

listed, see Unlisted Tokens on page 3-36. For descriptions of tokens and fields, see

Section 4 through Section 6.

Command

ZPWY-CMD-SUSPEND

Object Type

ZPWY-OBJ-TCPTERM