lenguajemacroensasporcarlosromojarorincc3b3n24062012

LENGUAJE
MACRO EN
SAS
Carlos Romojaro Rincón
INDICE
0. Introducción
0.1. ¿Qué es el lenguaje macro? (pg. 4)
1. Variables macro
1.1. Introducción (pg. 5)
1.2. Sintaxis (pg. 6)
1.3. Un primer uso (pg. 7)
1.4. Las variables macro (pg. 10)
1.4.1. Normas de uso (pg. 11)
1.4.2. La sentencia %LET (pg. 12)
1.4.3. Salida en Log (pg. 12)
1.4.4. Variables macro automáticas (pg. 15)
1.4.5. Ejemplos útiles (pg. 19)
1.5. Concatenación y referencias indirectas (pg. 20)
1.5.1. Tipos de concatenación (pg. 20)
1.5.2. Referencias indirectas (pg. 24)
1.6. Ámbito de las variables macro (pg. 26)
1.7. Destrucción de variables macro (pg. 28)
2.1. Introducción (pg. 31)
2.1.1. Sintaxis (pg. 31)
2.1.2. Paso de valores a programas macro (pg. 35)
2.1.3. Pequeñas herramientas para depurar (pg. 44)
2.2. Elementos y técnicas macro avanzadas (pg. 50)
2.2.1. Funciones macro (pg. 51)
2.2.1.1. Creación de funciones macro. (pg. 56)
2.2.2. Sentencias automatizadas (pg. 57)
2.2.2.1. Selectivas (pg. 59)
2.2.2.2. Iterativas (pg. 62)
2.2.3. Almacenamiento permanente de programas macro (pg. 64)
Carlos Romojaro Rincón
Programas macro
2. Programas macro
3
¿Qué es el lenguaje macro?
El lenguaje macro en SAS es una herramienta implementada dentro del lenguaje SAS
con la que se puede:




Crear código reutilizable fácilmente.
Pasar información entre diferentes pasos en SAS.
Potenciar el código mediante sentencias iterativas y condicionales.
Reducir considerablemente la cantidad de código del programa.
El lenguaje macro se compone de su propia sintaxis en la que los tonkens por
excelencia son:


