P Interfaz de cliente XAPI

En este capítulo, se presenta la interfaz de cliente XAPI para ACSLS.

Interfaz de cliente XAPI para un servidor ACSLS

La API de XML (XAPI) es una API que permite a los clientes y los servidores de StorageTek comunicarse usando un protocolo común mediante TCP/IP. ACSLS 8.4 y las versiones posteriores se pueden configurar con compatibilidad con la XAPI.

Los clientes que debían usar un servidor basado en MVS (HSC para cinta real o VTCS para cinta virtual) ahora pueden usar ACSLS para gestionar bibliotecas StorageTek.

Consulte el documento StorageTek Enterprise Library Software XAPI Client Interface to ACSLS Server (Interfaz de cliente XAPI para servidor ACSLS de StorageTek Enterprise Library Software) en el juego de documentación de ELS para obtener detalles sobre la configuración, la administración y los comandos de operador de XAPI y XCMD, las solicitudes de usuario de XAPI admitidas y las variables de control de XAPI de ACSLS.

Servicio de XAPI de ACSLS

Consulte la Guía de instalación de StorageTek ACSLS 8.4 para ver los procedimientos de instalación y desinstalación del servicio de XAPI de ACSLS.

Cuando está instalado, el componente de XAPI se inicia y se detiene mediante ACSLS.

  • Para iniciar ACSLS con el servicio de XAPI, ejecute lo siguiente en el símbolo del sistema de Unix:

    acsss enable

  • Para detener ACSLS y el servicio de XAPI, ejecute lo siguiente en el símbolo del sistema de Unix:

    acsss disable

  • Para detener ACSLS, el servicio de XAPI, la base de datos de ACSLS y todos los componentes de ACSLS, ejecute lo siguiente en el símbolo del sistema de Unix:

    acsss shutdown

Variables de XAPI

Use la utilidad acsss_config o dv_config de ACSLS para visualizar y configurar las variables estáticas de XAPI de ACSLS.

Debe reiniciar ACSLS para que se apliquen los cambios.

  • dv_config

    • dv_config -d para mostrar todas las variables de ACSLS.

    • dv_config -p <variable_name> para actualizar la variable de XAPI.

    Consulte Configuración de variables que controlan el comportamiento de ACSLS.

  • acsss_config

    Seleccione la opción 9 para visualizar y cambiar las variables de XAPI. Esta opción solo se muestra si se ha instalado el servidor de XAPI.

    ACSLS Feature Configuration

Enter the number followed by Return for your choice from the following menu to configure product behavior in that area.

Press ? followed by the Return key for help.

   1: Set CSI tuning variables
   2: Set event logging variables
   3: Set general product behavior variables
   4: Set access control variables
   5: Set automatic backup parameters
   6: Rebuild Access Control information
   7: Event Notification settings
   8: Define or Change Library Configuration
   9: Set XAPI server variables
   E: Exit

Menu choice:

Las variables de XAPI son:

  • XAPI_PORT

    Petición de datos: Changes to the user-defined inbound port to the XAPI server will not take effect until the XAPI server is restarted. Port number used by the XAPI server to receive incoming XAPI requests. [50020] (Los cambios en el puerto de entrada definido por el usuario hacia el servidor de la XAPI no tienen efecto hasta que se reinicie el servidor de la XAPI. Número de puerto utilizado por el servidor de la XAPI para recibir solicitudes de entrada de XAPI. [50020]):

    Esta opción especifica el puerto que usa el servidor de la XAPI para las solicitudes TCP entrantes provenientes de clientes. Introduzca un número entre 1024 y 65535 para definir el puerto que usa el servidor de la XAPI. No especifique el puerto 50003.

    Se debe reiniciar el servidor de la XAPI para que se aplique esta variable.

  • XAPI_WORK_PATH

    Petición de datos: Changes to the XAPI work directory will not take effect until the xapi server is restarted. Place the XAPI log and trace information in which directory. [$ACS_HOME/log/xapi] (Los cambios en el directorio de trabajo de la XAPI no tienen efecto hasta que se reinicie el servidor de la XAPI. Coloque la información de rastreo y de log de XAPI en el directorio. [$ACS_HOME/log/xapi]):

    Seleccione un directorio en donde se colocarán los archivos de trabajo del servidor de la XAPI. Por defecto, el servidor de la XAPI registra la información en el directorio $ACS_HOME/log/xapi. Con el uso normal, el valor de esta variable no se modifica. Se puede especificar una ruta alternativa si hay problemas de espacio de disco en el sistema de archivos que contiene $ACS_HOME. La ruta asignada debe ser una ruta absoluta (debe comenzar con / o $ACS_HOME).

    Se debe reiniciar el servidor de la XAPI para que se aplique esta variable.

  • XAPI_LOG_SIZE

    Petición de datos: Changes to the XAPI log size will not take effect until the xapi server is restarted. Maximum XAPI log size in Mbytes. [20] (Los cambios en el tamaño de log de la XAPI no se aplicarán hasta que el servidor de la XAPI se reinicie. Tamaño máximo de log de la XAPI en megabytes. [20]):

    Esta opción especifica el tamaño máximo para el log de la XAPI, expresado en megabytes (definido aquí como "1048576 bytes."). Introduzca un número no negativo. El valor por defecto de esta opción es 20.

    Se debe reiniciar el servidor de la XAPI para que se aplique esta variable.

  • XAPI_LOG_FILE_NUM

    Petición de datos: Number of XAPI Log archive files to retain. [10] (Cantidad de archivos de almacenamiento de log de la XAPI que se deben conservar. [10]):

    Esta opción especifica el número de archivos log de la XAPI archivados que se deben conservar. Cuando el tamaño de vlog.file excede el tamaño máximo, se cambia el sufijo del nombre del archivo log de 0 a n. El archivo más reciente es el que tiene el 0, el que tiene la n es el más antiguo. Los archivos archivados se guardan en el directorio API_WORK_PATH. Cuando se alcanza el número especificado de logs archivados, el archivo más antiguo se elimina del directorio de archivo cada vez que se agrega uno nuevo a ese directorio. Puede conservar entre uno y 99 archivos archivados. Introduzca un número entre 1 y 99 para especificar la cantidad de archivos log archivados que desea conservar.

    Se debe reiniciar el servidor de la XAPI para que se aplique esta variable.

  • XAPI_TRACE_SIZE

    Petición de datos: Changes to the XAPI trace size will not take effect until the xapi server is restarted. Maximum XAPI trace size in Mbytes. [50] (Los cambios en el tamaño de rastreo de la XAPI no se aplicarán hasta que el servidor de la XAPI se reinicie. Tamaño máximo de rastreo de la XAPI en megabytes. [50]):

    Esta opción especifica el tamaño máximo para rastreo de la XAPI, expresado en megabytes (definido aquí como "1048576 bytes"). Introduzca un número no negativo. El valor por defecto de esta opción es 50.

    Se debe reiniciar el servidor de la XAPI para que se aplique esta variable.

  • XAPI_TRACE_FILE_NUM

    Petición de datos: Number of XAPI Trace archive files to retain. [10] (Cantidad de archivos de almacenamiento de rastreo de la XAPI que se deben conservar. [10]):

    Esta opción especifica el número de archivos de rastreo de la XAPI archivados que se deben conservar. Cuando el tamaño de vlog.file actual excede el tamaño máximo, se cambia el sufijo del nombre del archivo de rastreo de 0 a n. El archivo más reciente es el que tiene el 0, el que tiene la n es el más antiguo. Los archivos archivados se guardan en el directorio XAPI_WORK_PATH. Cuando se alcanza el número especificado de logs archivados, el archivo más antiguo se elimina del directorio de archivo cada vez que se agrega uno nuevo a ese directorio. Puede conservar entre uno y 99 archivos archivados. Introduzca un número entre 1 y 99 para especificar la cantidad de archivos log archivados que desea conservar.

    Se debe reiniciar el servidor de la XAPI para que se aplique esta variable.

  • XAPI_STARTUP_FILE

    Petición de datos: Changes to the XAPI startup file name will not take effect until the xapi server is restarted. Name of the XAPI startup file with control parms. [xapi_startup_file] (Los cambios que se hagan en el nombre de archivo de inicio de la XAPI no tienen efecto hasta que se reinicie el servidor de la XAPI. Nombre del archivo de inicio de la XAPI con parámetros de control. [xapi_startup_file]):

    Esta opción especifica el nombre del archivo de inicio de la XAPI. El archivo reside en el directorio XAPI_WORK_PATH e incluye los parámetros de inicio de la XAPI.

    Se debe reiniciar el servidor de la XAPI para que se aplique esta variable.

  • XAPI_TAPEPLEX_NAME

    Petición de datos: Changes to the XAPI Tapeplex name will not take effect until the xapi server is restarted. Name of the XAPI Tapeplex [] (Los cambios en el nombre de Tapeplex de la XAPI no tienen efecto hasta que se reinicie el servidor de la XAPI. Nombre de Tapeplex de la XAPI []):

    Esta opción especifica el nombre de Tapeplex de la XAPI. Se debe reiniciar el servidor de la XAPI para que se aplique esta variable.

    Introduzca un texto que no tenga más de 8 caracteres.