SetBlackList command - Revision history

Ekern at 18:38, 9 February 2023

2023-02-09T18:38:13Z

← Older revision		Revision as of 18:38, 9 February 2023
Line 2:		Line 2:

	{\|		{\|
	\|width="~~50%~~"\| '''Action:'''		\|width="125px"\| '''Action:'''
	\|width="~~50%~~"\|		\|width="775px"\|
	<span class="f_Para">Lets you dynamically specify or clear a procedure [[Running only to listed procedures\|Black List]], which identifies the outer procedures you do </span>''not''<span class="f_Para"> want the Debugger to debug. These procedures get executed but their code is not sent to or displayed in the Client. This command temporarily overrides any existing Black List, but it </span><span class="f_Notes">does </span>'''not'''<span class="f_Notes"> physically affect the contents of the black list file stored on disk </span><span class="f_Para">(</span><span class="f_Monospace">blacklist.txt</span><span class="f_Para">)</span><span class="f_Notes">. The command's effect is not persistent over runs of the Client.</span><span class="f_Para"> </span>		<span class="f_Para">Lets you dynamically specify or clear a procedure [[Running only to listed procedures\|Black List]], which identifies the outer procedures you do </span>''not''<span class="f_Para"> want the Debugger to debug. These procedures get executed but their code is not sent to or displayed in the Client. This command temporarily overrides any existing Black List, but it </span><span class="f_Notes">does </span>'''not'''<span class="f_Notes"> physically affect the contents of the black list file stored on disk </span><span class="f_Para">(</span><span class="f_Monospace">blacklist.txt</span><span class="f_Para">)</span><span class="f_Notes">. The command's effect is not persistent over runs of the Client.</span><span class="f_Para"> </span>

Ekern at 03:30, 9 December 2022

2022-12-09T03:30:31Z

← Older revision		Revision as of 03:30, 9 December 2022
Line 4:		Line 4:
	\|width="50%"\| '''Action:'''		\|width="50%"\| '''Action:'''
	\|width="50%"\|		\|width="50%"\|
	<span class="f_Para">Lets you dynamically specify or clear a procedure [[~~run_only_to_listed_procs.html~~\|Black List]], which identifies the outer procedures you do </span>~~<span class="f_EmphItal">~~not~~</span>~~<span class="f_Para"> want the Debugger to debug. These procedures get executed but their code is not sent to or displayed in the Client. This command temporarily overrides any existing Black List, but it </span><span class="f_Notes">does </span>~~<span class="f_EmphBold">~~not~~</span>~~<span class="f_Notes"> physically affect the contents of the black list file stored on disk </span><span class="f_Para">(</span><span class="f_Monospace">blacklist.txt</span><span class="f_Para">)</span><span class="f_Notes">. The command's effect is not persistent over runs of the Client.</span><span class="f_Para"> </span>		<span class="f_Para">Lets you dynamically specify or clear a procedure [[Running only to listed procedures\|Black List]], which identifies the outer procedures you do </span>''not''<span class="f_Para"> want the Debugger to debug. These procedures get executed but their code is not sent to or displayed in the Client. This command temporarily overrides any existing Black List, but it </span><span class="f_Notes">does </span>'''not'''<span class="f_Notes"> physically affect the contents of the black list file stored on disk </span><span class="f_Para">(</span><span class="f_Monospace">blacklist.txt</span><span class="f_Para">)</span><span class="f_Notes">. The command's effect is not persistent over runs of the Client.</span><span class="f_Para"> </span>

	'''Syntax:'''		'''Syntax:'''
Line 10:		Line 10:
	<p class="syntax">setBlackList [''proc''] ... </p>		<p class="syntax">setBlackList [''proc''] ... </p>

	where ''proc'' is one of possibly multiple, blank separated, procedure file names. Name matching is case insensitive, and [[~~running_to_specific_procedure.html~~#~~shortcuts~~\|wildcards]] are allowed.		where ''proc'' is one of possibly multiple, blank separated, procedure file names. Name matching is case insensitive, and [[Running to a specific procedure#Shortcuts for specifying procedure names\|wildcards]] are allowed.

	<span class="f_Para">If no names are specified, the current black list, if any, is treated as empty. If one or more procedure names are specified, the contents of the black list are overridden by this new set of procedure names. </span>		<span class="f_Para">If no names are specified, the current black list, if any, is treated as empty. If one or more procedure names are specified, the contents of the black list are overridden by this new set of procedure names. </span>
Line 17:		Line 17:

	# Put it in a User Language procedure.		# Put it in a User Language procedure.
	# Send it to the Client via the [[~~using_sirius_debug_cmd.html~~\|TN3270 DEBUG CLIENTCOMMAND]] Model 204 command.		# Send it to the Client via the [[TN3270 DEBUG Syntax\|TN3270 DEBUG CLIENTCOMMAND]] Model 204 command.

	<span class="f_Para">Doing this lets you have a mainframe based testing harness that sets up a list on the Client. For example: </span>		<span class="f_Para">Doing this lets you have a mainframe based testing harness that sets up a list on the Client. For example: </span>

Ekern: Created page with "TOC {| |width="50%"| '''Action:''' |width="50%"| Lets you dynamically specify or clear a procedure Black List, whi..."

2022-07-09T18:27:22Z

Created page with "__TOC__ {| |width="50%"| '''Action:''' |width="50%"| Lets you dynamically specify or clear a procedure Black List, whi..."

New page

__TOC__

{|
|width="50%"| '''Action:'''
|width="50%"|
Lets you dynamically specify or clear a procedure [[run_only_to_listed_procs.html|Black List]], which identifies the outer procedures you do not want the Debugger to debug. These procedures get executed but their code is not sent to or displayed in the Client. This command temporarily overrides any existing Black List, but it does not physically affect the contents of the black list file stored on disk (blacklist.txt). The command's effect is not persistent over runs of the Client. 

'''Syntax:'''

setBlackList [''proc''] ... 

where ''proc'' is one of possibly multiple, blank separated, procedure file names. Name matching is case insensitive, and [[running_to_specific_procedure.html#shortcuts|wildcards]] are allowed.

If no names are specified, the current black list, if any, is treated as empty. If one or more procedure names are specified, the contents of the black list are overridden by this new set of procedure names. 

You might use this command for testing: 

# Put it in a User Language procedure.
# Send it to the Client via the [[using_sirius_debug_cmd.html|TN3270 DEBUG CLIENTCOMMAND]] Model 204 command.

Doing this lets you have a mainframe based testing harness that sets up a list on the Client. For example: 

TN3270 DEBUG CLIENTCOMMAND 'setBlackList P.SHEMP'
TN3270 DEBUG CLIENTCOMMAND 'turnOnBlackList' 

See also the [[SetWhiteList command|setWhiteList]] command. 
|-
| '''Client menu:'''
| --
|-
| '''Introduced:'''
| Build 62
|}

[[Category:Debugger Commands]]

SetBlackList command - Revision history

Ekern at 18:38, 9 February 2023

Ekern at 03:30, 9 December 2022

Ekern: Created page with "__TOC__ {| |width="50%"| '''Action:''' |width="50%"| Lets you dynamically specify or clear a procedure Black List, whi..."

Ekern: Created page with "TOC {| |width="50%"| '''Action:''' |width="50%"| Lets you dynamically specify or clear a procedure Black List, whi..."