% para indicar al procesador que se trata de una sentencia macro.
& para indicar al procesador el uso de una variable macro ya creada.
Como mas adelante veremos, este token indica al preprocesador de SAS que se trata
de una sentencia correspondiente al lenguaje macro.
Variables macro
Una de las características que hace más versátil a este lenguaje es el poder
implementarse fuera de cualquier procedimiento SAS. Lo que permite potenciar de
una manera eficaz la ejecución de procedimientos a nuestro antojo.
Carlos Romojaro Rincón
4
1.1.
Introducción a las variables macro
Para la comprensión del término variable macro diremos que se trata de una
variable texto normal, la cual tiene un comportamiento similar a una variable
texto (string) del lenguaje SAS.
Las variables macro son una de las partes fundamentales de todo el lenguaje
macro, otorga una gran versatilidad a los programas y son fáciles de usar.
La sintaxis general para el uso de una variable macro será:
%LET DIA = LUNES;
DATA PRUEBA;
INPUT PERSONA PIEZAS;
DATALINES;
1 10
2 15
3 9
;
TITLE "PRODUCCIÓN DEL &DIA";
PROC PRINT DATA = PRUEBA;
RUN;
PRODUCCIÓN DEL LUNES
Obs
1
2
3
PERSONA
1
2
3
PIEZAS
10
15
9
Carlos Romojaro Rincón
Variables macro
La salida de este programa será:
5
Hemos visto en el ejemplo anterior que el procesador macro concatena dentro
de un string la variable macro indicada.
Este es uno de los funcionamientos de las variables macros, aunque tiene más,
que se explicaran detalladamente más adelante.
1.2.
Sintaxis
Este tipo de variables deben de ser inicializadas antes de ser usadas. Para
hacerlo se deberá escribir la siguiente sentencia:
%LET nombrevariable<= valor>;
Nombrevariable es un valor obligatorio y valor es un parámetro opcional.
Por otro lado, el uso de la misma se realiza de la siguiente forma:
&nombrevariable;
Con la sentencia anterior se le indica al procesador macro que quiere usarse
esa variable.
Variables macro
El procesador macro, resolverá la variable como un valor texto y lo unirá si este
está acompañando un texto u otras sentencias.
Carlos Romojaro Rincón
6
1.3.
Un primer uso de las variables macro
Para poder empezar a vislumbrar el potencial que por ahora podemos sacar de
las variables macro se acompaña este capítulo de varios ejemplos:
DATA ALMACEN;
INPUT PROVEEDOR PIEZAS SEMANA;
DATALINES;
1025 200 20
5612 150 5
4124 210 10
8496 200 5
7455 150 5
8499 500 9
5485 2 5
;
RUN;
%LET AX =6;
PROC CHART DATA=ALMACEN;
VBAR PIEZAS /AXIS=&AX;
PROC CHART DATA=ALMACEN;
VBAR SEMANA /AXIS=&AX;
RUN;
Variables macro
La salida correspondiente:
Carlos Romojaro Rincón
7
En este ejemplo hemos usado la variable macro AX en varios procedimientos
diferentes. Esto es una de las grandes virtudes de las variables macro, puesto
que nos permite compartir la misma variable en multitud de procedimientos
diferentes que no permiten ni el uso de variables convencionales.
Siguiendo con el ejemplo anterior, vemos que con cambiar solamente una vez el
valor de la variable AX, podemos modificar el aspecto de los dos gráficos al
mismo tiempo. Además vemos otro de los funcionamientos de las variables
macros además de la concatenación visto antes, la asignación.
Veamos otro ejemplo:
DATA ALMACEN;
INPUT PROVEEDOR PIEZAS SEMANA;
DATALINES;
1025 200 20
5612 150 5
4124 210 10
8496 200 5
7455 150 5
8499 500 9
5485 2 5
;
RUN;
%LET AX= 6;
%LET SEMAX= 10;
PROC CHART DATA=ALMACEN;
VBAR PIEZAS /AXIS=&AX;
WHERE SEMANA < &SEMAX;
PROC CHART DATA=ALMACEN;
VBAR SEMANA /AXIS=&AX;
WHERE SEMANA < &SEMAX;
RUN;
La salida en este caso será:
Carlos Romojaro Rincón
Variables macro
QUIT;
8
Variables macro
Carlos Romojaro Rincón
9
1.4.
Las variables macro
Llegados a este capítulo ya tenemos unas nociones de los que son las variables
macro, de su uso y de sus posibles aplicaciones dentro de nuestros programas
SAS. Por lo que nos centraremos más en sus propiedades y características.
Como se dijo en un principio, las variables macro son variables texto, así es como
se almacenan en memoria. Veremos más adelante que existen formas de hacer
casting a otros tipos de datos (interger y punto flotante).
Si por ejemplo contiene un número que será usado en una operación
matemática, el procesador macro la convierte automáticamente en una variable
numérica. Se puede observar en el siguiente ejemplo. Pero no siempre ocurrirá
asi.
%LET VALOR = 10;
DATA VALORES;
INPUT X;
COEFICIENTE = X/ &VALOR;
DATALINES;
1
3
6
3
;
PROC PRINT DATA=VALORES;
RUN;
La salida resultante:
1
2
3
4
X
1
3
6
3
COEFICIENTE
0.1
0.3
0.6
0.3
Pero como vimos en ejemplos anteriores, el procesador macro también puede hacer
concatenaciones automáticas si la variable macro se usa por ejemplo dentro de un
string o en el nombre de un paso data como en el siguiente ejemplo:
Carlos Romojaro Rincón
Variables macro
Obs
10
%LET DIA = 12;
DATA ALMACEN_DIA&DIA;
INPUT PROVEEDOR PIEZAS SEMANA;
DATALINES;
1025 200 20
5612 150 5
4124 210 10
8496 200 5
;
PROC PRINT DATA = ALMACEN_DIA12;
RUN
1.4.1.
Normas de uso
Como todas las variables usadas en lenguajes de programación, las variables macro
tienen sus propias normas para ser nombradas, creadas y referenciadas dentro del
programa:
El nombre no puede empezar por un valor numérico.
El nombre no puede superar 32 caracteres.
La variable tiene una capacidad de 65 Kbytes.
Pueden ser referenciadas en cualquier parte del código.
El token para declararla y modificarla es %LET
El token para referenciarla es &
Si se quieren concatenar dentro de un texto, este debe estar encerrado entre
comillas dobles.
 No se pueden asignar valores a las variables macro automáticas.
 Su uso está sujeto a normas de ámbito.
 No pueden contener como nombre caracteres reservados por el sistema.
