|
|
|
Clears messages queued to a dependent processing environment.
&INTCLEAR [ TYPE=ALL | REQ | RESP | ANY ]
&INTCLEAR is used to discard outstanding messages queued to a dependent processing environment by previous &INTCMD processing, or queued by INTQ commands issued by other NCL processes which have directed messages to this process.
When an &INTCMD statement is executed, the associated command is executed in the dependent processing environment for the process that executes the &INTCMD statement. The results of the command are queued and returned line-by-line to the procedure when each subsequent &INTREAD statement is processed. During the analysis of the results of the command, the logic of the procedure can determine that another &INTCMD is to be issued and that remaining results held from the previous &INTCMD are no longer required. &INTCLEAR is used to discard these outstanding results so that another &INTCMD statement is issued.
If the &INTCLEAR statement were not used, the results of the second &INTCMD would be queued in order behind the original outstanding results and would be presented in that order.
&INTCLEAR eliminates the need to process all of the results from a command.
Operands:
(Default) This option clears the dependent processing environment of the issuing process and any other dependent environments below it. This means that if the process had at some stage issued &INTCMD START to invoke an asynchronous, but dependent, NCL process, that process is terminated by &INTCLEAR TYPE=ALL.
Unsolicited message receipt and other PROFILE command options are reset.
This option clears all currently queued REQUEST messages such as those generated by INTQ TYPE=REQ commands from other processes that have sent messages to the issuing process.
This option clears all RESPONSE messages such as those generated by INTQ TYPE=RESP commands, commands issued by &INTCMD statements, or from other NCL command processes executing in the issuing process's dependent processing environment.
This option clears all currently queued RESPONSE and REQUEST messages. This format is equivalent to both TYPE=REQ and TYPE=RESP.
Examples: &INTCLEAR
&INTCLEAR TYPE=REQ
Discards all messages sent to us from other processes issuing INTQ or &WRITE TYPE=REQ commands.
&INTCLEAR
Discards all messages queued to our dependent processing environment and terminates all dependent processes and profiles.
&INTCLEAR TYPE=RESP
Discards all messages generated by dependent processes and queued to the internal response queue for processing by &INTREAD. Does not terminate any dependent processes.
Notes:
If an &INTCLEAR statement is processed after &INTCMD executes a command which has not yet completed, the final results for that command are logged and then discarded. To limit the volume of messages flowing to the log, use the &INTCLEAR TYPE=RESP statement to discard unwanted messages from the dependent response queue.
| Copyright © 2009 CA. All rights reserved. |
|