sysVar.remoteSystemID

La variable de sistema sysVar.remoteSystemID contiene el nombre de sistema para la ubicación de una entidad remota: un programa, un archivo VSAM, una transacción CICS o una cola de datos temporal. Esta variable no da soporte a la definición dinámica de archivos o programas, pero da soporte a la selección dinámica a partir de un conjunto predefinido de ubicaciones. En CICS, por ejemplo, el programa o archivo debe estar definido en la tabla CICS adecuada.

La variable de sistema sysVar.remoteSystemID contiene el nombre de sistema para la ubicación de un programa remoto. Esta variable no da soporte a la definición dinámica de programas, pero da soporte a la selección dinámica a partir de un conjunto predefinido de ubicaciones.

sysVar.remoteSystemID se inicializa en blancos y debe estar establecida antes de realizar alguna llamada o función de E/S de archivo que requiera el uso de esta variable.

Si genera un programa COBOL, cualquier valor de sysVar.remoteSystemID se convierte a mayúsculas. Sin embargo, independientemente del lenguaje destino, cualquier comparación de sysVar.remoteSystemID con una serie de caracteres es sensible a las mayúsculas y minúsculas y se basa en el valor asignado a la variable. La comparación en el siguiente código se resuelve en false, por ejemplo:
  sysVar.remoteSystemID = "myWin";

  // se resuelve en false
  if (sysVar.remoteSystemID == "MYWIN")
    record1.resourceAssociation = "myCorp.txt";
  end

Puede utilizar sysVar.remoteSystemID a la mayoría de casos en los que se permita un elemento; como origen o destino de una sentencia assignment, como valor pasado a una función de sistema, como elemento de una expresión lógica o como argumento de una sentencia return.

Las características de sysVar.remoteSystemID son las siguientes:
Tipo primitivo
CHAR
Longitud de datos
8 (se rellena con espacios en blanco)
¿Se guarda el valor a lo largo de los segmentos?

Acceso de programas remotos

El valor de sysVar.remoteSystemID proporciona acceso al programa remoto sólo si el componente de opciones de enlace, elemento callLink, propiedad location está establecido en PROGRAMCONTROLLED. Para obtener información detallada sobre el significado de sysVar.remoteSystemID para programas remotos, consulte la descripción de nombre de sistema en la sección location en elemento callLink.

Acceso de archivos remotos

El valor de sysVar.remoteSystemID proporciona acceso de un archivo VSAM remoto o cola de datos transitoria sólo en el siguiente caso:
  • El código se genera para COBOL
  • El componente de opciones de enlace, elemento fileLink, propiedad locationSpec se establece en programControlled, como se indica en elemento fileLink

Para archivos remotos, el nombre de sistema es el identificador del sistema CICS.

Acceso de transacciones remotas

El valor de sysVar.remoteSystemID proporciona acceso a una transacción CICS remota solamente en el caso siguiente:
  • Utiliza la función sysLib.startTransaction para iniciar la transacción
  • El código se genera para COBOL
  • La propiedad locationSpec del componente de opciones de enlace elemento asynchLink está establecida en PROGRAMCONTROLLED, como se indica en elemento asynchLink.

Para transacciones remotas, el nombre de sistema es el identificador del sistema CICS.

Plataformas destino

Plataforma Consideraciones sobre compatibilidad
CICS para z/OS Ninguna
z/OS por lotes No soportado
Plataforma Consideraciones sobre compatibilidad
iSeries COBOL No soportado

Ejemplo

  sysVar.remoteSystemID = "myCICS";

  // siempre se resuelve en true,
  // aunque el valor se convierte a mayúsculas en COBOL
  if (sysVar.remoteSystemID == "myCICS")
    record1.resourceAssociation = "MYCORP.MYDATA";
  end
  sysVar.remoteSystemID = "myWIN";

  // se resuelve en true
  if (sysVar.remoteSystemID == "myWIN")
    record1.resourceAssociation = "myCorp.txt";
  end

Conceptos relacionados
Componente de opciones de enlace

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.