Carlos Romojaro Rincón
Variables macro







11
1.4.2 La sentencia %LET
La sentencia %LET nos permite definir variables y modificar su valor. Es una sentencia
perteneciente al código macro, por lo que solo la ejecutará el procesador macro.
Las variables macro, no soportan el valor missing. En caso de que una variable macro
no contenga ningún valor, se considerará como un valor NULL.
Otra característica de la sentencia %LET, es que no asigna a las variables macro valores
en blanco, los omite.
Veamos un ejemplo con dos sentencias %LET, las cuales acaban asignando el mismo
valor NULL a las dos variables:
%LET NULO=;
%LET NULO=
;
Pero también omite los valores en blanco antes o después de otros valores:
%LET VARIABLE= PRUEBA;
%LET NULO=
PRUEBA ;
En caso de que queramos por cualquier motivo almacenar valores en blanco, es
necesario recurrir a funciones quoting que serán explicadas en el próximo capítulo.
Este tipo de variables, cuando se usan dentro de un paso data, no se imprimen en la
ventana OUTPUT como ocurre con las variables convencionales de SAS. Por lo que si
queremos que se impriman en esta ventana deberá ser asignándoselas primeramente
a una variable convencional de SAS.
No obstante, habrá ocasiones donde nos interese que la información se imprima en la
ventana Log. A continuación se explican los procedimientos para hacerlo con lenguaje
macro.
Carlos Romojaro Rincón
Variables macro
1.4.3 Salida en Log
12
Tenemos dos opciones:
 %PUT
 SYMBOLGEN
Ambas sentencias no necesitan estar dentro de un procedimiento para que funcionen,
basta con que estén dentro del programa a ejecutar.
Estas sentencias son muy útiles para depurar los programas en busca de errores o
malas optimizaciones.
La sentencia %PUT, tiene el mismo comportamiento que su homóloga en código SAS
convencional, la sentencia PUT.
La sintaxis por lo tanto será de la siguiente forma:
%PUT &nombrevariable;
Como se puede observar, la diferencia entre las dos sentencias es el token%. Como ya
veremos en el próximo capítulo, una gran cantidad de sentencias del lenguaje macro
se diferencian únicamente del lenguaje SAS convencional por esta precedidas del
token %.
A continuación vemos un ejemplo del uso de la sentencia %PUT:
%LET FECHA = 17/06/2012;
Como se puede observar del ejemplo anterior, con la sentencia %PUT, no hace falta
encerrar el texto entre comillas, puesto que el procesador macro ya considera que
todo lo que vaya tras la sentencia %PUT hasta que se acabe la línea con el token punto
y coma, será texto. Las variables macro serán resueltas como texto automáticamente.
Con la sentencia %PUT también podemos realizar un escaneo de todas las variables
que componen un tipo determinado e imprimirlas en el LOG.
La sintaxis será:
Carlos Romojaro Rincón
Variables macro
%PUT INFORME A FECHA: &FECHA
13
En primer lugar la sentencia %PUT, seguida de alguna de estas opciones:





_automatic_
_all_
_user_
_global_
_local_
De toda esta lista, cabe mencionar la opción _user_ la cual nos mostrara en el LOG
todas las variables macro creadas por el usuario.
Además de _automatic_ con un funcionamiento igual al anterior pero con las variables
automáticas que veremos más adelante.
Otra sentencia que nospermitirá imprimir información en la ventana LOG será la
sentencia SYMBOLGEN.
Esta sentencia imprime en la ventana LOG todas las variables macro que se usen (salvo
cuando se use la sentencia &LET) en el programa, a diferencia de la sentencia %PUT en
la que se imprimen las que explícitamente se indiquen.
La sintaxis es muy sencilla, y simplemente hay que poner la siguiente sentencia, a
partir de la cual la opción symbolgen estará activada:
OPTIONS SUMBOLGEN;
Para deshabilitar la opción symbolgen y que dejen de aparecer las variables en la
ventana LOG, basta con escribir la siguiente sentencia:
RUN;
Variables macro
OPTIONS NOSYMBOLGEN;
Carlos Romojaro Rincón
14
A continuación vemos un ejemplo:
%LET FECHA = 18/06/2012;
%LET NOMBRE = CARLOS;
OPTIONS SYMBOLGEN;
%PUT HOY ES &FECHA;
%PUT MI NOMBRE ES &NOMBRE
La salida en la ventana LOG es:
1
%LET FECHA = 18/06/2012;
2
%LET NOMBRE = CARLOS;
3
4
OPTIONS SYMBOLGEN;
5
6
%PUT HOY ES &FECHA;
SYMBOLGEN: La macro variable FECHA se resuelve en 18/06/2012
HOY ES 18/06/2012
7
%PUT MI NOMBRE ES &NOMBRE
SYMBOLGEN: La macro variable NOMBRE se resuelve en CARLOS
8
9
RUN;
1.4.4 Variables macro automáticas
Cabe mencionar que no se puede crear ninguna variable con el nombre de alguna de
las variables automáticas, ni con palabras reservadas por el sistema SAS.
Por ejemplo:




SYS
SYSDAY
SIS
SISDAY
Carlos Romojaro Rincón
Variables macro
Son variables macro con información relativa al sistema donde esté instalada la
plataforma SAS, al propio sistema SAS y a la sesión SAS con la que se trabaje en ese
momento.
15
Hay tres tipos de variables macro automáticas:
 Permanentes
 Semi-Permanentes
 Editables
