Variables del sistema

Función de sistema/invocación Descripción
ConverseVar.commitOnConverse Si se establece en 1, se produce un compromiso y una liberación de los recursos en una aplicación de texto, antes de que un programa no segmentado emita una operación de inversión (converse). El valor por omisión es 0 para programas no segmentados y 1 para programas segmentados.
ConverseVar.eventKey Identifica la tecla pulsada por el usuario para devolver un formulario a un texto EGL o un programa Web.
ConverseVar.printerAssociation Permite especificar, en tiempo de ejecución, el destino de salida cuando imprima un formulario de impresión.
ConverseVar.segmentedMode Se utiliza en una aplicación de texto para cambiar el efecto de la sentencia converse, pero la variable se pasa por alto con esta finalidad en los programas llamados.
ConverseVar.validationMsgNum Está disponible en una aplicación de texto y contiene el valor asignado por ConverseLib.validationFailed.
sysVar.arrayIndex

Contiene un número:

  • El número del primer elemento de una matriz que coincide con la condición de búsqueda de una expresión lógica simple con un operador in.
  • Cero, si ningún elemento de la matriz coincide con la condición de búsqueda.
  • El número del último elemento modificado en la matriz destino después de una sentencia move ... for count.
sysVar.callConversionTable
Contiene el nombre de la tabla de conversión utilizada para convertir datos cuando el programa hace lo siguiente durante la ejecución:
  • Pasa argumentos durante una llamada a un programa de un sistema remoto
  • Pasa argumentos cuando se invoca un programa remoto mediante la función de sistema sysLib.startTransaction
  • Accede a un archivo de una ubicación remota
sysVar.conversationID Almacena el ID de conversación, que se asigna cuando un programa EGL utiliza un registro de UI para presentar una página Web.
sysVar.errorCode

Recibe un código de estado después de alguno de los siguientes eventos:

  • La invocación de una sentencia call, si dicha sentencia se encuentra en un bloque try
  • Una operación de E/S en un archivo indexado, MQ, relativo o serie
  • La invocación de casi cualquier función de sistema en los siguientes casos:
    • La invocación se encuentra dentro de un bloque try; o
    • El programa se ejecuta en modalidad de compatibilidad de VisualAge Generator y VGVar.handleSysLibraryErrors se ha establecido en 1
sysVar.formConversionTable Contiene el nombre de la tabla de conversión utilizada para la conversión de texto bidireccional cuando un programa Java generado por EGL actúa del siguiente modo:
  • Muestra un formulario de texto o de impresión que incluye una serie de caracteres hebreos o árabes; o
  • Muestra un formulario de texto que acepta una serie de caracteres hebreos o árabes del usuario.
sysVar.overflowIndicator Se establece en 1 cuando se produce un desbordamiento aritmético. Al comprobar el valor de esta variable, puede probar las condiciones de desbordamiento.
sysVar.remoteSystemID Contiene el nombre del sistema para la ubicación de una entidad remota: un programa, un archivo VSAM, una transacción CICS remota o una cola de datos temporal.
sysVar.returnCode Contiene un código de retorno externo, tal como establece el programa y está disponible en el sistema operativo.
sysVar.sessionID Contiene un ID que es específico de la sesión de servidor de aplicaciones Web.
sysVar.sqlState Contiene el valor de estado SQL para la operación de E/S SQL finalizada más recientemente. El código se obtiene del área de comunicaciones SQL (SQLCA) y puede variar según el gestor de bases de datos relacionales.
sysVar.sqlca Contiene toda el área de comunicaciones de SQL (SQLCA).
sysVar.sqlcode Contiene el código de retorno para la operación de E/S SQL finalizada más recientemente. El código se obtiene del área de comunicaciones SQL (SQLCA) y puede variar según el gestor de bases de datos relacionales.
sysVar.systemType Identifica el sistema destino en el que se ejecuta el programa.
sysVar.terminalID

En relación a código COBOL en CICS, sysVar.terminalID contiene el identificador de terminal CICS. En relación a código COBOL utilizado para el proceso por lotes de z/OS, sysVar.connectionID está en blanco.

En relación a código COBOL en iSeries, sysVar.terminalID se inicializa con blancos; y si el código es interactivo, la variable se restablece con el nombre de dispositivo terminal recibido de una consulta de los atributos del trabajo activo.

