SetWhiteList command - Revision history

Ekern at 18:39, 9 February 2023

2023-02-09T18:39:57Z

← Older revision		Revision as of 18:39, 9 February 2023
Line 3:		Line 3:

	{\|		{\|
	\|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\|White List]], which explicitly identifies the outer procedures you want the to debug. Unlisted procedures get executed, but their code is not sent or debugged. This command overrides any existing White List, but it </span><span class="f_Notes">does </span>'''not'''<span class="f_Notes"> physically affect the contents of the white list file stored on disk </span><span class="f_Para">(</span><span class="term">whitelist.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\|White List]], which explicitly identifies the outer procedures you want the to debug. Unlisted procedures get executed, but their code is not sent or debugged. This command overrides any existing White List, but it </span><span class="f_Notes">does </span>'''not'''<span class="f_Notes"> physically affect the contents of the white list file stored on disk </span><span class="f_Para">(</span><span class="term">whitelist.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 16:06, 13 December 2022

2022-12-13T16:06:00Z

← Older revision		Revision as of 16:06, 13 December 2022
Line 5:		Line 5:
	\|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~~\|White List]], which explicitly identifies the outer procedures you want the to debug. Unlisted procedures get executed, but their code is not sent or debugged. This command overrides any existing White List, but it </span><span class="f_Notes">does </span>'''not'''<span class="f_Notes"> physically affect the contents of the white list file stored on disk </span><span class="f_Para">(</span><span class="~~f_Monospace~~">whitelist.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\|White List]], which explicitly identifies the outer procedures you want the to debug. Unlisted procedures get executed, but their code is not sent or debugged. This command overrides any existing White List, but it </span><span class="f_Notes">does </span>'''not'''<span class="f_Notes"> physically affect the contents of the white list file stored on disk </span><span class="f_Para">(</span><span class="term">whitelist.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 11:		Line 11:
	<p class="syntax">setWhiteList [proc]... </p>		<p class="syntax">setWhiteList [proc]... </p>

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

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

	<span class="f_Para">You might use this command for testing by putting it in a User Language procedure and sending that to the client via the existing [[~~using_sirius_debug_cmd.html~~#~~sirdebug_clientcmd~~\|TN3270 DEBUG CLIENTCOMMAND]] </span><~~span class="f_Product"~~>Model 204</~~span~~><span class="f_Para"> command. Doing this lets you have a mainframe based testing harness that sets up a white list on the Client. </span>		<span class="f_Para">You might use this command for testing by putting it in a User Language procedure and sending that to the client via the existing [[TN3270 DEBUG Syntax#TN3270 DEBUG CLIENTCOMMAND\|TN3270 DEBUG CLIENTCOMMAND]] </span><var>Model 204</var><span class="f_Para"> command. Doing this lets you have a mainframe based testing harness that sets up a white list on the Client. </span>

	<span class="f_Para">For example: </span>		<span class="f_Para">For example: </span>

Ekern at 17:48, 8 July 2022

2022-07-08T17:48:20Z

← Older revision		Revision as of 17:48, 8 July 2022
Line 19:		Line 19:
	<span class="f_Para">For example: </span>		<span class="f_Para">For example: </span>

	<~~span~~ class="~~f_CodeExample~~">TN3270 DEBUG CLIENTCOMMAND 'setWhiteList P.MOE P.LARRY' ~~</span><br />~~		<p class="syntax">TN3270 DEBUG CLIENTCOMMAND 'setWhiteList P.MOE P.LARRY'
	~~<span class="f_CodeExample">~~TN3270 DEBUG CLIENTCOMMAND 'turnOnWhiteList' </~~span~~>		TN3270 DEBUG CLIENTCOMMAND 'turnOnWhiteList' </p>

	<span class="f_Para">See also the </span><span class="f_Monospace">[[SetBlackList command\|setBlackList]]</span><span class="f_Para"> command. </span>		<span class="f_Para">See also the </span><span class="f_Monospace">[[SetBlackList command\|setBlackList]]</span><span class="f_Para"> command. </span>

Ekern at 17:46, 8 July 2022

2022-07-08T17:46:53Z

← Older revision		Revision as of 17:46, 8 July 2022
Line 22:		Line 22:
	<span class="f_CodeExample">TN3270 DEBUG CLIENTCOMMAND 'turnOnWhiteList' </span>		<span class="f_CodeExample">TN3270 DEBUG CLIENTCOMMAND 'turnOnWhiteList' </span>

	<span class="f_Para">See also the </span><span class="f_Monospace">[[~~setblacklist_cmd.html~~\|setBlackList]]</span><span class="f_Para"> command. </span>		<span class="f_Para">See also the </span><span class="f_Monospace">[[SetBlackList command\|setBlackList]]</span><span class="f_Para"> command. </span>
	\|-		\|-
	\| '''Client menu:'''		\| '''Client menu:'''

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

2022-07-08T17:28:53Z

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

New page

__TOC__

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

'''Syntax:'''

setWhiteList [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 white list is treated as empty. If one or more procedure names are specified, the contents of the white list are overridden by this new set of procedure names. 

You might use this command for testing by putting it in a User Language procedure and sending that to the client via the existing [[using_sirius_debug_cmd.html#sirdebug_clientcmd|TN3270 DEBUG CLIENTCOMMAND]] Model 204 command. Doing this lets you have a mainframe based testing harness that sets up a white list on the Client. 

For example: 

TN3270 DEBUG CLIENTCOMMAND 'setWhiteList P.MOE P.LARRY' 
TN3270 DEBUG CLIENTCOMMAND 'turnOnWhiteList' 

See also the [[setblacklist_cmd.html|setBlackList]] command. 
|-
| '''Client menu:'''
| --
|-
| '''Introduced:'''
| Build 62
|}

[[Category:Debugger Commands]]

SetWhiteList command - Revision history

Ekern at 18:39, 9 February 2023

Ekern at 16:06, 13 December 2022

Ekern at 17:48, 8 July 2022

Ekern at 17:46, 8 July 2022

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

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