El primer tipo, son variables que contienen información del sistema, que se carga al
momento de iniciar la sesión SAS y que no cambian hasta que se cierra esta.
Algunas son:
Variable
SYSDATE
SYSDATE9
SYSDAY
SYSVER
SYSTIME
Descripción
Contiene la fecha de la sesión SAS, que
corresponde con la del sistema donde se
ejecute la plataforma. Está en formato
DATE7.
Igual que el anterior pero la fecha se
muestra en formato DATE9.
Devuelve el día en formato texto.
Almacena la versión de la plataforma SAS.
Almacena el momento en el que se inició
la sesión SAS actual.
El segundo tipo lo forman las variables que al igual que las anteriores contienen
información del sistema, pero el propio sistema puede modificarlas durante la sesión.
Algunas son:
Carlos Romojaro Rincón
Descripción
Devuelve un código de los errores que se
puedan producir. Algunos valores son:
0
La ejecución del programa se
realizó con éxito.
1
La ejecución del programa fue
cancelada por el propio usuario
por una sentencia RUN
CANCEL.
2
La ejecución del programa fue
Variables macro
Variable
SYSERR
16
cancelada por el propio usuario
por un comando ATTN o
BREAK.
3
SYSLIBRC
Error producido en modo no
interactivo o en ejecución por
lotes.
Devuelve el código de la última librería
creada en la actual sesión SAS.
El tercer tipo de variables automáticas lo componen variables creadas por el sistema
SAS, pero que pueden ser editadas por el usuario durante la sesión SAS.
Algunas son:
Variable
SYSDNS
SYSLAST
Descripción
Nombre del último data set creado en la
actual sesión SAS. Se almacena con un
espacio en blanco separando la librería y
el nombre del data set:
WORK PRUEBA
Igual que el anterior pero el carácter de
separación es un punto:
WORK.PRUEBA
Permisos
Variable
Permisos
Variable
Lectura y escritura
SYSBUFFR
Lectura y
escritura
SYSPARM
Lectura y escritura
SYSCC
Lectura y
escritura
SYSPBUFF
Lectura y escritura
SYSCMD
Lectura y
escritura
SYSRC
Lectura y escritura
SYSDEVIC
Solo lectura
SYSCHARWIDTH
Carlos Romojaro Rincón
Variables macro
La lista de variables macro automáticas es muy extensa, a continuación se muestra una
lista con algunas más relevantes, en este caso clasificadas según su permiso de
escritura:
17
Variable
Permisos
Variable
Lectura y escritura
SYSDMG
Solo lectura
SYSDATE
Lectura y escritura
SYSDSN
Solo lectura
SYSDATE9
Lectura y escritura
SYSFILRC
Solo lectura
SYSDAY
Lectura y escritura
SYSLAST
Solo lectura
SYSENCODING
Lectura y escritura
SYSLCKRC
Solo lectura
SYSENV
Lectura y escritura
SYSLIBRC
Solo lectura
SYSERR
Lectura y escritura
SYSLOGAPPLNAME
Solo lectura
SYSERRORTEXT
Lectura y escritura
SYSMSG
Solo lectura
SYSHOSTNAME
Solo lectura
SYSSCPL
Solo lectura
SYSINFO
Solo lectura
SYSSTARTID
Solo lectura
SYSJOBID
Solo lectura
SYSSTARTNAME
Solo lectura
SYSMACRONAME
Solo lectura
SYSTCPIPHOSTNA
ME
Solo lectura
SYSMENV
Solo lectura
SYSTIME
Solo lectura
SYSNCPU
Solo lectura
SYSUSERID
Solo lectura
SYSODSPATH
Solo lectura
SYSVER
Solo lectura
SYSPROCESSID
Solo lectura
SYSVLONG
Solo lectura
SYSPROCESSNAME
Solo lectura
SYSVLONG4
Solo lectura
SYSPROCNAME
Solo lectura
SYSWARNINGTEXT
Solo lectura
SYSSCP
Solo lectura
SYSINDEX
Solo lectura
SYSSITE
Para terminar este apartado, se acompaña un ejemplo del uso de las variables macro
automáticas:
Carlos Romojaro Rincón
Variables macro
Permisos
18
DATA ALMACEN_&SYSDATE;
INPUT PROVEEDOR PIEZAS SEMANA;
DATALINES;
1025 200 20
5612 150 5
4124 210 10
8496 200 5
;
TITLE "ALMACEN A FECHA: &SYSDATE";
PROC PRINT DATA = ALMACEN_&SYSDATE;
RUN;
Y la salida será:
1
2
3
4
1025
5612
4124
8496
200
150
210
200
SEMANA
20
5
10
5
1.4.5 Ejemplos útiles
Una forma bastante útil de dar provecho a las variables macro fuera de un programa
macro es usándolas como herramienta para ejecutar ciertas partes del programa de
una manera sencilla:
Carlos Romojaro Rincón
Variables macro
ALMACEN A FECHA: 01JAN12
Obs
PROVEEDOR
PIEZAS
19
%LET COMENINI1= * ;
%LET COMENINI2= / ;
%LET COMENFIN= /* ;
LIBNAME VV 'E:\';
&COMENINI1.&COMENINI2 DATA ESTUDIOHOMBRES;
SET VV.HOMBRES;
&COMENFIN RUN;
&COMENINI1.&COMENINI2 PROC FREQ DATA=ESTUDIOHOMBRES;
TABLES CINE;
&COMENFIN RUN;
En el capitulo 2 se verá una forma mas sencilla de hacer esto.
1.5.
Concatenación y referencias indirectas
El uso principal de las variables macro es la concatenación, ya sea con texto o con otras
variables macro.
1.5.1.
Tipos de concatenación
El lenguaje macro permite tres tipos de situaciones al concatenar variables macro con
texto:



Texto antes de la variable macro
Texto después de la variable macro
Varias variables macros seguidas
Carlos Romojaro Rincón
Variables macro
Como hemos visto en ejemplos anteriores, para concatenar variables macro con texto
no hacía falta el uso de ningún comando concatenador. Pero existen circunstancias en
las que esto no es así.
20