TERM Commands
NonStop Pathway/iTS Management Programming Manual—426749-002
8-39
SUSPEND TERM
SUSPEND TERM
Use the SUSPEND TERM command to direct the TCP to temporarily suspend
execution of the SCREEN COBOL program. This command can be used for debugging
when it is important to preserve the TERM object in its most recent state. The
RESUME TERM 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 has reached a SCREEN COBOL ACCEPT statement.
•
The SCREEN COBOL special register STOP-MODE 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, initialize the ZTERM field in ZPWY-MAP-SEL-TERM 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 continuation is specified, 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-TERM