CSPG message termination

You can erase a logical message using the message terminate command. If the logical message is security protected, it is terminated only if your identification or class matches that in the message. After an erase, the last message still in the chain is displayed. The format of the message terminate command is as follows:

Read syntax diagramSkip visual syntax diagramCSPG MSGTERM
 
>>-CSPG--Msgterm--+-A-+--+---------+---------------------------><
                  +-B-+  '-,hhhhhh-'
                  +-C-+
                  +-H-+
                  '-R-'
 
Msgterm
A user-defined transaction identifier (1-7 characters) for the message termination transaction (for example T/) as defined in the PGPURGE system initialization parameter.
A
Terminates all logical messages destined for and being displayed on that terminal (including routed messages not yet displayed). The following message is received when termination has been completed:
   DFHTP4122 Requested purge completed successfully
B
Terminates the logical message being displayed on that terminal and all logical messages chained to it. This does not include routed messages. Whenever you have finished with all the output from a transaction, you should terminate the base message by entering a command of the form msgtermB. If the message has been built using a SEND PAGE command with the OPERPURGE option omitted, you can terminate the paging session by entering data other than a paging command.
C
Terminates the current (level) logical message and any messages chained below it.
H
Terminates all logical messages chained to the base logical message being displayed on that terminal. The page of the base message that was most recently displayed is redisplayed at the terminal.
R
Terminates all logical messages queued for immediate delivery (routed) to the terminal. The page that was being displayed at the terminal is redisplayed.
Hhhhhh
The 6-digit hexadecimal identifier of a specific, undelivered logical message to be erased. (This identifier would have been determined using a page query command.) If the message specified is security-protected, the operator should have a security code that matches the one in the message.

If a message identifier (hhhhhh) is not specified in the termination request and there is no message currently displayed, the oldest message is automatically retrieved.

Related tasks
Using CICS supplied transactions
CSPG--page retrieval
Retrieve a page
Message chaining with CSPG
Copying pages with CSPG
Using Autopage with CSPG
Displaying routed pages with CSPG
[[ Contents Previous Page | Next Page Index ]]