TERM Commands
NonStop Pathway/iTS Management Programming Manual—426749-002
8-37
SUSPEND TCPTERM
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