En relación al código Java, sysVar.terminalID (al igual que sysVar.sessionID) se inicializa desde la propiedad del sistema user.name de la máquina virtual Java y si la propiedad no puede recuperarse, sysVar.terminalID está en blanco.

sysVar.transactionID En CICS, la variable de sistema sysVar.transactionID actúa del siguiente modo:
  • Cambia el ID de transacción utilizado para invocar el programa después de una sentencia converse en un programa segmentado.
  • Inicialmente, contiene el valor especificado para la opción restartTransactionID del descriptor de construcción o (en ausencia de ese valor) contiene el ID de transacción utilizado para invocar el programa, excepto en el caso de que programa se haya invocado mediante una sentencia transfer con el formato transferir a programa, caso en que la variable contendrá inicialmente el ID de transacción que haya iniciado el programa que realiza la transferencia.

    Si el programa basado en CICS se ejecuta en una aplicación Web, la variable contiene el ID de transacción para el programa de captura DFHMIRS

En todas las demás plataformas, la variable no se utiliza; pero si el programa se ha invocado mediante una sentencia transfer con el formato transferir a programa, la variable contiene el nombre del programa que realiza la transferencia.

sysVar.transferName Permite especificar, durante la ejecución, el nombre del programa o transacción al que desea realizar la transferencia.
sysVar.userID Contiene un identificador de usuario en entornos en los que hay uno disponible.
VGVar.currentFormattedGregorianDate Contiene la fecha del sistema actual en formato gregoriano largo.
VGVar.currentFormattedJulianDate Contiene la fecha del sistema actual en formato juliano largo.
VGVar.currentFormattedTime Recupera la hora del sistema actual en formato HH:mm:mm.
VGVar.currentGregorianDate Contiene la fecha del sistema actual en formato gregoriano de ocho dígitos (aaaaMMdd).
VGVar.currentJulianDate Contiene la fecha del sistema actual en formato juliano de siete dígitos (aaaaDDD). Evite utilizar esta variable que existe para soportar la migración de código de VisualAge Generator a EGL.
VGVar.currentShortGregorianDate Contiene la fecha del sistema actual en formato gregoriano de seis dígitos (aaMMdd). Evite utilizar esta variable que existe para soportar la migración de código de VisualAge Generator a EGL.
VGVar.currentShortJulianDate Contiene la fecha del sistema actual en formato juliano de cinco dígitos (aaDDD). Evite utilizar esta variable que existe para soportar la migración de código de VisualAge Generator a EGL.
VGVar.handleHardIOErrors

Puede utilizarse de cualquiera de estas formas:

  • Como origen o destino de una asignación o sentencia move (también permitido en el valor "for count" de una sentencia move)
  • Como variable de una expresión lógica utilizada en una sentencia case, if o while
  • Como argumento de una sentencia return o exit.
VGVar.handleOverflow Controla el proceso de errores después de un desbordamiento aritmético.
VGVar.handleSysLibraryErrors Especifica si el valor de la variable de sistema sysVar.errorCode se ve afectado por la invocación de una función de sistema.
VGVar.mqConditionCode Contiene el código de finalización de una llamada de API de MQSeries que sigue a una operación de E/S add o scan para un registro MQ.
VGVar.sqlerrd Matriz estática de 6 elementos, en la que cada elemento contiene el valor de área de comunicación SQL (SQLCA) correspondiente devuelto de la última opción de E/S de SQL.
VGVar.sqlerrmc Contiene las variables de sustitución para el mensaje de error asociado al código de retorno de sysVar.sqlcode.
VGVar.sqlIsolationLevel Indica el nivel de independencia entre transacciones de base de datos y solo es significativo al generar salida Java.
VGVar.sqlWarn Matriz estática de 11 elementos, en la que cada elemento contiene un byte de aviso devuelto en el área de comunicaciones SQL (SQLCA) para la última operación de E/S SQL y en la que el índice es superior en uno al número de aviso de la descripción SQLCA SQL.
VGVar.systemGregorianDateFormat Un patrón de 8 ó 10 caracteres que incluye dd (para día numérico), MM (para mes numérico) y aa o aaaa (para año numérico), con caracteres que no sean d, M, a ni dígitos utilizados como separadores.
VGVar.systemJulianDateFormat Un patrón de 6 u 8 caracteres que incluye DDD (para día numérico) y aa o aaaa (para año numérico), con caracteres que no sean D, y ni dígitos como separadores.
Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.