DSN comando (TSO)
El mandato de TSO DSN inicia una sesión de DSN.
Para obtener una lista de los comandos que puede emitir con el comando TSO DSN, consulte Db2 commands.
DSN submandatos
El comando DSN tiene los siguientes subcomandos:
| Subcomando DSN | Descripción |
|---|---|
| ABEND | El submandato ABEND de DSN hace que la sesión DSN
finalice con un código de terminación anómala X'04E' y un código de
razón X'00C50101'. Importante:
 El subcomando ABEND se utiliza únicamente con fines de diagnóstico y sólo debe utilizarse bajo la dirección del servicio de asistencia técnica de IBM. Úsalo solo cuando diagnostiques un problema con DSN o Db2. |
| BIND PACKAGE | El submandato BIND PACKAGE de DSN crea un paquete de aplicaciones. Db2 registra la descripción del paquete en las tablas de catálogo y guarda el paquete preparado en el directorio. BIND PACKAGE también elimina las copias de paquetes eliminados. |
| BIND SERVICE | El subcomando BIND SERVICE (DSN) crea un paquete de aplicación que representa un servicio REST ( Db2 ). |
| BIND PLAN | El submandato BIND PLAN de DSN crea un plan de aplicación. Todos los programas de Db2 requieren un plan de aplicación para asignar recursos de Db2 y admitir solicitudes de SQL realizadas en tiempo de ejecución. |
| BIND QUERY | El submandato BIND QUERY de DSN lee el texto de la sentencia, el esquema predeterminado y un conjunto de opciones de enlace de cada fila de DSN_USERQUERY_TABLE e información de las filas de la tabla de EXPLAIN correlacionadas.Cuando LOOKUP(NO) está en efecto, Db2 inserta los datos pertinentes en ciertas tablas del catálogo. |
| FREE PACKAGE | El subcomando FREE PACKAGE se puede utilizar para eliminar una versión específica de un paquete, todas las versiones de un paquete o colecciones enteras de paquetes. |
| FREE SERVICE | El subcomando FREE SERVICE elimina un paquete de aplicación que representa un servicio REST ( Db2 ). |
| FREE PLAN | El subcomando FREE PLAN elimina los planes de aplicación de Db2. |
| FREE QUERY | El subcomando " FREE QUERY " elimina filas de ciertas tablas de catálogo para una o más consultas. Si cualquiera de las consultas especificadas están en la caché de sentencia dinámica, FREE QUERY las depura desde la caché de sentencia dinámica. |
| FREE STABILIZED DYNAMIC QUERY |
El comando FREE STABILIZED DYNAMIC QUERY elimina de ciertas tablas de catálogo una o más consultas dinámicas estabilizadas. Si alguna de las consultas especificadas está en la caché de sentencias dinámicas, FREE STABILIZED DYNAMIC QUERY también purga las sentencias de la caché de sentencias dinámicas. |
| DCLGEN (DECLARATIONS GENERATOR) | El generador de declaraciones (DCLGEN) produce una sentencia SQL DECLARE TABLE y una declaración de datos COBOL, PL/I o C para una tabla o una vista denominada en el catálogo. |
| REBIND PACKAGE | El submandato de DSN REBIND PACKAGE vuelve a enlazar un paquete de aplicación cuando se realizan cambios que afectan al paquete, pero no se han cambiado las sentencias SQL en el programa. |
| REBIND PLAN | El submandato de DSN REBIND PLAN vuelve a enlazar un plan de aplicación cuando realiza cambios en los atributos del plan, como por ejemplo la lista de paquetes. |
| REBIND TRIGGER PACKAGE | El subcomando DSN REBIND TRIGGER PACKAGE vuelve a vincular un paquete para un desencadenador básico. Puede identificar desencadenantes básicos consultando la tabla de catálogo SYSIBM.SYSTRIGGERS. Los valores en blanco de la columna SQLPL identifican desencadenantes básicos. Para activadores avanzados, utilice en su lugar el comando REBIND PACKAGE. |
| RUN | El submandato RUN de DSN ejecuta un programa de aplicación, que puede contener sentencias de SQL. |
| SPUFI | El subcomando SPUFI de DSN ejecuta el procesador SQL utilizando la entrada de archivos. |
Durante una sesión DSN, también puede introducir comandos de l Db2 , excepto START DB2. Db2 deben comenzar con un guión (-). Para obtener descripciones detalladas de los comandos de Db2 , consulte los comandos cuyos nombres van precedidos del carácter de reconocimiento -
y seguidos de (Db2
) en Db2 comandos.
También puede introducir comentarios empezándolos con un asterisco (*).
TEST '
prefix
.SDSNLOAD(DSN)' CP Los comandos de porcentaje no se reconocen durante una sesión DSN, solo son compatibles con el procesador de comandos TSO.
Medio ambiente para DSN
Una sesión DSN se ejecuta bajo TSO en modo de primer plano o en segundo plano. Cuando se ejecuta en modo de fondo, no se le pide que haga correcciones ni que proporcione información adicional necesaria.
También puede iniciar una sesión DSN desde un CLIST que se ejecute en modo de primer plano o de fondo.
Ámbito de uso compartido de datos : Miembro
Autorización para DSN
No se requiere ninguna para el comando DSN, pero se requiere autorización para la mayoría de los subcomandos.
Sintaxis para DSN
Descripciones de opciones para DSN
- SYSTEM
- (nombre-subsistema)
- Especifica el nombre del subsistema de la e Db2 .
- ( nombre-del-archivo-del-grupo )
- Especifica el nombre de archivo adjunto del grupo de intercambio de datos.
- (nombre-del-archivo-del-subgrupo)
- Especifica el nombre de archivo adjunto del subgrupo del grupo de intercambio de datos.
El valor predeterminado es SYSTEM( DSN ) Este valor puede modificarse durante la instalación de Db2 .
- RE INTENTAR (entero)
- Especifica el número (entero) de veces adicionales que se debe intentar la conexión al subsistema Db2 si Db2 no está activo o si se ha alcanzado el número máximo de conexiones por lotes cuando se emite DSN. Los reintentos se producen a intervalos de 30 segundos.
El valor predeterminado es RETRY( 0 ). El número máximo de reintentos es 120.
- TEST(ent ero )
- Especifica los dos últimos dígitos (enteros) del nombre del módulo para rastrear un único módulo DSN. Especifique un número mayor de 100 para rastrear todos los módulos DSN. Los mensajes de información de seguimiento de DSN se escriben en la sentencia DD TSO SYSTSPRT y, opcionalmente, en la sentencia DD DSNTRACE.
- GROUP
- ( SÍ )
- Especifica que el procesamiento de archivos adjuntos de grupo se considera cuando el sistema no está activo.
- (NO)
- Especifica que no se considera el procesamiento de adjuntos de grupo.
- ASUSER( userid )
- Especifica un ID de usuario para asociarlo a la conexión de confianza para la sesión DSN actual.
Se establece una conexión de confianza si el ID de autorización principal y el nombre del trabajo coinciden con un contexto de confianza definido en Db2. El ID de usuario que especifique como ASUSER pasa por el procesamiento estándar de autorización y salida de conexión para recoger los ID primario y secundario. Si el ID de autorización principal puede utilizar la conexión de confianza sin autenticación, Db2 establece la conexión de confianza para el ID de usuario ASUSER. El ID de autorización principal, cualquier ID de autorización secundaria y cualquier función asociada al ID de usuario ASUSER ya están activos para la conexión de confianza.
Si el ID de autorización principal asociado con el ID de usuario que especifique en la opción ASUSER no tiene permiso para utilizar la conexión de confianza o requiere información de autenticación, la solicitud de conexión fallará.
Db2 conserva el valor ASUSER solo durante la sesión DSN.
Notas de uso para DSN
- En el funcionamiento en primer plano, se le solicita que introduzca la cadena de aviso DSN en el terminal. En modo de fondo, su entrada se lee desde el conjunto de datos SYSTSIN.
- Excepto para los nombres de tablas delimitadas en el comando DCLGEN, las entradas en minúsculas se cambian a mayúsculas.
- Si se especifican palabras clave duplicadas de cualquier subcomando, solo se procesa la última de estas palabras clave. Por ejemplo, si tanto MIEMBRO( dbrm-member-name1 ) y MIEMBRO( dbrm-member-name2 ) se especifican con BIND PLAN, Db2 recibe solo este último, MEMBER( dbrm-member-name2 ).
- Si se pulsa ATENCIÓN ( PA1 ) durante una sesión DSN y se especifica PROMPT en el perfil de usuario TSO, aparece el mensaje DSNE005 :
EXECUTION IS INTERRUPTED, ENTER C TO CANCEL, OR ANY OTHER REPLY TO RESUME THE subcommand SUBCOMMAND.Si introduce C, el subcomando actual se cancela y la conexión de sub Db2 o actual finaliza; se establece una nueva y aparece otro indicador DSN. Cualquier otra respuesta, excepto ATENCIÓN, hace que el subcomando actual continúe desde el punto en el que se interrumpió.
Si una sesión DSN se inicia desde un CLIST, o un CLIST se ejecuta bajo DSN, CONTROL PROMPT debe especificarse en el CLIST para recibir el mensaje DSNE005.
- Después de procesar un comando durante una sesión DSN, se le pedirá que introduzca datos. Ese ciclo continúa hasta que usted finaliza la sesión.
- Puede finalizar la sesión realizando una de las siguientes acciones:
- Emite el subcomando END. El control pasa a TSO.
- Pulse ATENCIÓN y responda al mensaje pulsando ATENCIÓN de nuevo.
- Emitir otro comando DSN. La sesión anterior finaliza y comienza una nueva.
Procesamiento del código de retorno DSN: al final de una sesión DSN, el registro 15 contiene el valor más alto utilizado por cualquier subcomando DSN en la sesión o por cualquier programa ejecutado utilizando el subcomando RUN. Su entorno de tiempo de ejecución podría dar formato a ese valor como un código de retorno. Sin embargo, el valor no se origina en DSN.
Establecimiento de un contexto de confianza mediante TSO y DB2I: DB2I se ejecuta bajo TSO utilizando servicios de ISPF. DB2I : proporciona un front-end e ISPF e para herramientas como SPUFI y DCLGEN y tareas como la preparación de programas de instalación ( Db2 ) y la unión de planes y paquetes. El panel de valores predeterminados de DB2I incluye el campo AS USER. Utilice el campo COMO USUARIO para especificar un nombre de autorización que se utilizará para la sesión actual asociada con la conexión de confianza. La conexión de confianza se establece cuando el ID de inicio de sesión del TSO coincide con el ID de autorización del sistema y el nombre de trabajo definidos para un contexto de confianza. El campo ASUSER siempre está en blanco al entrar en DB2I. Si introduce un valor en el campo AS USER, se pasa a todas las llamadas TSO attach (DSN) utilizando la opción ASUSER del comando DSN (TSO).
Instalaciones de conexión para monitores : Para programas de larga duración como los monitores, utilice una instalación de conexión programable como CAF o RRSAF, en lugar de utilizar la instalación de conexión TSO ( Db2 ). La función de adjuntar TSO no está diseñada para su uso en un programa de larga duración. El uso del servicio de adjuntos TSO para ese tipo de programa podría causar problemas de almacenamiento o recuperación.
Ejemplos de DSN
- Ejemplo: Iniciar una sesión DSN con varios intentos de reintento
- El siguiente comando inicia una sesión DSN. Si el intento de conexión a Db2 falla, se realizan hasta cinco reintentos, a intervalos de 30 segundos.
DSN SYSTEM (DB2) RETRY (5) - Ejemplo: Iniciar una sesión DSN, ejecutar un programa y finalizar una sesión DSN
- El siguiente ejemplo muestra los comandos para iniciar una sesión DSN, ejecutar un programa y finalizar la sesión DSN.
TSO prompt : READY USER enters: DSN SYS(SSTR) DSN prompt : DSN USER enters: RUN PROGRAM(MYPROG) DSN prompt : DSN USER enters: END TSO prompt : READY