SHUTTER_CHANCE: Visual Checkpoints for SAS Data Step Review.
MACRO_VARIABLE_SHUTTER_CHANCE: Visually check the global and local status and values of SAS macro variables at any point.

This macro generates a visual checkpoint output for selected records (based on N or conditional expression) using ODS html layout and table constructs.
It is useful for data review or debugging by presenting variable values in a clear format.

Parameters :

  CheckID  = Optional identifier for the output block. If not specified, &sysindex is used.
  n        = Record numbers (_N_) to trigger output generation (e.g., 1:3 or 2 4 6). Default is 1.
  if_condition  = Logical expression evaluated per observation (e.g., %nrbquote(SEX='F' and AGE=15)).
                  Macro-masking of conditional expressions is required.   
                  Cannot be used together with n.   
  varlist  = List of variable names to be displayed (space-delimited). This is required.

Usage example:

   data wk1;
     set sashelp.class;
     %shutter_chance(CheckID=A, n=1:3, varlist=Name Weight Height BMI);
     BMI = Weight / HEIGHT**2 * 703;
     %shutter_chance(CheckID=B, n=1:3, varlist=Name Weight Height BMI);
   run;

   data wk2;
     set sashelp.class;
     %shutter_chance(CheckID=C, if_condition=%nrbquote(SEX='F' and AGE=15), varlist=Name Sex Age);
   run;

data DT1;
length A A2 8.;
retain A2;
input A @@;
if A^=. then A2=A;
%shutter_chance(n= 1:6, varlist=A A2);
cards;
1 . 5 . . 10
;
run;

Description :
This macro displays the current macro variables grouped by their scope
(GLOBAL, LOCAL, AUTOMATIC) in a formatted SAS RWI(report Writing Interface) ods layout.
It is primarily intended for debugging or reporting the macro environment
during runtime. Output layout varies depending on the presence of automatic
variables as specified by the parameter.

Parameters :

     CheckID        = [optional] Identifier string used to distinguish the ODS output 
                            for each macro call. If not provided, defaults to &SYSINDEX.

     automatic_fl   = [optional] Flag to include AUTOMATIC scope variables. 
                      Accepts 'Y' or 'N'. Default is 'N'.

Usage Example :

    %let mvar1=A;
    %let mvar2=B;
    %macro_variable_shutter_chance(CheckID=A);

    %macro test;
        %global mvar2;
        %let mvar1=D;
        %let mvar2=E;
        %let mvar4=F;
        %do i = 1 %to 2;
            %put &i;
            %macro_variable_shutter_chance(CheckID=B);
            %if &i=1 %then %do;
                data _null_;
                    call symputx("mvar3","G","L");
                run;
            %end;
        %end;
    %mend;
    %test;

%macro_variable_shutter_chance(CheckID=ZZZ, automatic_fl =Y);

Notes and Caveats:
- This macro intentionally masks its own local macro variables from being
reported in the LOCAL scope output. This prevents internal implementation
details from appearing in the diagnostics. scope ne "MACRO_VARIABLE_SHUTTER_CHANCE" In other words, scope ne "MACRO_VARIABLE_SHUTTER_CHANCE2 is included in the extraction.

 - Some AUTOMATIC macro variables may reflect values that were populated or   
   modified as a result of this macro　own execution (e.g., SYSLAST, SYSERR,    
   SYSINDEX, etc.). Their presence or contents should be interpreted accordingly.  

0.2.0(04August2025): Add %macro_variable_shutter_chance
0.1.1(20July2025): Add if_condition Parameter in %shutter_chance.
0.1.0(17July2025): Initial version

The package is built on top of SAS Packages Framework(SPF) developed by Bartosz Jablonski.

For more information about the framework, see SAS Packages Framework.

You can also find more SAS Packages (SASPacs) in the SAS Packages Archive(SASPAC).

First, create a directory for your packages and assign a packages fileref to it.

filename packages "\path\to\your\packages";

Secondly, enable the SAS Packages Framework. (If you don't have SAS Packages Framework installed, follow the instruction in SPF documentation to install SAS Packages Framework.)

%include packages(SPFinit.sas)

Install SAS package you want to use with the SPF's %installPackage() macro.

• For packages located in SAS Packages Archive(SASPAC) run:

  %installPackage(packageName)

• For packages located in PharmaForest run:

  %installPackage(packageName, mirror=PharmaForest)

• For packages located at some network location run:

  %installPackage(packageName, sourcePath=https://some/internet/location/for/packages)

  (e.g. %installPackage(ABC, sourcePath=https://github.com/SomeRepo/ABC/raw/main/))

Load SAS package you want to use with the SPF's %loadPackage() macro.

%loadPackage(packageName)