StorageTek Enterprise Library Software

Guía de instalación, configuración y administración del cliente de VM

Versión 7.3

E71063-01

Septiembre de 2015

Guía de instalación, configuración y administración del cliente de VM de StorageTek Enterprise Library Software, Versión 7.3

E71063-01

Copyright © 2015, Oracle y/o sus filiales. Todos los derechos reservados.

Este software y la documentación relacionada están sujetos a un contrato de licencia que incluye restricciones de uso y revelación, y se encuentran protegidos por la legislación sobre la propiedad intelectual. A menos que figure explícitamente en el contrato de licencia o esté permitido por la ley, no se podrá utilizar, copiar, reproducir, traducir, emitir, modificar, conceder licencias, transmitir, distribuir, exhibir, representar, publicar ni mostrar ninguna parte, de ninguna forma, por ningún medio. Queda prohibida la ingeniería inversa, desensamblaje o descompilación de este software, excepto en la medida en que sean necesarios para conseguir interoperabilidad según lo especificado por la legislación aplicable.

La información contenida en este documento puede someterse a modificaciones sin previo aviso y no se garantiza que se encuentre exenta de errores. Si detecta algún error, le agradeceremos que nos lo comunique por escrito.

Si este software o la documentación relacionada se entrega al Gobierno de EE.UU. o a cualquier entidad que adquiera las licencias en nombre del Gobierno de EE.UU. entonces aplicará la siguiente disposición:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Este software o hardware se ha desarrollado para uso general en diversas aplicaciones de gestión de la información. No se ha diseñado ni está destinado para utilizarse en aplicaciones de riesgo inherente, incluidas las aplicaciones que pueden causar daños personales. Si utiliza este software o hardware en aplicaciones de riesgo, usted será responsable de tomar todas las medidas apropiadas de prevención de fallos, copia de seguridad, redundancia o de cualquier otro tipo para garantizar la seguridad en el uso de este software o hardware. Oracle Corporation y sus filiales declinan toda responsabilidad derivada de los daños causados por el uso de este software o hardware en aplicaciones de riesgo.

Oracle y Java son marcas comerciales registradas de Oracle y/o sus filiales. Todos los demás nombres pueden ser marcas comerciales de sus respectivos propietarios.

Intel e Intel Xeon son marcas comerciales o marcas comerciales registradas de Intel Corporation. Todas las marcas comerciales de SPARC se utilizan con licencia y son marcas comerciales o marcas comerciales registradas de SPARC International, Inc. AMD, Opteron, el logotipo de AMD y el logotipo de AMD Opteron son marcas comerciales o marcas comerciales registradas de Advanced Micro Devices. UNIX es una marca comercial registrada de The Open Group.

Este software o hardware y la documentación pueden proporcionar acceso a, o información sobre contenidos, productos o servicios de terceros. Oracle Corporation o sus filiales no son responsables y por ende desconocen cualquier tipo de garantía sobre el contenido, los productos o los servicios de terceros a menos que se indique otra cosa en un acuerdo en vigor formalizado entre Ud. y Oracle. Oracle Corporation y sus filiales no serán responsables frente a cualesquiera pérdidas, costos o daños en los que se incurra como consecuencia de su acceso o su uso de contenidos, productos o servicios de terceros a menos que se indique otra cosa en un acuerdo en vigor formalizado entre Ud. y Oracle.

Contenido

Lista de Ejemplos

Lista de Figuras

Lista de Tablas

Título e Información de Copyright

Prólogo

- Público

- Accesibilidad a la documentación

- Documentos relacionados

- Convenciones

Novedades

1 Introducción

- Funciones

- Flujo de datos

- Interfaz del cliente XAPI para el servidor ACSLS

2 Preparación para instalación

- IBM VMSES/E

- Paquete de instalación del cliente de VM

- Contenido de instalación del cliente de VM

- Requisitos de software y hardware

- Requisitos de software

- Requisitos de hardware

- Requisitos de MVS

- Verificación de la interfaz del programa de aplicación

- Requisitos de ID de usuario y almacenamiento de DASD

3 Instalación del cliente de VM

- IBM VMSES/E

- Resumen de pasos de instalación

- Paso 1: Determinación de los requisitos de recursos del cliente de VM

- Creación de un archivo de sustitución PPF

- Paso 2: Asignación de recursos del cliente de VM

- Paso 3: Instalación de archivos de producto del cliente de VM

- Paso 4: Generación del código ejecutable del cliente de VM

- Paso 5: Creación de una máquina de servicio del cliente de VM

- Paso 6: Personalización de archivos de la máquina de servicio del cliente de VM

- Paso 7: Prueba del cliente de VM

- Paso 8: Colocación del cliente de VM en producción

4 Instalación de mantenimiento del cliente de VM

- IBM VMSES/E

- Resumen de los pasos de instalación

- Paso 1: Preparación para recibir mantenimiento

- Paso 2: Recepción de mantenimiento

- Paso 3: Aplicación de mantenimiento

- Paso 4: Generación de niveles nuevos

- Paso 5: Colocación del nuevo mantenimiento en producción

5 Inicio del cliente de VM

- Parámetros del módulo SMCBINT

- Par de palabra clave y valor de TRACE

- Par de palabra clave y valor de OPERATOR

- Par de palabra clave y valor de MAXRC

- Archivos de comando de cliente de VM

- SMCPARMS

- SMCCMDS

- Salidas de cliente del cliente de VM

- Soporte de DETACH del CP

6 Comandos del cliente de VM

- Ejecución comandos de administración del cliente de VM

- Comandos del cliente de VM

- AUTHorize

- Sintaxis de

- Parámetros

- Ejemplo

- CMS

- Sintaxis de

- Parámetros

- Ejemplo

- COMMtest

- Sintaxis de

- Parámetros

- Ejemplo

- CP

- Sintaxis de

- Parámetros

- Ejemplo

- DISMount

- Sintaxis de

- Parámetros

- Ejemplo

- Display DRive

- Sintaxis de

- Parámetros

- Ejemplo

- Display RC

- Sintaxis de

- Parámetros

- Ejemplo

- Display Volume

- Sintaxis de

- Parámetros

- Ejemplo

- DRIVemap

- Sintaxis de

- Parámetros

- Ejemplo

- DUMP

- Sintaxis de

- Parámetros

- Ejemplo

- DUMPOpts

- Sintaxis de

- Parámetros

- Ejemplo

- EXIT

- Sintaxis de

- Parámetros

- Help

- Sintaxis de

- Parámetros

- Ejemplo

- LIst

- Sintaxis de

- Parámetros

- LOGdisk

- Sintaxis de

- Parámetros

- Ejemplo

- MOunt

- Sintaxis de

- Parámetros

- Ejemplo

- MSGDef

- Sintaxis de

- Parámetros

- Ejemplo

- OPERator

- Sintaxis de

- Parámetros

- Ejemplo

- POOLmap

- Sintaxis de

- Parámetros

- Ejemplo

- READ

- Sintaxis de

- Parámetros

- Ejemplo

- RESYNChronize

- Sintaxis de

- Parámetros

- Ejemplo

- Route

- Sintaxis de

- Parámetros

- Ejemplo

- SERVer

- Sintaxis de

- Parámetros

- Parámetros de ruta de servidor

- Ejemplo

- TAPEPlex

- Sintaxis de

- Parámetros

- Ejemplo

- TCPip

- Sintaxis de

- Parámetros

- tcpip parms

- Ejemplo

- TRace

- Sintaxis de

- Parámetros

- Ejemplo

7 Consideraciones del servidor ELS

- Componente de servidor HTTP del SMC

- Subagrupaciones reutilizables

- Clases de gestión de VTCS

- Salida de asignación de VM:Tape

8 Mensajes

- Descripciones de mensajes

9 Interfaz de gestión de cintas del cliente de VM

- Responsabilidades de TMS

- Interfaz de usuario

- Asignación de recursos de cintas

- Interfaz del operador

- Puntos de decisión del TMS

- Inicialización del TMS

- Asignación de unidades

- Asignación de volúmenes reutilizables

- Movimiento de volúmenes

- Cómo regresar un volumen al estado reutilizable

- Información de TapePlex devuelta al TMS

- Información de configuración

- Estado de volumen

- Ubicación de volumen

- Unidades elegibles

- Estado de movimiento y códigos de error

- Estado de LSM y ACS

- Consideraciones del vehículo de comunicaciones entre usuarios (IUCV)

- Consideraciones adicionales

- Interacción entre el TMS y el cliente de VM

- Conexión inicial del TMS al cliente de VM

- Cuadro de diálogo de conexión inicial

- Asignación de unidades

- Interacción de asignación

- Cuadro de diálogo de asignación

- Terminación de interfaz de asignación

- Procesamiento de mensajes de operación

- Interacción de mensajes del operador

- Cuadro de diálogo de mensajes del operador

- Terminación de la interfaz de mensajes del operador

- Desmontaje detectado por PROP

- Escenario A: desmontaje normal

- Escenario B: desmontaje procesado automáticamente

- Macro de ACSRQ

- Solicitudes de ACSRQ

- Sintaxis de la macro de ACSRQ

- DISMOUNT

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- EJECT

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- MOUNT

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- MOVE

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- QCAP

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- QCONFIG

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- QDRIVES

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- QDRLIST

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- QSCRATCH

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- QVOLUME

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- QVOLUSE

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- SCRATCH

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- SELSCR

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- UNSCRATCH

- Consideraciones

- Sintaxis de

- Parámetros

- Respuesta de solicitud

- Áreas de datos de interfaz

- Macro de SLX

- Asignación de la macro de SLX

- Referencia cruzada

- Solicitud de DSECT ACSINT

- Referencia cruzada

- Formato de registro de IUB

- IUB: bloque de solicitud de IUCV

- Referencia cruzada

A Valores de MEDia, RECtech y MODel

- Tipo de medio (MEDia)

- Técnica de registro (RECtech)

- Tipo de modelo (MODel)

B Diagnóstico

Índice

Lista de Ejemplos

- 9-1 Cuadro de diálogo de conexión inicial

- 9-2 Escenario A de desmontaje detectado por PROP: desmontaje normal

- 9-3 Escenario B de desmontaje detectado por PROP: desmontaje procesado automático

- 9-4 Formato de registro de SLX

- 9-5 Formato de registro de ACSINT

Lista de Figuras

- 1-1 Flujo de datos del cliente de VM

- 6-1 Sintaxis del comando AUTHorize

- 6-2 Sintaxis del comando del CMS

- 6-3 Sintaxis del comando COMMtest

- 6-4 Sintaxis del comando CP

- 6-5 Sintaxis del comando DISMount

- 6-6 Sintaxis del comando Display DRive

- 6-7 Sintaxis del comando Display RC

- 6-8 Sintaxis del comando Display Volume

- 6-9 Sintaxis del comando DRIVemap

- 6-10 Sintaxis del comando DUMP

- 6-11 Sintaxis del comando DUMPOpts

- 6-12 Sintaxis del comando EXIT

- 6-13 Sintaxis del comando Help

- 6-14 Sintaxis del comando LIst

- 6-15 Sintaxis del comando LOGdisk

- 6-16 Sintaxis del comando MOunt

- 6-17 Sintaxis del comando MSGDef

- 6-18 Sintaxis del comando OPERator

- 6-19 Comando del operador POOLmap

- 6-20 Sintaxis del comando READ

- 6-21 Sintaxis del comando RESYNChronize

- 6-22 Sintaxis del comando Route

- 6-23 Sintaxis del comando SERVer

- 6-24 Sintaxis del comando TAPEPlex

- 6-25 Sintaxis del comando TCPip

- 6-26 Sintaxis del comando TRace

- 9-1 Sintaxis de la macro de ACSRQ

- 9-2 Sintaxis de la solicitud de ACSRQ DISMOUNT

- 9-3 Sintaxis de la solicitud de ACSRQ EJECT

- 9-4 Sintaxis de la solicitud de ACSRQ MOUNT

- 9-5 Sintaxis de la solicitud de ACSRQ MOVE

- 9-6 Sintaxis de la solicitud de ACSRQ QCAP

- 9-7 Sintaxis de la solicitud de ACSRQ QCONFIG

- 9-8 Sintaxis de la solicitud de ACSRQ QDRIVES

- 9-9 Sintaxis de la solicitud de ACSRQ QDRLIST

- 9-10 Sintaxis de la solicitud de ACSRQ QSCRATCH

- 9-11 Sintaxis de la solicitud de ACSRQ QVOLUME

- 9-12 Sintaxis de la solicitud de ACSRQ QVOLUSE

- 9-13 Sintaxis de la solicitud de ACSRQ SCRATCH

- 9-14 Sintaxis de la solicitud de ACSRQ SELSCR

- 9-15 Sintaxis de la solicitud de ACSRQ UNSCRATCH

Lista de Tablas

- 2-1 Contenido de medios de instalación del cliente de VM

- 2-2 Distribución del minidisco VSMC730A

- 3-1 Archivos de la máquina de servicio del cliente de VM

- 9-1 Macro de SLS: matriz de parámetros

- 9-2 Referencia cruzada de la macro de SLX

- 9-3 Referencia cruzada de la macro de ACSINT

- 9-4 Referencia del bloque de solicitud del IUB

- 9-5 Referencia cruzada del IUB

- A-1 Tipos de medios

- A-2 Valores de tipos medios por defecto

- A-3 Técnicas de registro

- A-4 Valores por defecto de la técnica de registro

- A-5 Tipos de modelos

Prólogo

En esta publicación, se describe cómo instalar, configurar y gestionar el software StorageTek VM Client de Oracle.

Público

Este documento está destinado a administradores de almacenamiento, programadores de sistemas y operadores responsables del mantenimiento del cliente de VM.

Accesibilidad a la documentación

Para obtener información sobre el compromiso de Oracle con la accesibilidad, visite el sitio web del Programa de Accesibilidad de Oracle en http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Acceso a My Oracle Support

Los clientes de Oracle que hayan contratado servicios de soporte electrónico pueden acceder a ellos mediante My Oracle Support. Para obtener información, visite http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info o, si tiene alguna discapacidad auditiva, visite http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs.

Documentos relacionados

Visite Oracle Technical Network (OTN) en el siguiente URL para acceder a la documentación relacionada con las bibliotecas, las unidades de cinta, y el software y hardware relacionado de StorageTek:

http://docs.oracle.com

Convenciones

En este documento, se utilizan las siguientes convenciones de texto:

Convenciones tipográficas

Las convenciones tipográficas incluyen las siguientes opciones:

Convención

Significado

negrita

El tipo de fuente en negrita indica elementos de la interfaz gráfica de usuario asociados a una acción o términos definidos en el texto o el glosario.

cursiva

El formato de cursiva indica títulos de libros, énfasis o variables de pendientes de asignación para los que se proporcionan valores concretos.

monospace

El tipo de fuente monoespaciada indica comandos dentro de un párrafo, direcciones URL, código en ejemplos, texto que aparece en la pantalla o texto que el usuario escribe.

Convenciones de sintaxis

Las convenciones de diagrama de flujo de sintaxis incluyen las siguientes opciones:

Líneas de flujo

Los diagramas de sintaxis están compuestos por una línea de base horizontal, líneas de ramificación horizontales y verticales, y el texto correspondiente a un comando, sentencia de control, macro o utilidad. Los diagramas se leen de izquierda a derecha, y de arriba hacia abajo. Las flechas indican flujo y dirección. Por ejemplo:

Elección única obligatoria

Las líneas de ramificación (sin flechas de repetición) indican que se debe elegir una opción. Si uno de los elementos entre los cuales se puede elegir se encuentra en la línea de base del diagrama, se debe seleccionar un elemento. Por ejemplo:

Elección única opcional

Si el primer elemento se encuentra debajo de la línea de base, se puede seleccionar un elemento de manera opcional. Por ejemplo:

Valores por defecto

Los parámetros y valores por defecto aparecen por encima de la línea de base. Por ejemplo:

Algunos parámetros de palabras claves permiten elegir valores de una pila. Cuando la pila contiene un valor por defecto, la palabra clave y las opciones de valores aparecen debajo de la línea de base para indicar que son opcionales y el valor por defecto aparece por encima de la línea de la palabra clave. Por ejemplo:

Repetición

Un símbolo de repetición indica que se puede seleccionar más de una opción o que se puede seleccionar una única opción más de una vez. El siguiente ejemplo indica que se debe utilizar una coma como delimitador de repetición. Por ejemplo:

Palabras clave

Todas las palabras clave de comandos se muestran en mayúsculas o en una combinación de mayúsculas y minúsculas. Cuando los comandos no distinguen entre mayúsculas y minúsculas, una combinación de ambas letras implica que las minúsculas pueden omitirse para formar una abreviación.

Variables

El formato de cursiva indica una variable.

Valores alternativos

La barra vertical ( | ) separa valores de parámetros alternativos.

Opcional

Los corchetes [ ] indican que un parámetro de comando es opcional.

Delimitadores

Si una coma (,), un punto y coma (;) u otro delimitador se muestra con un elemento del diagrama de sintaxis, se debe escribir como parte de la sentencia.

Rangos

Un par de elementos con la misma longitud y el mismo tipo de datos, unidos por un guión, indica un rango inclusivo. El primer elemento debe ser estrictamente menor que el segundo elemento.

Un rango hexadecimal consta de un par de números hexadecimales (por ejemplo, 0A2-0AD o 000-0FC).

Un rango decimal consta de un par de números decimales (por ejemplo, 1-9 o 010-094). No son necesarios los ceros iniciales. La parte decimal es un rango incremental. Las posiciones de los caracteres correspondientes a la parte incremental de ambos elementos del rango deben coincidir y los caracteres no incrementales del primer elemento deben ser idénticos a los del segundo elemento.

Un rango VOLSER (rango de volumen) numérico consta de un par de elementos de VOLSER que contienen una parte numérica decimal de 1 a 6 dígitos (por ejemplo, ABC012-ABC025 o X123CB-X277CB). La parte decimal es un rango incremental. Se aplican las siguientes restricciones adicionales:

- Las posiciones de los caracteres correspondientes a la parte incremental de ambos elementos del rango deben coincidir.

- Los caracteres no incrementales del primer elemento deben ser idénticos a los del segundo elemento.

- No puede incrementar dos partes de un elemento del rango. Si 111AAA es el primer elemento, no puede especificar 112AAB para el segundo elemento.

- Si un rango VOLSER contiene más de una parte decimal, cualquier parte es válida como rango incremental. Por ejemplo:

- A00B00: el mayor rango que puede especificarse es de A00B00 a A99B99.

- A0B0CC: el mayor rango que puede especificarse es de A0B0CC a A9B9CC.

- 000XXX: el mayor rango que puede especificarse es de 000XXX a 999XXX.

Un rango VOLSER (rango de volumen) alfabético consta de un par de elementos de VOLSER que contienen una parte incremental de 1 a 6 caracteres (por ejemplo, 000AAA-000ZZZ o 9AAA55-9ZZZ55). Esta parte es un rango incremental. Se aplican las siguientes restricciones adicionales:

- Las posiciones de los caracteres correspondientes a la parte incremental de ambos elementos del rango deben coincidir.

- Los caracteres no incrementales del primer elemento deben ser idénticos a los del segundo elemento.

- No puede incrementar dos partes de un elemento del rango. Si 111AAA es el primer elemento, no puede especificar 112AAB para el segundo elemento.

- La parte alfabética del rango VOLSER se puede definir desde el carácter A al carácter Z. Para incrementar secuencias de varios caracteres, cada carácter se puede incrementar hasta Z. Por ejemplo, ACZ es parte del rango AAA-AMM. Los ejemplos son:

- A00A0-A99A0
Incrementa los VOLSER de A00A0 a A09A0 y, a continuación, de A10A0 a A99A0.

- 9AA9A-9ZZ9A
Incrementa los VOLSER de 9AA9A a 9AZ9A y, a continuación, de 9BA9A a 9ZZ9A.

- 111AAA-111ZZZ
Incrementa los VOLSER de 111AAA a 111AAZ y, a continuación, de 111ABA a 111ZZZ.

- 999AM8-999CM8
Incrementa los VOLSER de 999AM8 a 999AZ8 y, a continuación, de 999BA8 a 999CM8.

- A3BZZ9-A3CDE9
Incrementa los VOLSER de A3BZZ9 a A3CAA9 y, a continuación, de A3CAB9 a A3CDE9.

- AAAAAA-AAACCC
Incrementa los VOLSER de AAAAAA a AAAAAZ y, a continuación, de AAAABA a AAACCC.

- CCCNNN-DDDNNN
Incrementa los VOLSER de CCCNNN a CCCNNZ y, a continuación, de CCCNOA a DDDNNN. Se trata de un rango muy amplio.

El número de volúmenes de un rango de VOLSER alfabético depende del número de elementos en la parte incremental del rango de VOLSER. Para un rango de A a Z en cada carácter de posición, el número de volúmenes se puede calcular elevando 26 a la potencia del número de posiciones que se incrementan.

- A-Z es equivalente a 26^1 o 26 volúmenes.

- AA-ZZ es equivalente a 26^2 o 676 volúmenes.

- AAA-ZZZ es equivalente a 26^3 o 17.576 volúmenes.

- AAAA-ZZZZ es equivalente a 26^4 o 456.976 volúmenes.

- AAAAA-ZZZZZ es equivalente a 26^5 o 11.881.376 volúmenes.

- AAAAAA-ZZZZZ es equivalente a 26^6 o 308.915.776 volúmenes.

Listas

Una lista está compuesta por uno o varios elementos. Si hay más de un elemento especificado, los elementos deben estar separados por una coma o un espacio en blanco, y toda la lista debe estar delimitada por paréntesis.

Espacios en blanco

Los valores y parámetros de las palabras clave pueden estar separados por cualquier número de espacios en blanco.

Convenciones de instrucción de control

Se utilizan las siguientes convenciones de sintaxis estándar para instrucciones de control:

- La única área de información de sentencia de control se encuentra de la columna 1 a la columna 72. Se ignoran las columnas de 73 a 80.

- Los parámetros pueden estar separados por uno o varios espacios en blanco o por una coma.

- Los valores se asocian con los parámetros mediante un signo igual (=) o encerrando el valor entre paréntesis y concatenándolo inmediatamente después del parámetro.

- Se ignoran las mayúsculas o minúsculas en las sentencias de control reales.

- Se admiten continuaciones mediante la inclusión de un signo (+) al final de la línea que debe continuar. Una sentencia de control termina si la sentencia no continúa.

- Use /* y */ para encerrar comentarios en la secuencia de procesos. Los miembros de HSC PARMLIB y los juegos de datos de definición deben especificar los comentarios en este formato.

- No se necesita un comentario como primera sentencia de control de un miembro de PARMLIB.

- Se pueden continuar los comentarios en varias líneas pero no se pueden anidar.

- La longitud máxima de las instrucciones de control es de 1024 caracteres.

Novedades

En esta revisión, se incluyen las siguientes actualizaciones:

- El cliente de VM ahora admite la interfaz del cliente XAPI en un servidor ACSLS (versión 8.4 o posterior) con el servicio XAPI activado.
Consulte Interfaz del cliente XAPI para el servidor ACSLS para obtener más información. Además, consulte la publicación de ELS XAPI Client Interface to ACSLS Server Reference (Referencia de interfaz de cliente XAPI para el servidor ACSLS).

- Se actualizó la descripción del comando Route para destacar la compatibilidad con la interfaz del cliente XAPI en un servidor ACSLS.
Consulte Route para obtener más información.

1 Introducción

En este capítulo, se describen las funciones de software y el flujo de datos del cliente de VM.

Funciones

El cliente de VM permite la ejecución de un cliente en un sistema de VM para solicitar servicios de cinta virtual desde un servidor TapePlex de StorageTek que se ejecuta en el MVS.

Consulte la publicación Presentación de ELS para obtener información acerca del software de MVS que permite gestionar el servidor TapePlex.

El software del cliente de VM proporciona las siguientes funciones:

- Interfaz de IUCV para aceptar solicitudes de la interfaz de gestión de cintas de VM (VMTMI)
StorageTek VM Client de Oracle sustituye a VM/HSC como el componente que proporciona una interfaz para permitir que los sistemas de gestión de cintas de VM (TMS) usen el sistema de cartuchos automáticos de StorageTek (ACS). Además, el cliente de VM proporciona una interfaz para permitir a los sistemas de gestión de cintas de VM usar StorageTek Virtual Storage Manager (VSM).

El cliente de VM actúa como destino para las solicitudes de VMTMI que se originan desde el TMS de VM. Todas las respuestas se devuelven al TMS en el formato VMTMI. El cliente de VM usa el vehículo de comunicaciones entre usuarios (IUCV) para comunicarse con las máquinas de servicio del cliente de TMS.

No todas las solicitudes de VMTMI son admitidas por el cliente de VM. Consulte el Capítulo 9, Interfaz de gestión de cintas del cliente de VM para obtener una lista completa de las solicitudes de VMTMI admitidas.

- Interfaz de TCP/IP para MVS basado en TapePlex (HSC)
StorageTek Enterprise Library Software (ELS) proporciona una interfaz XML (XAPI) para controlar los sistemas StorageTek ACS y VTCS. Las comunicaciones de XAPI se producen mediante TCP/IP. El cliente de VM convierte las solicitudes de VMTMI al nuevo formato XAPI. Las respuestas de XAPI se convierten a las respuestas de VMTMI.

Nota:
El cliente de VM solamente se puede comunicar con ELS 7.1 o posterior (SMC/HSC/VTCS).

- Comandos del operador para controlar el cliente de VM
Consulte el Capítulo 6, Comandos del cliente de VM para obtener información acerca de los comandos del cliente de VM.

Flujo de datos

Figura 1-1 ilustra el siguiente flujo de datos del cliente de VM:

1. Se envía una solicitud del sistema de gestión de cintas de VM (TMS) al cliente de VM mediante la interfaz de gestión de cintas (VMTMI).

2. El cliente de VM convierte la solicitud de VMTMI al formato XAPI y enruta la solicitud al servidor del MVS mediante comunicaciones TCP/IP.

3. El software SMC/HSC/VTCS del servidor del MVS procesa la solicitud y devuelve todas las respuestas al cliente de VM en el formato XAPI.

4. El cliente de VM convierte las respuestas XAPI al formato VMTMI y enruta estas respuestas al TMS.

Figura 1-1 Flujo de datos del cliente de VM

Interfaz del cliente XAPI para el servidor ACSLS

La API de XML (XAPI) es una API de Oracle StorageTek que permite a los clientes y los servidores de StorageTek comunicarse con un protocolo común mediante TCP/IP.

Con la presentación de esta XAPI, los clientes que anteriormente requerían el uso de un servidor basado en MVS (componente de software de host de Oracle StorageTek) para procesamiento real de cintas ahora pueden usar ACSLS 8.4 o posterior (con compatibilidad con XAPI activada) de la siguiente manera:

- Un cliente SMC del MVS ahora puede realizar solicitudes de cinta real desde un servidor ACSLS con compatibilidad con XAPI activada (sin necesidad de MVS/CSC).

- El cliente de VM ahora puede solicitar servicios de cinta real desde un servidor ACSLS con compatibilidad con XAPI activada.

Si está usando el cliente de VM para conectarse a un servidor ACSLS con compatibilidad con XAPI activada, deberá usar los comandos TAPEPlex y SERVer del cliente de VM para definir la aplicación de ACSLS en un TapePlex y definir la ruta de control de TCP/IP entre el cliente y el servidor.

- Consulte TAPEPlex para obtener más información sobre el comando TapePlex.

- Consulte SERVer para obtener más información sobre el comando SERVer.

La mayoría de las interacciones de cliente/servidor entre el cliente de VM y el servidor ACSLS con XAPI son transparentes para el usuario final. El cliente de VM genera las solicitudes de información de volumen, montajes y desmontajes automáticamente y se procesan sin intervención del usuario. Además de estas interacciones automáticas, el servidor ACSLS con XAPI proporciona comandos adicionales de administrador, configuración y operador que permiten gestionar el componente XAPI. Consulte la publicación de ELS XAPI Client Interface to ACSLS Server Reference (Referencia de interfaz de cliente XAPI para el servidor ACSLS) para obtener información acerca de estos comandos.

2 Preparación para instalación

En este capítulo, se describe el paquete de instalación del cliente de VM y los requisitos previos a la instalación. Se incluyen los siguientes temas:

IBM VMSES/E

El cliente de VM se instala mediante VMSES/E (Virtual Machine Serviceability Enhancements Staged/Enhanced) de IBM, que se incluye como parte de VM/ESA de IBM.

Consulte la publicación de IBM VMSES/E Introduction and Reference (Introducción y referencia de VMSES/E) para obtener más información acerca de la operación de VMSES/E.

Paquete de instalación del cliente de VM

El paquete de instalación del cliente de VM incluye un archivo ZIP o CD-ROM (sobre de SERVLINK) que contiene el software del cliente de VM.

Como parte de la instalación, debe obtener e instalar el mantenimiento acumulativo más reciente del cliente de VM (PTF y HOLDDATA).

Nota:
Es posible que PTF y HOLDDATA no existan en la versión de lanzamiento de ELS pero aparecerán con el tiempo. Además, hay versiones mensuales en My Oracle Support.

Descargue el mantenimiento acumulativo desde el sitio de My Oracle Support (MOS):

http://www.myoraclesupport.com

Visite este sitio con frecuencia para obtener actualizaciones de HOLDDATA y PTF e instalar actualizaciones de mantenimiento acumulativo de manera periódica. Las versiones de PTF de MOS son mensuales.

Consulte el Capítulo 4, Instalación de mantenimiento del cliente de VM para obtener más información sobre la instalación de mantenimiento acumulativo de ELS.

Contenido de instalación del cliente de VM

Tabla 2-1 muestra los archivos o los grupos SERVLINK incluidos en el archivo ZIP o en el CD-ROM de instalación del cliente de VM:

Tabla 2-1 Contenido de medios de instalación del cliente de VM

Grupo SERVLINK del CD-ROM

Descripción

1

Cabecera

2

Cabecera

3

VSMC730A (archivo de identificador del producto)

4

VSMC730A MEMO (nota para los usuarios)

5

Listas de aplicación de servicio (AXLIST)

6

PARTLIST

7

Servicio (DELTA)

8

Servicio (APPLY)

9

Código base (BASE)

10

Archivos de ayuda (HELP)

Requisitos de software y hardware

Los requisitos de software y hardware del cliente de VM son los siguientes:

Requisitos de software

Sistema operativo: cualquier versión de z/VM de IBM admitida por IBM

Productos de proveedores de software independiente (opcional):

- ACF/VTAM

- CA-DYNAM/TLMS para z/VM

- DFSORT

- EPIC VSE

- Gestor de varias imágenes (MIM)

- SYNCSORT

- VM:Tape (consulte Verificación de la interfaz del programa de aplicación abajo)

- Gestor de cintas de IBM para z/VM

Requisitos de hardware

El cliente de VM requiere un procesador de IBM o un procesador compatible capaz de ejecutar z/VM de IBM (cualquier versión admitida por IBM).

Requisitos de MVS

El cliente de VM se comunica con un servidor TapePlex de StorageTek que se ejecuta en MVS. Este servidor es gestionado por el software StorageTek ELS de Oracle, incluidos SMC, HSC y, de manera opcional, VTCS.

El cliente de VM requiere que todo el software ELS tenga la versión 7.1 o una versión posterior.

Consulte la publicación Instalación de ELS para obtener información sobre los requisitos de hardware y software de ELS.

Verificación de la interfaz del programa de aplicación

Si usa VM:Tape como sistema de gestión de cintas, asegúrese de que esté instalada la versión 1.8 de VM:Tape o una versión posterior.

Además, deberá usar el comando AUTHorize del cliente de VM para agregar VM:Tape a la lista de operadores autorizados del cliente de VM. Consulte AUTHorize.

Si se encuentran instalados otros sistemas de gestión de cintas, es posible que deba escribir rutinas especiales para comunicación con el cliente de VM. Consulte el Capítulo 9, Interfaz de gestión de cintas del cliente de VM para obtener información sobre la interfaz de los sistemas de gestión de cintas, incluidos la asignación recomendada y el procesamiento de mensajes, comandos y respuestas, áreas de datos e interrupción requerida de manipulación para comunicación con TapePlex.

Requisitos de ID de usuario y almacenamiento de DASD

El cliente de VM requiere que agregue el ID de usuario de instalación del cliente de VM y el ID de usuario de la máquina de servicio del cliente de VM al directorio de VM. Los requisitos de estos ID de usuario se definen en mayor detalle durante el proceso de instalación del cliente de VM.

El ID de instalación por defecto del cliente de VM es VSMC730A. Se recomienda usar este ID de usuario por defecto para instalar y mantener el cliente de VM.

Si elige cambiar el nombre del ID de usuario de instalación del cliente de VM, deberá crear una sustitución del parámetro de producto (PPF). Consulte Creación de un archivo de sustitución PPF para obtener más información.

Tabla 2-2 describe la distribución del minidisco VSMC730A:

Tabla 2-2 Distribución del minidisco VSMC730A

Propietario (ID de usuario)

Dirección por defecto

Tamaño (3390 Cyl)

Nombre y descripción de disco

VSMC30A

2B2

20

BASE

Contiene todos los códigos de base del cliente de VM.

VSMC30A

2C2

5

LOCALSAM

Contiene los archivos de personalización.

VSMC30A

2D2

20

DELTA

Contiene los archivos de servicios.

VSMC30A

2A6

10

APPLY TEST

Contiene los archivos AUX y tablas de inventario de software que representan el nivel de servicio de prueba del cliente de VM.

VSMC30A

2A2

10

APPLY PRODUCTION

Contiene los archivos AUX y tablas de inventario de software que representan el nivel de servicio de producción del cliente de VM.

VSMC30A

29D

10

BUILD4

Contiene los archivos de ayuda.

VSMC30A

201

20

BUILD1

Disco de generación de pruebas para el cliente de VM. Contiene las bibliotecas y los módulos de carga.

VSMC30A

202

20

BUILD2

Disco de generación de producción para el cliente de VM. Contiene las bibliotecas y los módulos de carga.

VSMC30A

191

10

INST191

Minidisco 191 de ID de usuario de instalación.

VSMC30A

191

10

VMSMC191

Minidisco 191 de máquina de servicio del cliente de VM.

VSMC30A

200

20

VMSMCRUN

Disco de ejecución de máquina de servicio del cliente de VM.

3 Instalación del cliente de VM

En este capítulo, se describe cómo instalar el software del cliente de VM.

Antes de comenzar la instalación, verifique los requisitos de ELS y revise las consideraciones previas a la instalación que se describen en el Capítulo 2, Preparación para instalación.

Una vez que se haya instalado el cliente de VM, deberá obtener e instalar el mantenimiento acumulativo del cliente de VM. Consulte el Capítulo 4, Instalación de mantenimiento del cliente de VM para obtener más información.

IBM VMSES/E

El cliente de VM se instala mediante VMSES/E (Virtual Machine Serviceability Enhancements Staged/Enhanced) de IBM, un componente VM/ESA de IBM.

VMSES/E incluye el ID de instalación de VMFINS, ideado para que la instalación de los productos sea coherente.

Consulte la publicación de IBM VMSES/E Introduction and Reference (Introducción y referencia de VMSES/E) para obtener más información acerca de la operación de VMSES/E.

Resumen de pasos de instalación

A continuación, se presenta un resumen de los pasos de instalación. Cada paso se describe de forma detallada en las siguientes secciones.

1. Determine los requisitos de recursos del cliente de VM.
Use el comando VMFINS para cargar varios archivos VMSES/E desde el archivo SRVLINK del producto para obtener los requisitos de recursos del cliente de VM.

2. Asigne los recursos del cliente de VM.
Use la información obtenido del paso anterior para asignar los minidiscos adecuados y los ID de usuario necesarios para instalar y usar el cliente de VM.

3. Instale los archivos del producto del cliente de VM.
Use el comando VMFINS para cargar los archivos de producto del cliente de VM desde el archivo SRVLINK del producto al minidisco BASE.

4. Genere el código ejecutable del cliente de VM.
Use el comando VMFINS para generar el minidisco BUILD de prueba del cliente de VM.

5. Cree la máquina de servicio del cliente de VM.
Cree una entrada de directorio para la máquina de servicio del cliente de VM.

6. Personalice los archivos de la máquina de servicio del cliente de VM.
Edite las muestras de la máquina de servicio del cliente de VM.

7. Pruebe el cliente de VM.
Pruebe el cliente de VM en el disco generación de pruebas.

8. Coloque el cliente de VM en producción.
Después de probar el cliente de VM, copie los archivos del cliente de VM del disco de generación de pruebas en el disco de versión de producción.

Paso 1: Determinación de los requisitos de recursos del cliente de VM

Use el comando VMFINS para determinar los requisitos de recursos del cliente de VM.

1. Inicie sesión como instalador/planificador.
Use cualquier ID de usuario con acceso de lectura a MAINT 5E5 y acceso de escritura al disco 51D que contendrá el inventario de software del cliente de VM.

2. Introduzca los siguientes comandos para establecer el acceso de lectura al código de VMSES/E.

LINK MAINT 5E5 5E5 RR
ACCESS 5E5 B

3. Introduzca los siguientes comandos para establecer el acceso de lectura el disco de inventario de software, MAINT 51D, en este ejemplo.

LINK MAINT 51D 51D M
ACCESS 51D D

Tenga en cuenta lo siguiente:

- El disco de inventario de software puede ser el disco de inventario de software del sistema. Se recomienda asignar un disco 51D al ID de usuario de mantenimiento/instalación (VSMC730A).

- Si otro usuario está enlazado actualmente al disco de inventario de software en modo de escritura (R/W), el comando LINK fallará. Si esto ocurre, dirija al otro usuario para volver a enlazar el disco de inventario de software en solo lectura (RR) y, a continuación, vuelva a ejecutar los comandos LINK y ACCESS de arriba. No continúe hasta que haya establecido un enlace de lectura/escritura al disco de inventario de software (51D).

4. Cargue los archivos de control del producto del cliente de VM en el minidisco 51D.
Introduzca los siguientes datos:

VMFINS INSTALL INFO ( NOMEMO ENV VSMC730A

El comando INSTALL INFO carga varios archivos de control del producto y crea el archivo VMFINS PRODLIST.

5. Obtenga información de planificación de recursos para VMCLIENT.
Introduzca los siguientes datos:

VMFINS INSTALL PPF VSMC730A VMCLIENT ( NOMEMO PLAN ENV
VSMC730A

El archivo, VMFINS PLANINFO, se crea en el disco A. Este archivo contiene información acerca de los ID de usuario y los minidiscos requeridos para instalar el cliente de VM.

6. Revise el archivo log de mensajes de instalación, $VMFINS $MSGLOG. Todos los mensajes de instalación se escriben en el disco A del usuario de instalación. Corrija los errores antes de continuar.

Creación de un archivo de sustitución PPF

Si se deben cambiar los ID de usuario de la máquina de servicio o de mantenimiento, use el siguiente procedimiento para crear un archivo de sustitución PPF

1. En la siguiente petición de datos, introduzca 1.

VMFINS2601R Do you want to create an override for :PPF VSMC730A
VMCLIENT :PRODID VSMC730A%VMCLIENT?

Enter 0 (No), 1 (Yes) or 2 (Exit)

2. En la siguiente petición de datos, introduzca 0.

VMFMKO2917R Do you want to use the defaults for this product?

Enter 0 (No), 1 (Yes) or 2 (Exit)

3. Actualice solamente el usuario INSTALL del cliente de VM, solamente el SERVER del cliente de VM o el usuario INSTALL del cliente de VM y el SERVER del cliente de VM en Make Override Panel (Panel de sustitución). Pulse F3 para salir de este panel.

4. Seleccione 2 - Save as... e introduzca el nombre de archivo del archivo de sustitución.
Los archivos de sustitución $PPF y PPF se copian en el disco D (51D).

El PPF de sustitución ahora reemplaza el archivo VSMC730A PPF. Sustituya este PPF de sustitución para todas las instancias de VSMC730A en el resto de los pasos de la instalación.

Paso 2: Asignación de recursos del cliente de VM

Use la información de planificación del archivo VSMC730A PLANINFO para crear la entrada de directorio del usuario VSMC730A.

1. Cree la entrada de directorio del usuario VSMC730A.
La entrada de directorio del usuario VSMC720A se encuentra en la parte inferior del archivo PLANINFO. Estas entradas contienen los enlaces y las clases de privilegios necesarias para el ID de usuario VSMC730A. Use la entrada de directorio que se encuentra en PLANINFO como modelo de la entrada de directorio VSMC730A.

2. Agregue las sentencias de MDISK a la entrada de directorio de VSMC720A. La distribución del minidisco se encuentra en el archivo PLANINFO.

3. Agregue la entrada de directorio VSMC730A al directorio del sistema. Cambie la contraseña de VSMC730A desde XXXXXX a una contraseña válida, según las directrices de seguridad.

4. Coloque el nuevo directorio en línea.

Paso 3: Instalación de archivos de producto del cliente de VM

Use el comando VMFINS para generar el minidisco BUILD de prueba del cliente de VM.

1. Inicie sesión en el ID de usuario de instalación VSMC730A, que creó en el Paso 2.

2. Cree un PROFILE EXEC que contenga los comandos de ACCESS para los minidiscos MAINT 5E5 y 51D.

XEDIT PROFILE EXEC A
===> input /**/
===> input 'access 5e5 b'
===> input 'access 51d d'
===> file

3. Ejecute el perfil para acceder a los minidiscos de MAINT.

PROFILE

4. Establezca acceso de escritura al disco de inventario de software, si ya no está enlazado a R/W.

LINK MAINT 51D 51D M
ACCESS 51D D

Si otro usuario está enlazado actualmente al disco de inventario de software en modo de escritura (R/W), el comando LINK fallará. Si esto ocurre, dirija a este usuario para volver a enlazar el disco de inventario de software en solo lectura (RR) y, a continuación, vuelva a ejecutar los comandos LINK y ACCESS de arriba. No continúe hasta que haya establecido un enlace de lectura/escritura al disco de inventario de software (51D).

5. Copie los archivos VMSES/E creados en el disco 191 del instalador/planificador al disco 191 VSMC730A. Esto colocará todos los archivos VMSES/E del cliente de VM en una ubicación. Los archivos para copiar son:

- VSMC730A PLANINFO

- VSMC730A PRODLIST

6. Instale el cliente de VM.
Introduzca los siguientes datos:

VMFINS INSTALL PPF VSMC730A VMCLIENT (NOMEMO NOLINK ENV
VSMC730A OVERRIDE NO

La opción NOLINK indica que VMFINS no enlazará los minidiscos de mantenimiento, solo accederá a ellos si aún no se ha accedido.

La opción OVERRIDE NO indica que VMFINS no creará un PPF de sustitución. Si se creó un PPF de sustitución arriba, sustituya VMSMC730A por el nombre del PPF creado.

7. Revise el archivo log de mensajes de instalación, $VMFINS $MSGLOG. Todos los mensajes de instalación se escriben en el disco A del usuario de instalación. Si es necesario, corrija los errores antes de continuar.

Paso 4: Generación del código ejecutable del cliente de VM

Use el comando VMFINS para generar el minidisco BUILD de prueba del cliente de VM.

1. Introduzca el siguiente comando para generar el disco BUILD de prueba.

VMFINS BUILD PPF VSMC730A VMCLIENT (ALL NOLINK

2. Revise el log de mensajes de instalación, $VMFINS $MSGLOG. Todos los log de mensajes de instalación se escriben en el disco A del usuario de instalación. Corrija los errores antes de continuar.
Los siguientes mensajes del log VMFINS BUILD son normales:

- VMFBDC2178I
Object =.HELPMSG no se puede volver a generar porque no se trabaja con él.

- VMFBDC2178I
Object =.HELPSMC no se puede volver a generar porque no se trabaja con él.

- VMFINB2173I
No se encontró ningún parámetro EXEC de verificación para este producto.

Paso 5: Creación de una máquina de servicio del cliente de VM

Cree una entrada de directorio para la máquina de servicio del cliente de VM. La máquina de servicio del cliente de VM debe poder ejecutar el comando CP MSGNOH (clase de privilegio B).

Consulte el archivo VSMC730A PLANINFO para conocer los requisitos de la máquina y el minidisco.

Paso 6: Personalización de archivos de la máquina de servicio del cliente de VM

Copie los siguientes archivos del minidisco LOCALSAM al minidisco 191 de la máquina de servicio del cliente de VM (VMSMC191):

Tabla 3-1 Archivos de la máquina de servicio del cliente de VM

Nombre de ejemplo

Nombre operativo

Uso

SMCPARMS SAMPLE

SMCPARMS (ARCHIVO)

Parámetros de Inicio

SMCCMDS SAMPLE

SMCCMDS (ARCHIVO)

Comandos de inicio

SMCSTART EXEC

SMCSTART EXEC

EXEC de inicio del cliente de VM

SMCPRO SAMPLE

PROFILE EXEC

PROFILE EXEC del cliente de VM

SMCPARMS y SMCCMDS contienen parámetros y comandos de inicio. Los nombres de archivo de estos archivos deben coincidir con los nombres de FIILDEF de SMCSTART EXEC.

Consulte Archivos de comando de cliente de VM para obtener información sobre cómo actualizar el parámetro del cliente de VM y los archivos de comando.

Paso 7: Prueba del cliente de VM

El cliente de VM está listo para prueba. El código ejecutable que se probará está en el minidisco 201 VSMC730A. Las opciones para ejecutar el cliente de VM son:

- ENLACE a VSMC730A 201 y ejecución de SMCSTART.

- Copia de VSMC730A 201 al minidisco VMSMC 200 y ejecución de SMCSTART. El PROFILE EXEC (SMCPRO SAMPLE) de muestra presupone esta opción.

Paso 8: Colocación del cliente de VM en producción

Después de probar el cliente de VM, introduzca los siguientes comandos para copiar los archivos del cliente de VM desde el disco de prueba (201) al disco de producción (202):

VMFSETUP VSMC730A VMCLIENT

VMFCOPY ** fm1==fm2 (PRODID VSMC720A%VMCLIENT SPRODID
VSMC730A%VMCLIENT OLDDATE REPLACE

fm1 es el modo del archivo del disco de generación de TEST (BUILD1 - 201)

fm2 es el modo del archivo del disco de generación de PRODUCTION (BUILD2 - 202)

La máquina de servicio del cliente de VM se deberá modificar para usar la versión PRODUCTION. Las opciones son:

- ENLACE a VSMC730A 202 y ejecución de SMCSTART.

- Copia de VSMC730A 202 al minidisco VMSMC 200 y ejecución de SMCSTART. El PROFILE EXEC (SMCPRO SAMPLE) de muestra presupone esta opción.

4 Instalación de mantenimiento del cliente de VM

Este capítulo contiene instrucciones para instalar el mantenimiento del cliente de VM.

Deberá obtener e instalar el mantenimiento acumulativo más reciente del cliente de VM (PTF y HOLDDATA). Descargue el mantenimiento acumulativo desde el sitio de My Oracle Support (MOS), en:

http://www.myoraclesupport.com

Visite este sitio con frecuencia para obtener actualizaciones de HOLDDATA y PTF e instalar actualizaciones de mantenimiento acumulativo de manera periódica. Las versiones de PTF de MOS son mensuales.

Antes de intentar instalar el mantenimiento, póngase en contacto con los servicios globales de asistencia al cliente de Oracle. Consulte Prólogo para obtener información sobre cómo ponerse en contacto con Oracle para obtener ayuda.

Nota:
Es posible que PTF y HOLDDATA no existan en la versión de lanzamiento del cliente de VM, pero aparecerán con el tiempo. Además, hay versiones mensuales en My Oracle Support.

IBM VMSES/E

El mantenimiento acumulativo del cliente de VM se instala mediante VMSES/E (Virtual Machine Serviceability Enhancements Staged/Enhanced) de IBM, un componente VM/ESA de IBM.

VMSES/E incluye el ID de instalación de VMFINS, ideado para que la instalación de los productos sea coherente.

Consulte la publicación de IBM VMSES/E Introduction and Reference (Introducción y referencia de VMSES/E) para obtener más información acerca de la operación de VMSES/E.

Resumen de los pasos de instalación

A continuación, se presenta un resumen de los pasos de instalación de mantenimiento. Cada paso se describe de forma detallada en las siguientes secciones.

1. Prepárese para recibir mantenimiento.
Use el comando VMFMRDSK para borrar el disco de aplicación alternativa antes de recibir un nuevo mantenimiento, lo que le permitirá quitar el mantenimiento si se encuentra un problema grave.

2. Reciba mantenimiento.
El comando VMFREC recibe mantenimiento y lo coloca en el disco Delta.

3. Aplique el mantenimiento.
El comando VMFAPPLY actualiza la tabla de vectores de la versión VMSES/E (VVT), que identifica el nivel de servicio de todas las piezas que se mantienen. Además, los archivos AUX se generan desde VVT para las piezas que los requieren.

4. Genere nuevos niveles.
La tarea de generación desarrolla el nivel de servicio de un objeto y coloca el objeto nuevo en un disco BUILD (201) de prueba.

5. Coloque el nuevo mantenimiento en producción.
Después de probar el mantenimiento, se coloca en producción. Para ello, se copia el nuevo servicio en el disco de producción (202).

Paso 1: Preparación para recibir mantenimiento

Realice lo siguiente:

1. Inicie sesión en el ID de servicio del cliente de VM VSMC730A.

2. Establezca acceso de escritura al disco de inventario de software, si ya no está enlazado a R/W.

LINK MAINT 51D 51D M
ACCESS 51D D

Nota:
Si otro usuario está enlazado actualmente al disco de inventario de software en modo de escritura (R/W), el comando LINK fallará. Si esto ocurre, dirija a este usuario para volver a enlazar el disco de inventario de software en solo lectura (RR) y, a continuación, vuelva a ejecutar los comandos LINK y ACCESS de arriba. No continúe hasta que haya establecido un enlace de lectura/escritura al disco de inventario de software (51D).

3. Establezca el orden de acceso correcto al minidisco.

VMFSETUP VSMC730A VMCLIENT

VSMC730A es el PPF que se envía con el producto. Si tiene su propia sustitución de PPF, deberá sustituir el nombre de PPF para VSMC730A.

4. Reciba la documentación. VMFREC con la opción INFO carga la documentación y muestra una lista de todos los productos en el paquete.
Introduzca los siguientes datos:

VMFREC INFO ( ENV filename

5. Revise el archivo log de mensajes de recepción, $VMFREC $MSGLOG para mensajes de advertencia y error.

VMFVIEW RECEIVE

6. Borre el disco APPLY alternativo para garantizar que tiene un disco limpio para el nuevo mantenimiento.

VMFMRDSK VSMC730A VMCLIENT APPLY

VSMC730A es el PPF que se envía con el producto. Si tiene su propia sustitución de PPF, deberá sustituir el nombre de PPF para VSMC730A.

7. Revise el archivo log de mensajes de fusión, $VMFMRD $MSGLOG. Si es necesario, corrija los errores antes de continuar.

VMFVIEW MRD

Paso 2: Recepción de mantenimiento

Realice lo siguiente:

1. Reciba el mantenimiento.
Introduzca los siguientes datos:

VMFREC PPF VSMC730A VMCLIENT ( ENV filename

2. Revise el archivo log de mensajes de recepción, $VMFREC $MSGLOG. Si es necesario, corrija los errores antes de continuar.

VMFVIEW RECEIVE

Paso 3: Aplicación de mantenimiento

Realice lo siguiente:

1. Aplique el nuevo mantenimiento.

VMFAPPLY PPF VSMC730A VMCLIENT

Este comando aplica el mantenimiento que acaba de recibir. La tabla de vectores de versión se actualiza con todas las piezas mantenidas y se generan todos los archivos AUX necesarios.

2. Revise el archivo log de mensajes de aplicación, $VMFAPP $MSGLOG. Si es necesario, corrija los errores antes de continuar.

Paso 4: Generación de niveles nuevos

Realice lo siguiente:

1. Genere la tabla de estado de generación con las piezas mantenidas.

VMFBLD PPF VSMC730A VMCLIENT (STATUS

2. Revise el archivo log de mensajes de generación, $VMFAPP $MSGLOG. Si es necesario, corrija los errores antes de continuar.

VMFVIEW BUILD

3. Vuelva a generar las piezas mantenidas del cliente de VM.

VMFBLD PPF VSMC730A VMCLIENT (SERVICED

4. Revise el archivo log de mensajes de generación, $VMFAPP $MSGLOG. Si es necesario, corrija los errores antes de continuar.

VMFVIEW BUILD

Paso 5: Colocación del nuevo mantenimiento en producción

Después de probar el cliente de VM, copie los archivos del cliente de VM del disco de prueba (201) en el disco de producción (202).

VMFSETUP VSMC730A VMCLIENT
VMFCOPY ** fm1==fm2(PRODID VSMC730A%VMCLIENT OLDDATE REPLACE

fm1 es el modo del archivo del disco de generación de TEST (BUILD1 - 201).

fm2 es el modo del archivo del disco de generación de PRODUCTION (BUILD2 - 202).

5 Inicio del cliente de VM

En este capítulo, se describe cómo iniciar el software del cliente de VM.

El cliente de VM se ejecuta en su propia máquina virtual del CMS, denominada máquina de servicio del cliente de VM. En el Capítulo 3, Instalación del cliente de VM, se describe la configuración de la máquina de servicio del cliente de VM y la instalación del software de la máquina de servicio del cliente de VM.

Una vez que se ha instalado la máquina de servicio del cliente de VM, se inicia el cliente de VM mediante la ejecución del comando SMCSTART distribuido. El comando SMCSTART es un EXEC que inicializa el entorno de la máquina virtual del cliente de VM y, a continuación, ejecuta el módulo SMCBINT.

El módulo SMCBINT lee los archivos de comando del cliente de VM e inicializa el entorno del cliente de VM para recibir los comandos de TMI desde otras máquinas virtuales. Consulte Archivos de comando de cliente de VM para obtener información sobre los archivos de comando del cliente de VM.

Parámetros del módulo SMCBINT

Además de los archivos de comando del cliente de VM, el módulo SMCBINT acepta parámetros de línea de comando opcionales. Los parámetros de línea de comando opcionales SMCBINT permiten configurar OPERATOR del cliente de VM y TRACE del cliente de VM antes de que se lean los archivos de comando del cliente de VM o activar el procesamiento de MAXRC del cliente de VM en el inicio.

Los parámetros de línea de comando opcionales de SMCBINT se introducen como pares de palabra clave y valor según el nombre del módulo. Por ejemplo, a continuación, se muestra un ejemplo que especifica los parámetros de SMCBINT:

SMCBINT TRACE ON OPERATOR VMOPER MAXRC 4

Los errores encontrados durante el procesamiento de la línea de comandos causarán la terminación del proceso de inicialización del cliente de VM.

Las secciones siguientes describen cada uno de los pares de palabra clave y valor en detalle.

Par de palabra clave y valor de TRACE

TRACE{ON|OFF}

Especifica si el procesamiento de rastreo del cliente de VM se activará antes del procesamiento del archivo de comando del cliente de VM. ON especifica que el TRACE del cliente de VM se activará tan pronto como sea posible.

Par de palabra clave y valor de OPERATOR

OPERATOR userid

Especifica si se configurará un operador del cliente de VM antes del procesamiento de un archivo de comando del cliente de VM. userid especifica el nombre de la máquina virtual que recibirá los mensajes del cliente de VM.

Par de palabra clave y valor de MAXRC

MAXRC nn

Especifica si se activará el procesamiento de MAXRC del cliente de VM.

El procesamiento de MAXRC determina si el sistema del cliente de VM finalizará en el inicio cuando se exceda el código de retorno del comando especificado. Si no se especifica MAXRC, el cliente de VM siempre intentará completar la inicialización, independientemente de los fallos del comando de inicio. Este es el comportamiento por defecto. El valor nn especifica el código de retorno más alto permitido. Si un comando del cliente de VM que se ejecuta desde el juego de datos de SMCPARMS o SMCCMDS excede este valor, se generarán los mensajes SMC0236 y SMC0237 y terminará el cliente de VM. Los valores permitidos son 0, 4, 8 y 12.

Archivos de comando de cliente de VM

Los comandos del cliente de VM se puede especificar en los archivos de comando SMCPARMS y SMCCMDS. Durante la inicialización del cliente de VM, se leen estos archivos de comando y se ejecutan los comandos incluidos en estos archivos. Por convención, los nombres de los archivos de comando se asignan de la siguiente manera:

- SMCPARMS FILE A1

- SMCCMDS FILE A1

Los FILEDEF para SMCPARMS y SMCCMDS de SMCSTART EXEC se pueden modificar si se usan nombres de archivos diferentes.

Las sentencias de control de los archivos de comando del cliente de VM deben cumplir con las convenciones estándar para las sentencias de control descritas en Convenciones de instrucción de control.

SMCPARMS

El archivo de comando SMCPARMS se lee primero. Se usa para elementos configurados por el usuario que no se pueden modificar mientras el cliente de VM está activo. SMCPARMS no se puede volver a procesar mediante el comando READ.

A continuación, se muestra un ejemplo de la entrada del miembro SMCPARMS:

OPERATOR ID(nnnn)
LOGDISK ON
MSGDEF CASE(MIXED)
TCPIP TCPNAME(tcpname)

SMCCMDS

El archivo de comando SMCCMDS se usa para elementos configurados por el usuario que se pueden cambiar mientras el cliente de VM está activo. SMCCMDS se puede volver a procesar mediante el comando READ del cliente de VM. Consulte READ para obtener más información acerca de este comando.

A continuación, se muestra un ejemplo de la entrada del miembro SMCCMDS:

TAPEPLEX NAME(tttttttt)
SERVER NAME(ssssssss) TAPEPLEX(tttttttt) PORT(pppp) +
IPADDRESS(nn.nn.nn.nn)

Salidas de cliente del cliente de VM

El cliente de VM proporciona las siguientes salidas de cliente que se pueden implementar como EXEC del CMS.

- Salida nocturna SMCXIT00
Si se implementa esta salida, se ejecuta todas las noches a medianoche.

Consulte la muestra de instalación SMCXIT00.samp para conocer los parámetros de entrada (si corresponde), las capacidades y las instrucciones de instalación.

- Salida de autorización del comando SMCXIT01
Si se implementa esta salida, se ejecuta cuando se recibe el comando del cliente de VM o la solicitud de TMI, y el comando del cliente de VM o la solicitud de TMI no están autorizados por el comando AUTHorize correspondiente del cliente de VM.

Consulte AUTHorize para obtener información sobre el comando AUTHorize del cliente de VM. Consulte la muestra de instalación SMCXIT01.samp para conocer los parámetros de entrada (si corresponde), las capacidades y las instrucciones de instalación.

Nota:
La instalación de VMSES/E no instala estas salidas. Consulte las muestras de salida de clientes individuales para obtener instrucciones de instalación.

Soporte de DETACH del CP

El SMCPROP EXEC se proporciona para uso como rutina de acción del operador programable (PROP), para procesar todos los siguientes tipos de mensajes, que el CP envía a la consola del sistema:

TAPE raddr DETACHED....

VM (CP) causa la ejecución de un comando "Rewind Unload" (Rebobinar y descargar) en cualquier unidad de cinta que ha sido separada mediante el parámetro DETACH por los comandos del CP LOGOFF, FORCE o DETACH. Esto deja cualquier volumen de TapePlex separado mediante el parámetro DETACH por StorageTek con el estado "selected" (seleccionado) mientras aún reside en el transporte automatizado de TapePlex. El volumen no está disponible para solicitantes hasta que se extrae (o desmonta mediante DISMOUNT) de la unidad.

SMCPROP EXEC es una "acción de rutina" que se puede invocar desde el servicio VM PROP para ejecutar automáticamente los comandos DISMOUNT del cliente de VM cuando se separa mediante DETACH un transporte de TapePlex desde una máquina virtual y se activa el volumen (es decir, se anula la selección) antes de lo que, de otro modo, sería posible. RTABLE SAMPLE se proporciona para usar la rutina de acción SMCPROP con PROP. Consulte la publicación de IBM CMS Planning and Administration (Planificación y administración del CMS) para obtener información acerca del servicio PROP.

SMCPROP EXEC también se puede usar con VMOPERATOR para capturar mensajes de DETACH. LOGTABLE SAMPLE contiene sentencias VMOPERATOR LOGTABLE de muestra para ayudarlo. Consulte la documentación de VMOPERATOR para obtener información acerca de la personalización de las muestras según sus necesidades. El SMCPROP EXEC se debe actualizar si el ID de usuario de la máquina de servicio del cliente de VM no es VMSMC.

SMCPROP EXEC debe estar disponible para que la máquina PROP/VMOPERATOR funcione correctamente.

6 Comandos del cliente de VM

En este capítulo, se describen los comandos del operador del cliente de VM y los métodos usados para ejecutarlos.

Ejecución comandos de administración del cliente de VM

Use los siguientes métodos para ejecutar los comandos del cliente de VM:

- Especifique los comandos del cliente de VM en los archivos de SMCPARMS o SMCCMDS para que se procesen en el inicio. Consulte Archivos de comando de cliente de VM para obtener más información.

- Envíe los comandos del cliente de VM a la máquina de servicio del cliente de VM mediante la utilidad CP Special Message (Mensaje especial de CP, SMSG).
Ejecute el siguiente comando desde cualquier máquina virtual autorizada para ejecutar comandos en la máquina de servicio del cliente de VM:

CP SMSG userid command-string

donde:

- userid es el nombre de la máquina de servicio del cliente de VM definida en el directorio del CP.

- command-string es una cadena de caracteres que contiene un comando de cliente de VM válido.

- Inicie sesión en la máquina de servicio del cliente de VM y ejecute comandos desde la consola conectada.

Comandos del cliente de VM

En esta sección, se describen los comandos del cliente de VM.

AUTHorize

El comando AUTHorize le permite identificar los ID de usuario de VM que están autorizados para ejecutar las solicitudes de los comandos de la TMI y del cliente de VM. Este comando también permite eliminar entradas de autorización definidas anteriormente.

Nota:

- La salida del cliente SMCXIT01 se proporciona para agregar capacidades de autorización de sustitución al cliente de VM. Si un ID de usuario de VM no autorizado ejecuta un comando de cliente de VM o una solicitud de TMI, la salida SMCXIT01 se puede usar para sustituir la ausencia de un comando AUTHorize coincidente y proporcionar la autorización necesaria.

- No hay ningún ejecutable SMCXIT01 EXEC instalado por defecto como parte de la instalación del cliente de VM.

- Consulte el archivo SMCXIT01.samp distribuido para obtener un SMCXIT01 de salida de cliente de muestra y las instrucciones de instalación.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando AUTHorize:

Figura 6-1 Sintaxis del comando AUTHorize

Parámetros

Como se muestra en Figura 6-1, el comando AUTHorize incluye los siguientes parámetros:

LIst

De manera opcional muestra todas las asignaciones de AUTHorize actuales.

- LIst se usa como valor por defecto cuando no se especifican otros parámetros.

- Se puede especificar LIst con otros parámetros. En este caso, LIst se aplica después de que se han procesado el resto de los parámetros.

ID(VM-userid_list)

De manera opcional, especifica los ID de usuario de VM que se autorizarán, como se indica en VM-userid-list.

OFF ID(VM-userid-list)

De manera opcional, elimina las entradas de AUTHorize para los ID de usuario de VM especificados en VM-userid-list. El valor de parámetro "*" elimina todas las entradas de AUTHorize.

REQuest(CMD|TMI|ALL)

De manera opcional, especifica los privilegios del cliente de VM para ser autorizado o eliminado. Puede especificar este parámetros con los parámetros ID o OFF ID. Puede especificar uno o todos los siguientes valores:

- CMD indica las solicitudes del comando Authorize recibidas mediante la interfaz de SMSG.

- TMI indica las solicitudes de la API de la interfaz de gestión de cintas de Authorize.

- ALL indica las solicitudes de Authorize de CMD y TMI. Este es el valor por defecto si no se especifica REQuest.

Ejemplo

En el siguiente ejemplo, el comando AUTHorize autoriza el ID de usuario VMTAPE para ejecutar las solicitudes de TMI y mostrar todas las entradas de AUTHORIZE:

AUTH REQ(TMI) ID(VMTAPE) LIST

CMS

El comando del CMS permite transmitir comandos al entorno del CMS (sistema de supervisión de conversaciones) de VM sin salir del cliente de VM.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando del CMS.

Figura 6-2 Sintaxis del comando del CMS

Parámetros

Como se muestra en Figura 6-2, el comando del CMS incluye los siguientes parámetros:

cmdparm

Cualquier comando del CMS y cadena de parámetros.

Ejemplo

En el siguiente ejemplo, el comando del CMS especifica una consulta de las definiciones de archivo vigentes:

CMS QUERY FILEDEF

COMMtest

El comando COMMtest permite probar las rutas de comunicaciones en uno o más servidores mediante la ejecución del comando QUERY SERVER en las rutas de comunicaciones especificadas y el resumen de los resultados.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando COMMtest:

Figura 6-3 Sintaxis del comando COMMtest

Parámetros

Como se muestra en Figura 6-3, el comando COMMtest incluye los siguientes parámetros:

TAPEPlex(name)

De manera opcional, especifica el TapePlex para la prueba de comunicación. Si no especifica este parámetro, se prueba la comunicación para todos los TapePlex no desactivados.

name es el nombre del TapePlex, tal como lo define el comando TAPEPlex del cliente de VM. Se aplican las siguientes reglas:

- Este valor debe tener entre 1 y 8 caracteres.

- El primer carácter debe ser un carácter alfanumérico o un dígito.

- El último carácter debe ser un carácter alfanumérico o un dígito.

- Los caracteres que se encuentran entre el primero y el último deben ser caracteres alfanuméricos, dígitos o guiones.

Puede especificar los siguientes parámetros secundarios:

SERVer(name)

De manera opcional, especifica la ruta de servidor para la prueba de comunicación. Si no especifica este parámetro, se prueba la comunicación para todas las rutas de servidor no desactivadas para el TapePlex especificado.

name es el nombre de la ruta de servidor, tal como la define el comando SERVer del cliente de VM. Se aplican las siguientes reglas:

- Este valor debe tener entre 1 y 8 caracteres.

- El primer carácter debe ser un carácter alfanumérico o un dígito.

- El último carácter debe ser un carácter alfanumérico o un dígito.

- Los caracteres que se encuentran entre el primero y el último deben ser caracteres alfanuméricos, dígitos o guiones.

ANYSTATus

De manera opcional, se prueba la comunicación para todas las rutas de comunicación, incluidas las rutas que han sido desactivadas por un comando de operador o por el cliente de VM.

PORTrange(nnnn|nnnn-nnnn)
De manera opcional, especifica que se ha probado la comunicación para una ruta de servidor remota desde el puerto o el rango especificados. El PORTrange especificado puede ser diferente de la especificación de TCPip PORTrange para permitir la prueba de una configuración de firewall.

nnnn o nnnn-nnnn es el número de puerto o el rango del número de puerto que se usará para comunicación. Cada número de puerto puede tener un valor de 1 a 65535. Sin embargo, el rango de número de puerto máximo que se puede especificar es 100 (por ejemplo, 6401-6500). Si se omite, se usa un puerto en el TCPip PORTrange definido. Si no se define tal puerto, se usa un puerto efímero. Si se especifica un rango de puertos, se intenta la comunicación en cada número de puerto.

REPEAT(nnnnn)
De manera opcional, especifica el número de veces que se repetirá la prueba de comunicación. Los valores válidos para nnnnn son de 1 a 99999.

Ejemplo

En el siguiente ejemplo, un usuario ejecuta el comando COMMtest para probar la ruta de comunicaciones a PRODHSC1 de TapePlex mediante SERVer PATHHSC1 y repetir la operación de comunicación QUERY SERVER de XAPI 100 veces.

COMMTEST TAPEPLEX(PRODHSC1) SERVER(PATHHSC1) REPEAT(100)

CP

El comando CP permite transmitir comandos al entorno del CP (programa de control) de VM sin salir del cliente de VM.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando CP:

Figura 6-4 Sintaxis del comando CP

Parámetros

Como se muestra en Figura 6-4, el comando CP incluye los siguientes parámetros:

cmdparm

Cualquier comando del CMS válido y cadena de caracteres.

Ejemplo

En el siguiente ejemplo, el comando CP especifica una consulta de los atributos de CPLEVEL vigentes.

CP QUERY CPLEVEL

DISMount

El comando DISMount desmonta un volumen de una unidad.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando DISMount:

Figura 6-5 Sintaxis del comando DISMount

Parámetros

Como se muestra en Figura 6-5, el comando DISMount incluye los siguientes parámetros:

DRive(uuuu)

Especifica una dirección de unidad de cinta del transporte desde el que se desmontará el volumen. Este parámetro es obligatorio.

uuuu es la dirección de la unidad de cinta. Si se usa el comando DRIVEMAP, esta será la dirección de CLIENT. Consulte DRIVemap.

VOLser(vvvvvv)

Especifica una dirección de unidad de cinta del transporte desde el que se desmontará el volumen. Este parámetro es obligatorio.

vvvvvv es la dirección de la unidad de cinta (número de serie de volumen).

FORCE

De manera opcional, especifica que el dispositivo se deberá descargar antes de desmontar el volumen. Este parámetro no es válido para unidades virtuales.

Ejemplo

En el siguiente ejemplo, el comando DISMount desmonta el volumen AAA001 de la unidad 2900.

DISMOUNT DRIVE(2900) VOLSER(AAA001)

Display DRive

El comando Display DRive permite solicitar el atributo de unidad del cliente de VM y la información de propiedad de TapePlex.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando Display DRive:

Figura 6-6 Sintaxis del comando Display DRive

Parámetros

Como se muestra en Figura 6-6, el comando Display DRive incluye los siguientes parámetros:

devnum, devnum-range o devnum-list

Indica un número de dispositivo, un rango de números de dispositivo o una lista de números de dispositivos que se mostrarán. Cada número de dispositivo debe ser una dirección hexadecimal válida con el formato ccuu. Si se usa el comando DRIVEmap, estas serán las direcciones de CLIENT.

TAPEPlex(name)

De manera opcional, muestra solamente los dispositivos que son propiedad del TapePlex especificado. Si no se especifica este parámetro, se mostrarán los dispositivos propios para todos los TapePlex.

name es el nombre del TapePlex. Se aplican las siguientes reglas:

- Este valor debe tener entre 1 y 8 caracteres.

- El primer carácter debe ser un carácter alfanumérico o un dígito.

- El último carácter debe ser un carácter alfanumérico o un dígito.

- Los caracteres que se encuentran entre el primero y el último deben ser caracteres alfanuméricos, dígitos o guiones.

También puede incluir los parámetros ALL, Real o Virtual para controlar el tipo de TapePlex que se muestran.

ALL

De manera opcional, se muestran todos los dispositivos que son propiedad de los TapePlex definidos por SCM. Este es el valor por defecto si no se especifica ningún parámetro.

Real

De manera opcional, muestra los dispositivos "real" (es decir, no virtual) que son propiedad de todos los TapePlex definidos.

Virtual

De manera opcional, se muestran solamente los dispositivos virtuales que son propiedad de todos los TapePlex definidos.

IDentity

De manera opcional, muestra información que identifica el número de serie de unidad.

Ejemplo

En el siguiente ejemplo, el comando Display DRive muestra solamente los dispositivos "reales" (es decir, no virtuales) conocidos para el cliente de VM:

DISPLAY DRIVE REAL

Display RC

El comando Display RC permite mostrar información acerca del significado de un código de retorno o motivo del SMC, o un código de motivo UUI de HSC/VTCS.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando Display RC:

Figura 6-7 Sintaxis del comando Display RC

Parámetros

Como se muestra en Figura 6-7, el comando Display RC incluye los siguientes parámetros:

X o HEX

De manera opcional, especifica que el rango o el valor del código de motivo/retorno se especifican como números hexadecimales.

nnnn o nnnn-nnnn

De manera opcional, indica un código de retorno o una lista de códigos de retorno para los que se mostrará la explicación.

- Si se especifica X o HEX, el valor puede contener caracteres hexadecimales de 0 a 9 y de A a F.

- Si no se especifica X o HEX, el valor puede contener solamente caracteres numéricos.

ALL

De manera opcional, indica que se mostrarán todos los códigos de retorno o de motivo. ALL se permite solamente desde una utilidad.

Nota:
ALL y X/HEX se excluyen mutuamente.

DETail

De manera opcional, indica que se mostrará información detallada acerca de los códigos solicitados.

Ejemplo

En el siguiente ejemplo, el comando Display RC muestra información para el código de retorno del SMC 302:

DISPLAY RC 302

Display Volume

El comando Display Volume permite solicitar el atributo de volumen y la información de propiedad de TapePlex.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando Display Volume:

Figura 6-8 Sintaxis del comando Display Volume

Parámetros

Como se muestra en Figura 6-8, el comando Display Volume incluye los siguientes parámetros:

volser, volser-range o volser-list

Indica el volser, el rango de volser o la lista de volser que se procesará. Si se especifican varios volúmenes, solamente se mostrarán los primeros 100.

ALLTapeplex

De manera opcional, especifica que se consultarán todos los TapePlex activos para los volser especificados. Si se especifica, se pueden mostrar varias líneas para el mismo volser, si está definido en varios TapePlex.

Si no se especifica este parámetro, el comando Display Volume consulta los TapePlex en el orden en el que se definen y muestra solamente la primera instancia del volumen.

Ejemplo

En el siguiente ejemplo, el comando Display Volume muestra el número de serie de volumen EVT100 que se encuentra en cualquier TapePlex accesible desde el cliente de VM:

DISPLAY VOLUME EVT100 ALLTAPEPLEX

DRIVemap

El comando DRIVemap le permite asignar las direcciones de dispositivo del cliente de VM a las direcciones de unidad del servidor. Este comando permite a los usuarios especificar diferentes direcciones en el cliente de VM y en el host del servidor para los mismos dispositivos TapePlex reales o virtuales.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando DRIVemap:

Figura 6-9 Sintaxis del comando DRIVemap

Parámetros

Como se muestra en Figura 6-9, el comando DRIVemap incluye los siguientes parámetros:

LIst

De manera opcional, muestra todas las asignaciones de DRIVemap actuales.

CLient(address)

De manera opcional, especifica los números de dispositivos asignados al comando DRIVemap.

address es el número de dispositivo, el rango de números de dispositivos o la lista de números de dispositivos. Cada número de dispositivo es un número hexadecimal.

Además, puede incluir el parámetro secundario SErver:

SErver(address)

De manera opcional, especifica los números de dispositivos que se definen en el servidor del HSC.

address es el número de dispositivo, el rango de números de dispositivos o la lista de números de dispositivos. El número de dispositivo es un número hexadecimal.

- Si se especifica CLient sin el parámetro OFF, se requiere SErver.

- Si se especifican CLient y SErver, el parámetro CLient debe especificar una lista de direcciones equivalente o un rango, según lo especifique el parámetro del servidor.

Nota:
Los comandos del cliente de VM introducidos que hacen referencia a una dirección de dispositivos (como DISPLAY DRIVE, DISMOUNT o MOUNT) deben especificar la dirección del dispositivo de cliente (o la dirección conocida por el cliente de VM).

Puede incluir el parámetro LIst para mostrar las asignaciones de DRIVemap para números de dispositivo específicos.

OFF
De manera opcional, elimina todas las entradas de DRIVemap. Si se especifica este parámetro con el parámetro CLient, se eliminarán solamente las asignaciones de CLient DRIVemap coincidentes. La especificación de dirección (lista o rango) debe coincidir exactamente con la especificación de definición.

Ejemplo

En el siguiente ejemplo, el comando DRIVemap asigna direcciones de dispositivo de cliente de 180 a 188 a las direcciones de dispositivo de servidor de 280 a 288:

DRIVEMAP CLIENT(180-188) SERVER(280-288)

DUMP

El comando DUMP permite forzar la producción de un volcado del almacenamiento de la máquina de servicio en cualquier momento. Se vuelca todo el almacenamiento de la máquina de servicio. Los comandos DUMP son para fines de diagnóstico. Úselos solamente según lo indique el soporte de software de StorageTek.

El volcado se produce mediante el comando CP VMDUMP. El destino del volcado es el lector de la máquina de servicio (clase V).

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando DUMP:

Figura 6-10 Sintaxis del comando DUMP

Parámetros

Como se muestra en Figura 6-10, el comando DUMP incluye los siguientes parámetros:

TITLE(’comment’)

De manera opcional, describe el volcado.

comment es el título del volcado, que tiene hasta 72 caracteres encerrados entre comillas simples. Este título solamente es válido para este comando DUMP. El título por defecto es ’VM CLIENT DUMP COMMAND’.

Ejemplo

En el siguiente ejemplo, el comando DUMP especifica un volcado de la máquina de servicio del cliente de VM con el título especificado:

DUMP TITLE(’Sample Dump’)

DUMPOpts

El comando DUMPOpts permite especificar o restablecer el número máximo de volcados de VMDUMP que se generarán. Este comando ayuda a evitar que se agote el espacio en la cola de VM en el caso poco probable de que se produzca un ciclo grave de terminaciones anormales.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando DUMPOpts:

Figura 6-11 Sintaxis del comando DUMPOpts

Parámetros

Como se muestra en Figura 6-11, el comando DUMPOpts incluye los siguientes parámetros:

LIst

De manera opcional, muestra la configuración actual de DUMPOpts, incluidos DUMPS TAKEN, DUMPS MAX COUNT y USERID.

RESETcount

De manera opcional, restablece el número de volcados generados a cero.

MAXdump(nnn)

De manera opcional, configura el recuento del umbral para el número de volcados que se permitirán antes de que se desactive el procesamiento.

nnn es el número de volcados. Es un número decimal de 0 a 999. El valor por defecto es 50.

TO(userid)

De manera opcional, especifica el ID de usuario para recibir el volcado.

userid es el ID de usuario. Debe ser un ID de usuario de VM definido. Si se introduce un asterisco (*), se convierte al ID de máquina de servicio del cliente de VM. El valor por defecto es el ID de usuario de la máquina de servicio del cliente de VM.

Ejemplo

En el siguiente ejemplo, el comando DUMPOpts restablece el número de volcados generados a cero y configura el valor del umbral en diez:

DUMPOPTS RESETCOUNT MAXDUMP(10)

EXIT

El comando EXIT le permite terminar la máquina de servicio del cliente de VM.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando EXIT:

Figura 6-12 Sintaxis del comando EXIT

Parámetros

Ninguno.

Help

El comando Help permite mostrar el comando y la información de mensajes del cliente de VM.

Nota:
Si introduce el comando Help sin parámetros, se mostrará la información para todos los comandos disponibles del cliente de VM.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando Help:

Figura 6-13 Sintaxis del comando Help

Parámetros

Como se muestra en Figura 6-13, el comando Help incluye los siguientes parámetros:

command-name

De manera opcional, un nombre de comando de cliente de VM.

nnnn

De manera opcional, la parte numérica de cuatro dígitos de un identificador de mensajes del cliente de VM. No son necesarios los ceros iniciales.

nnnn-nnnn

De manera opcional, un rango de mensajes del cliente de VM especificados mediante la parte numérica de cuatro dígitos del identificador de mensajes.

SMCnnnn

De manera opcional, un identificador de mensajes completo del cliente de VM.

SMCnnnn-SMCnnnn

De manera opcional, un rango de mensajes del cliente de VM especificado mediante identificadores de mensajes.

Ejemplo

En el siguiente ejemplo, el comando Help muestra información del mensaje SMC0228 del cliente de VM.

HELP SMC0228

LIst

El comando LIst permite mostrar el contenido de almacenamiento dentro de la máquina virtual del cliente de VM. Este comando es para fines de diagnóstico. Úselo solamente según lo indique el soporte de software de StorageTek.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando LIst:

Figura 6-14 Sintaxis del comando LIst

Parámetros

Como se muestra en Figura 6-14, el comando LIst incluye los siguientes parámetros:

Address(address)

De manera opcional, especifica la dirección en la que se comenzará a mostrar el contenido de la memoria del cliente de VM.

address es una dirección hexadecimal.

CB(control-block-name)

De manera opcional, especifica el bloque de control del cliente de VM que se mostrará.

control-block-name es el nombre del bloque de control.

Los bloques del control del cliente de VM se muestran para fines de diagnóstico. Especifique control-block-name solamente según lo indique el soporte de software de StorageTek.

TASKs

De manera opcional, muestra las tareas activas del sistema del cliente de VM.

FUNIT(uuuu|uuuu-uuuu)

De manera opcional, muestra los bloques de control del cliente de VM asociados con las direcciones de las unidades especificadas.

uuuu o uuuu-uuuu es una dirección de unidad única o un rango de direcciones de unidades.

LOGdisk

El comando LOGdisk le permite controlar el registro de la salida de la consola YYYYMMDD LOG.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando LOGdisk:

Figura 6-15 Sintaxis del comando LOGdisk

Parámetros

Como se muestra en Figura 6-15, el comando LOGdisk incluye los siguientes parámetros:

LIst

De manera opcional, muestra la configuración actual de LOGdisk.

- LIst es el valor por defecto si no se especifican parámetros en el comando LOGdisk.

- Se puede especificar LIst con otros parámetros. En este caso, LIst se aplica después de que se han procesado el resto de los parámetros.

ON

De manera opcional, permite el registro de la salida de la consola con las opciones que se muestran. Si el registro está activado, se registran todos los comandos y todos los mensajes.

Además, puede introducir el siguiente parámetro:

FM(m)

Especifica el modo de archivo para recibir el archivo log del disco. El FM debe especificar un minidisco RW. Este parámetro solamente es válido con el parámetro ON.

m es el modo de archivo. Este valor debe ser un carácter alfanumérico. El valor por defecto es 'A'.

OFF
De manera opcional, desactiva el registro de la salida de la consola con las opciones que se muestran. El archivo log se cierra.

FLUSH
De manera opcional, vacía el archivo log. El archivo se cierra y se vuelve a abrir.

Todos los mensajes se escriben en la consola de la máquina de servicio del cliente de VM. El comando CP SPOOL puede controlar el manejo de la consola de la máquina de servicio del cliente de VM. Se recomienda que se inicie la consola de la máquina de servicio del cliente de VM en PROFILE EXEC y que se ponga en cola en un ID de mantenimiento. Por ejemplo:

CP SPOOL CON START TO MAINT

Ejemplo

En el siguiente ejemplo, el comando LOGdisk activa el registro en un archivo de disco:

LOGDISK ON

MOunt

El comando MOunt permite montar un volumen en una unidad.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando MOunt:

Figura 6-16 Sintaxis del comando MOunt

Parámetros

Como se muestra en Figura 6-16, el comando MOunt incluye los siguientes parámetros:

DRive(uuuu)

Especifica una dirección de unidad de cinta del transporte en el que se montará el volumen.

uuuu es la dirección de la unidad de cinta. Si se usa el comando DRIVemap, esta es la dirección de CLIENT.

VOLser(vvvvvv)

De manera opcional, especifica el volumen que se montará. Si no se especifica este parámetro, se montará un volumen reutilizable.

vvvvvv es el número de serie del volumen. Especifique SCRTCH para un volumen reutilizable.

Readonly

De manera opcional, especifica que el volumen se montará para acceso de solo lectura. Este parámetro solamente es válido para un montaje específico.

SUBpool(subpool-name)

De manera opcional, especifica que se tomará un volumen reutilizable de una subagrupación reutilizable. Si no se especifica este parámetro, el comportamiento dependerá de cómo se definan las agrupaciones reutilizables en el servidor del HSC. Consulte la descripción del comando MOUNT del HSC para obtener más información. Este parámetro solamente es válido para un montaje reutilizable.

subpool-name es el nombre de la subagrupación.

MEdia(media-type)

De manera opcional, especifica el tipo de medio del volumen reutilizable. El medio especificado debe ser compatible con el DRive de la solicitud. Este parámetro solamente es válido para un montaje reutilizable.

media-type es el tipo de medio. Consulte Apéndice A, Valores de MEDia, RECtech y MODel para obtener una lista de los valores de tipos de medios.

Nota:
Si no se especifica MEDia, se montará el siguiente el siguiente volumen reutilizable sin considerar el tipo de medio.

MGMTclas(mgmt-clas-name)

De manera opcional, especifica una clase de gestión definida en la sentencia de control MGMTclas del HSC/VTCS. Este parámetro solamente es válido para un montaje reutilizable.

mgmt-clas-name es el nombre de la clase de gestión.

Ejemplo

En el siguiente ejemplo, el comando MOunt monta el volumen AAA001 en la unidad 2900:

MOUNT DRIVE(2900) VOLSER(AAA001)

MSGDef

El comando MDGDef define la apariencia de los mensajes del sistema del cliente de VM y controla cuáles mensajes se mostrarán y se eliminarán.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando MSGDef:

Figura 6-17 Sintaxis del comando MSGDef

Parámetros

Como se muestra en Figura 6-17, el comando MSGDef incluye los siguientes parámetros:

LIst

De manera opcional, muestra la configuración de mensajes del cliente de VM por defecto.

- LIst es el valor por defecto si no se especifican parámetros en el comando MSGDef.

- Se puede especificar LIst con otros parámetros. En este caso, LIst se genera después de que se han procesado el resto de los parámetros.

OFF

De manera opcional, restablece todos los valores de MSGDef a la configuración original por defecto del cliente de VM. Especifique LIst con este parámetro para mostrar estos ajustes de configuración.

CASE(UPPER|MIXED)

De manera opcional, especifica si el mensaje llevará mayúsculas o minúsculas. Los valores válidos son UPPER o MIXED.

- UPPER especifica que se usarán mayúsculas. Este es el valor por defecto.

- MIXED especifica que se usará una combinación de mayúsculas y minúsculas.

LVl(level)

De manera opcional, especifica el nivel por defecto que se usará para controlar cuáles mensajes del cliente de VM se mostrarán y se eliminarán.

level es el nivel por defecto. Los valores válidos son los siguientes:

- 0: muestra solamente mensajes de error.

- 4: muestra mensajes de error y de advertencia desde la máquina de servicio del cliente de VM.

- 8: muestra todos los mensajes de la máquina de servicio del cliente de VM y los mensajes de advertencia de logs de trabajos de asignación. Este es el parámetro por defecto si no se especifica el parámetro MSGDef.

Nota:
Los niveles mayores que 8 se usan para fines de diagnóstico y se deben especificar solamente según lo indique el soporte de software de StorageTek.

ECHOmnterr(ON|OFF)

De manera opcional, especifica si los errores de montaje generados por el HSC se reflejan directamente en la consola para el cliente de VM.

- ON especifica que los errores de montaje generados por el HSC se reflejan en la consola para el cliente de VM. Este es el valor por defecto.

- OFF especifica que los errores de montaje generados por el HSC no se reflejan en la consola para el cliente de VM.

VERBOSE(OFF|ON)

De manera opcional, especifica si los mensajes SMC0190 y SMC0191 se mostrarán cada vez que se modifiquen los ajustes de configuración del cliente de VM.

- OFF especifica que se muestran los mensajes SMC0190 y SMC0191.

- ON especifica que no se muestran los mensajes SMC0190 y SMC0191. Este es el valor por defecto.

Ejemplo

En el siguiente ejemplo, el comando MSGDef especifica que los mensajes aparecen con una combinación de mayúsculas y minúsculas, y que solamente se muestran los mensajes de error y advertencia de la máquina de servicio del cliente de VM:

MSGD CASE(MIXED) LVl(4)

OPERator

El comando OPERator especifica la máquina virtual que recibirá los mensajes del cliente de VM.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando OPERator:

Figura 6-18 Sintaxis del comando OPERator

Parámetros

Como se muestra en la Figura 6-8, el comando OPERator incluye los siguientes parámetros:

LIst

De manera opcional, muestra la configuración actual del operador.

- LIst es el valor por defecto si no se especifican parámetros para el comando OPERator.

- Se puede especificar LIst con otros parámetros. En este caso, se genera la lista después de que se han procesado el resto de los parámetros.

ID(VM-userid)

De manera opcional, especifica el nombre de la máquina virtual que recibirá los mensajes del cliente de VM.

VM-userid es el ID de usuario de la máquina virtual. Debe ser un ID de usuario de VM definido. Si se introduce un asterisco (*), se convierte al ID de máquina de servicio del cliente de VM. El valor por defecto es el ID de usuario de la máquina de servicio del cliente de VM.

Ejemplo

En el siguiente ejemplo, el comando OPERator especifica la máquina de OPER que recibirá los mensajes:

OPERATOR ID(OPER)

POOLmap

El comando POOLmap permite asignar un nombre de subagrupación de volúmenes reutilizables del HSC a una clase de gestión del VTCS.

Los sistemas de gestión de cintas que usan la interfaz de gestión de cintas de VM/HSC (VMTMI) generalmente especifican solamente un nombre de subagrupación para solicitudes de volúmenes reutilizables y no especifican una clase de gestión. El comando POOLmap proporciona un método para suministrar un nombre de clase de gestión para los montajes de volúmenes reutilizables. El comando POOLmap se recomienda especialmente si el cliente de VM solicita montajes de cintas virtuales.

Nota:
El comando POOLmap valida los nombres de clases de gestión y subagrupación especificados mediante la comunicación con el servidor TapePlex. Por lo tanto, los comandos POOLmap no se deben especificar antes de que se procese cualquier comando de TAPEPlex y SERVer del cliente de VM.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando POOLmap:

Figura 6-19 Comando del operador POOLmap

Parámetros

Como se muestra en Figura 6-19, el comando POOLmap incluye los siguientes parámetros:

LIst

De manera opcional, muestra la configuración actual del operador.

- LIst es el valor por defecto si no se especifican parámetros para el comando OPERator.

- Se puede especificar LIst con otros parámetros. En este caso, se genera la lista después de que se han procesado el resto de los parámetros.

MGMTclass(mmmmm)

De manera opcional, especifica el nombre de gestión definido en el servidor del HSC.

mmmmm es el nombre de clase de gestión alfanumérico de 1 a 8 caracteres.

OFF

De manera opcional, elimina todas las entradas de POOLmap.

Si se especifica este parámetro con los parámetros MGMTclass o SUBPool, solamente se eliminarán las entradas de POOLmap coincidentes.

SUBPool(subpool-list)

Especifica los nombres de subagrupación de volúmenes reutilizables en el servidor del HSC.

subpool-list es uno o más nombres de subagrupaciones de volúmenes reutilizables para asociar con el nombre de clase de gestión especificado.

Ejemplo

En el siguiente ejemplo, el comando POOLmap asigna la clase de gestión, DAILY, a las subagrupaciones de volúmenes reutilizables, VIRTCART1 and VIRTCART2:

POOLMAP MGMT(DAILY) SUBP(VIRTCART1,VIRTCART2)

READ

El comando READ permite introducir una serie de comandos que usan un juego de datos de entrada en lugar de comandos de la consola.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando READ:

Figura 6-20 Sintaxis del comando READ

Parámetros

Como se muestra en Figura 6-20, el comando READ incluye los siguientes parámetros:

SMCCMDs

De manera opcional, vuelve a procesar los comandos contenidos en el juego de datos especificado en SMCCMDS FILEDEF del procedimiento START del cliente de VM.

FILE(filename filetype) y, de manera opcional, filemode.

De manera opcional, especifica el archivo para READ.

- filename es el nombre del archivo.

- filetype es el tipo de archivo.

- filemode es el modo de archivo. El valor por defecto es A.

Ejemplo

En el siguiente ejemplo, el comando READ procesa los comandos de SMCCMDS FILEDEF de startup EXEC del cliente de VM.

READ SMCCMDS

RESYNChronize

El comando RESYNChronize permite restablecer conexiones a todos los TapePlex definidos con el fin de adquirir información de configuración de unidades de todos los TapePlex.

Esta acción se realiza automáticamente cuando el cliente de VM activa por primera vez una nueva ruta a un TapePlex o cuando un servidor del HSC informa un cambio en la configuración.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando RESYNChronize:

Figura 6-21 Sintaxis del comando RESYNChronize

Parámetros

Como se muestra en Figura 6-21, el comando RESYNChronize incluye los siguientes parámetros:

REStart

De manera opcional, inicia el intento de RESYNChronize en el primer servidor, independientemente de la última ruta activa.

WAIT(OFF|nnnnnn)

De manera opcional, espera que el servidor esté disponible. Esta opción es útil una vez que se han definido TAPEPLEX y SERVERs. El comando no se completará hasta que el servidor esté disponible o hasta que haya caducado la hora especificada, nnnnnn.

- nnnnnn es el tiempo de espera en minutos, de 0 a 999999.

- OFF especifica que el comando no espera un servidor disponible. Este es el valor por defecto.

Ejemplo

En el siguiente ejemplo, el comando RESYNChronize especifica que se reiniciarán las comunicaciones desde el primer servidor:

RESYNC RESTART

En el siguiente ejemplo, el comando RESYNChronize especifica que se esperará hasta que un servidor esté disponible:

RESYNC WAIT(9999)

Route

El comando Route permite solicitar el enrutamiento de transacciones desde el cliente de VM hasta un nombre de TapePlex definido.

Nota:
También puede usar el comando Route para ejecutar varios comandos desde un cliente de VM a un servidor ACSLS XAPI. Consulte la publicación de ELS XAPI Client Interface to ACSLS Server Reference (Referencia de interfaz de cliente XAPI para el servidor ACSLS) para obtener más información.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando Route:

Figura 6-22 Sintaxis del comando Route

Parámetros

Como se muestra en Figura 6-22, el comando Route incluye los siguientes parámetros:

tapeplex-name

Un nombre de TapePlex tal como se define en un comando TAPEPlex del cliente de VM. El cliente de VM enruta la solicitud al TapePlex especificado mediante la ruta de TapePlex actualmente activa.

command-string

La cadena del comando que se enrutará al TapePlex solicitado.

- El cliente de VM no intentará validar la cadena del comando especificado, pero simplemente enrutará la cadena del comando como introducida para el tapeplex-name especificado y mostrará las respuestas.

- Los comandos del VTCS no deben tener el prefijo VT; la interfaz de UUI del HSC enruta los comandos del VTCS al procesador funcional adecuado sin el prefijo VT.

- El valor de command-string debe ser un comando admitido por UUI del HSC (excepto VOLRPT) o cualquier comando del VTCS (excepto VTVRPT, DISPLAY MSG y DISPLAY CMD).

Ejemplo

En el siguiente ejemplo, el comando Route enruta la cadena del comando "D CDS" al TapePlex HSC8 para procesamiento. Las respuestas recibidas serán mostradas por el mensaje SMC0173:

R HSC8 DI CDS

SERVer

El comando SERVer define una ruta con nombre a un servidor de biblioteca remoto. El comando SERVer describe la ruta de comunicación al servidor HTTP de StorageTek. El comando SERVer también puede mostrar los servidores definidos por el cliente de VM.

Tenga en cuenta lo siguiente:

- Antes de definir un SERVer, el TapePlex al que hace referencia se deberá definir mediante el comando TAPEPlex.

- El nombre del TapePlex asociado con un SERVer no se puede cambiar. Consulte TAPEPlex para obtener más información.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando SERVer:

Figura 6-23 Sintaxis del comando SERVer

Parámetros

Como se muestra en Figura 6-23, el comando SERVer incluye los siguientes parámetros:

LIst

De manera opcional, muestra información de estado para las rutas de servidor TapePlex.

- LIst es el valor por defecto si no se especifican parámetros en el comando SERVer. En este caso, se muestran todas las rutas de servidor.

- Se puede especificar LIst con otros parámetros. Si se especifica con parámetros diferentes a NAme, LIst se genera después de que se procesan los demás parámetros.

De manera opcional, también puede especificar NAme (name) con este parámetro. NAme especifica una ruta de servidor TapePlex para la que se muestra el estado; name es el nombre de la ruta de servidor.

NAme(name)

De manera opcional, especifica la ruta de comunicación o la ruta al servidor TapePlex.

name es un identificador para los parámetros de ruta. Este nombre se informa en todos los mensajes de error de comunicación. Se aplican las siguientes reglas:

- El valor debe tener entre uno y ocho caracteres de longitud.

- El primer carácter debe ser un carácter alfanumérico o un dígito.

- El último carácter debe ser un carácter alfanumérico o un dígito.

- Los caracteres que se encuentran entre el primero y el último deben ser caracteres alfanuméricos, dígitos o guiones.

ENable

De manera opcional, permite seleccionar la ruta de servidor especificada para solicitudes de montaje.

DIsable

De manera opcional, desactiva la ruta de servidor especificada. Si esta es la única ruta al TapePlex, el TapePlex no está disponible para solicitudes de montaje.

TAPEPlex(name)

De manera opcional, especifica el nombre del TapePlex asociado con la configuración de hardware del ACS. El parámetro de TAPLEPlex se debe especificar cuando se define un nuevo servidor.

name es el nombre del TapePlex. Este nombre se informa en todos los mensajes de error del servidor TapePlex. Se aplican las siguientes reglas:

- El valor debe tener entre uno y ocho caracteres de longitud.

- El primer carácter debe ser un carácter alfanumérico o un dígito.

- El último carácter debe ser un carácter alfanumérico o un dígito.

- Los caracteres que se encuentran entre el primero y el último deben ser caracteres alfanuméricos, dígitos o guiones.

Nota:
Puede definir varias rutas a un único TapePlex.

Parámetros de ruta de servidor

HSCSUB(ssss)

De manera opcional, especifica el nombre del subsistema del HSC que representa el TapePlex asociado con el servidor. Este parámetro se requiere solamente si hay más de un subsistema del HSC que se ejecuta en el host del servidor (el HSC se ejecuta en modo MULT).

ssss es el nombre del subsistema del HSC.

HOst(hostname)

De manera opcional, especifica el nombre de host de la resolución de IP del servidor TapePlex. Para la consulta de DNS, el cliente de VM debe tener acceso al archivo TCPIP DATA.

hostname es el nombre del host remoto.

Nota:
HOst y IPaddress se excluyen mutuamente.

IPaddress(ipaddress)

De manera opcional, especifica la dirección IP del servidor TapePlex.

ipaddress es la dirección IP del host remoto.

Nota:
IPaddress y HOst se excluyen mutuamente.

POrt(nnnn)

De manera opcional, especifica el puerto del servidor.

nnnn es el puerto del servidor, de 0 a 65535. El valor por defecto es 8080.

WAit(nnnn)

De manera opcional, especifica el tiempo de espera máximo por defecto para las solicitudes antes de que el cliente de VM finalice el tiempo de espera de la solicitud.

nnnn es el tiempo de espera en segundos, de 0 a 9999. El valor por defecto es 60.

Nota:
El tiempo de espera por defecto no se aplica a solicitudes de montaje, desmontaje, expulsión o movimiento que tienen un valor de timeout por defecto de 10 minutos, 10 minutos, 24 horas y 1 hora respectivamente.

REtry(nnnn)

De manera opcional, especifica el número de reintentos para una única solicitud antes de que la tarea se pueda reanudar y se registre un fallo.

nnnn es el número de reintentos, de 0 a 9999. El valor por defecto es 3.

FAil(nnnn)

De manera opcional, especifica el número máximo de fallos después de que se ha establecido la comunicación correcta, antes de que se desactive la ruta de servidor específica o de que se coloque fuera de servicio.

nnnn indica el número de fallos. El valor por defecto es 0.

Si se especifica 0, el SERVER con nombre nunca se desactivará automáticamente debido a errores de comunicación.

Se deberá especificar este valor si no hay rutas de SERVER de respaldo para una biblioteca con nombre.

El recuento límite de FAIL solamente se aplica después de que se ha establecido la comunicación correcta en esta ruta de SERVER.

Ejemplo

En el siguiente ejemplo, el comando SERVer agrega un servidor con el nombre DENVER1 para DENVER del TapePlex.

SERVER NAME(DENVER1) TAPEPLEX(DENVER) IP(11.22.33.44) PORT(7777)

TAPEPlex

El comando TAPEPlex define un TapePlex; una configuración de hardware de cintas de StorageTek específica, normalmente representada por un único CDS.

Tenga en cuenta lo siguiente:

- Se requieren los comandos TAPEPlex y SERVer para acceder a los TapePlex del HSC.

- El comando TAPEPlex también puede mostrar los TapePlex con los que se intenta comunicar el cliente de VM e informar su estado.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando TAPEPlex:

Figura 6-24 Sintaxis del comando TAPEPlex

Parámetros

Como se muestra en Figura 6-24, el comando TAPEPlex incluye los siguientes parámetros:

LIst

De manera opcional, muestra el TapePlex especificado.

NAme(name)

De manera opcional, especifica el nombre del TapePlex que se definirá o se modificará.

name es el nombre del TapePlex. Este nombre se informa en todos los mensajes de error de TapePlex. Se aplican las siguientes reglas:

- Este valor debe tener entre uno y ocho caracteres.

- El primer carácter debe ser un carácter alfanumérico o un dígito.

- El último carácter debe ser un carácter alfanumérico o un dígito.

- Los caracteres que se encuentran entre el primero y el último deben ser caracteres alfanuméricos, dígitos o guiones.

Puede especificar los siguientes subparámetros:

- ENable permite seleccionar el TapePlex especificado para las solicitudes de montaje. Este es el valor por defecto.

- DIsable desactiva el TapePlex especificado. El TapePlex no se usa para solicitudes de montaje.

SERVerlist

De manera opcional, muestra los TapePlex definidos, sus atributos y servidores asociados. El parámetro SERVerlist también se puede especificar con el parámetro NAME para limitar la visualización a un único TapePlex.

Puede especificar el siguiente subparámetro:

- NAME especifica el nombre del TapePlex para el que se mostrarán los servidores. name es el nombre del TapePlex.

STATus

De manera opcional, muestra el estado actual de todos los TapePlex o un único TapePlex con nombre. El estado de TapePlex indica si un TapePlex está activo, inactivo o desactivado. Para un TapePlex activo, el estado muestra el nombre del servidor actual. STATus no ejecuta el comando RESYNChronize.

Puede especificar el siguiente subparámetro:

- NAME especifica el nombre del TapePlex para el que se mostrará la información de estado. name es el nombre del TapePlex.

Ejemplo

En el siguiente ejemplo, el comando TAPEPlex define un TapePlex con el nombre DENVER (se supone que no está definido).

TAPEPLEX NAME(DENVER)

Nota:
Se debe especificar el comando SERVer para definir una ruta de comunicaciones al DENVER de TapePlex. Consulte SERVer para ver un ejemplo.

TCPip

El comando TCPip modifica o muestra la configuración actual del entorno de comunicaciones de TCP/IP. Permite dirigir solicitudes de TCP/IP a una pila de TCP/IP específica en un host de VM. El comando TCPip se puede ejecutar en cualquier momento.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando TCPip:

Figura 6-25 Sintaxis del comando TCPip

Parámetros

Como se muestra en Figura 6-25, el comando TCPip incluye los siguientes parámetros:

LIst

De manera opcional, muestra la configuración actual de TCP/IP. Si se especifica un PORTrange, LIst también muestra los números de puerto enlazados y los números de puerto superiores que indican el mayor número de subtareas de comunicación simultánea que se ejecutan una por vez.

- LIst es el valor por defecto si no se especifican parámetros en el comando TCPip.

- Se puede especificar LIst con otros parámetros. En este caso, LIst se genera después de que se han procesado el resto de los parámetros.

OFF

De manera opcional, especifica que se usan los valores por defecto del sistema para las comunicaciones de TCP/IP del cliente de VM.

tcpip parms

TCPname(name)

De manera opcional, especifica la máquina de servicio de TCP/IP en el host de VM.

name es el ID de usuario para la máquina de servicio de TCP/IP en VM para las comunicaciones de TCP/IP de destino. El valor por defecto es TCPIP.

PORTrange(nnnn-mmmm) o (OFF)

De manera opcional, especifica un rango de puertos que usará el cliente de VM para enlazar sockets en el cliente cuando se comunique en rutas de servidor remoto.

Si se define PORTrange, el cliente de VM enlaza los sockets del cliente a uno de los puertos dentro del PORTrange especificado y no usará los puertos que se encuentran fuera de PORTrange. Por lo tanto, el cliente de VM puede operar detrás del firewall que restringe la comunicación con los puertos conocidos. Se requiere un puerto único para cada subtarea simultánea que requiere servicios de comunicación para una consulta de volumen, un montaje, etc. Si no se define un PORTrange, el cliente de VM usará cualquier puerto efímero.

Solamente puede haber un PORTrange activo por vez, pero puede redefinir de forma dinámica elPORTrange, incluso si el nuevo PORTrange se superpone con el PORTrange anterior.

- nnnn-mmmm es el rango de número de puerto. Cada número de puerto puede tener un valor de 1 a 65535. El rango de número de puerto mínimo que se puede especificar es 10 (por ejemplo, 6401-6410). El rango de número de puerto máximo que se puede especificar es 1000 (por ejemplo, 6401-7400).

- OFF desactiva la lógica de PORTrange. Como resultado, se usa un puerto efímero. Este es el valor por defecto.

Tenga en cuenta lo siguiente:

- Se recomienda que, si especifica un PORTrange, especifique un PORTrange que no entre en conflicto con los puertos conocidos de TCP/IP.

- Se recomienda que, si especifica un PORTrange, especifique un PORTrange superior al número anticipado de subtareas simultáneas que solicitan los servicios de comunicación. Para la mayoría de las instalaciones, un PORTrange de 40 puertos es suficiente. Sin embargo, si se producen mensajes de SMC0128 con un código de retorno que indica ”no free port” (no hay ningún puerto libre), se requerirá un número de PORTrange mayor.

- El comando TCPip LIST se puede usar para mostrar el número de puerto superior, que indica el número mayor de subtareas de comunicación simultáneas que se pueden ejecutar por vez.

MONitor(nnnn) y, de manera opcional, mmmm

De manera opcional, especifica el intervalo de examen de subtarea de supervisión de comunicación y el intervalo de mensajes de subtarea de supervisión de comunicación.

nnnn es el intervalo de examen de supervisión en segundos. La supervisión de comunicaciones de activa cada nnnn segundos para realizar la validación de comunicaciones de la biblioteca. Especifique un valor entre 10 y 9999. El valor por defecto es 60.

Se recomienda conservar la configuración por defecto de 60 para activar el examen de supervisión cada un minuto. Un valor demasiado bajo podrá disminuir el rendimiento si existen bibliotecas activas. Un valor demasiado alto podrá retrasar una devolución al servidor principal si se especifica PREFPRIMARY(ON).

mmmm es, de manera opcional, el intervalo de examen de supervisión en número de exámenes. Los mensajes de error de comunicaciones se muestran según este intervalo. Especifique un valor entre 0 y 9999. El valor por defecto es 10.

La configuración de MONITOR(60,10) por defecto especifica un intervalo de examen de supervisión de 60 segundos y un intervalo de mensaje de supervisión de 10 exámenes. Se realiza un examen por minuto, pero los mensajes de error solamente se generan cada 10 exámenes.

El valor de mmmm 0 desactiva los mensajes de error no recuperables y que no se pueden desactivar ejecutados por la subtarea de supervisión de comunicación. Sin embargo, aún se ejecutan los errores que resultan en la desactivación de una ruta de comunicación de servidor.

PREFprimary(ON|OFF)

De manera opcional, activa o desactiva la conmutación automática de servidores principales. La conmutación automática de servidores principales requiere que esté activa la subtarea de supervisión de comunicación. Si se especifica MONITOR(OFF), la conmutación de servidores principales está desactivada.

Ejemplo

En el siguiente ejemplo, el comando TCPip direcciona las solicitudes de TCP/IP a una máquina de servicio del cliente de VM con el nombre TCPIP mediante un puerto efímero.

TCPIP TCPNAME(TCPIP) PORTRANGE(OFF)

TRace

El comando TRace activa el rastreo del cliente de VM. El archivo de rastreo del cliente de VM se escribe en el archivo TRACE FILEDEF.

Nota:
Este comando puede tener un impacto en el rendimiento del sistema. Úselo solamente según lo indique el soporte de software de StorageTek.

Sintaxis de

En la siguiente figura, se muestra la sintaxis del comando TRace:

Figura 6-26 Sintaxis del comando TRace

Parámetros

Como se muestra en la Figura 6-26, el comando TRace incluye los siguientes parámetros:

parameter

LIst

De manera opcional, muestra la configuración actual de rastreo del cliente de VM.

- LIst es el valor por defecto si no se especifican parámetros en el comando TRace.

- Se puede especificar LIst con otros parámetros. En este caso, se genera la lista después de que se han procesado el resto de los parámetros.

OFF

De manera opcional, desactiva el rastreo del cliente de VM.

ON

De manera opcional, activa el rastreo del cliente de VM.

Ejemplo

En el siguiente ejemplo, el comando TRace activa el rastreo del cliente de VM.

TRACE ON

7 Consideraciones del servidor ELS

En este capítulo, se describen las consideraciones del servidor ELS.

El cliente de VM es un cliente fino y confía en los recursos disponibles dentro de un TapePlex de servidor ELS conectado mediante TCP/IP.

Nota:
El servidor ELS debe ser versión 7.1 o posterior.

Componente de servidor HTTP del SMC

El cliente de VM especifica una dirección IP y un número de puerto de servidor definidos en la configuración de ELS del SMC. Consulte la publicación Configuración y gestión del SMC para obtener información sobre cómo configurar un servidor HTTP mediante el comando HTTP del SMC.

A continuación, se muestra un ejemplo del comando HTTP del SMC:

HTTP START PORT 4242

Subagrupaciones reutilizables

A diferencia de VM/HSC, el cliente de VM no permite la gestión de subagrupaciones reutilizables. En su lugar, las subagrupaciones reutilizables se definen y se gestionan en el servidor ELS.

Un sistema de gestión de cintas (TMS), como VM:Tape, no puede usar las solicitudes de TMI para definir subagrupaciones reutilizables. Un TMS debe usar subagrupaciones reutilizables existentes definidas en el servidor ELS. En el caso de VM:Tape, un intento de definir las subagrupaciones reutilizables falles, aunque continúa la inicialización de VM:Tape.

A continuación, se muestra un ejemplo de la inicialización de VM:Tape.

VMTHSC693I The HSC interface is connecting.
VMTHSC000I Sending to VMCLIENT: QCONFIG with wrong length
VMTHSC000I Sending to VMCLIENT: QCONFIG with right length
VMTHSC000I Sending to VMCLIENT: QDRIVES
VMTHSC999I VMCLIENT completed QDRIVES command successfully
VMTHSC000I Sending to VMCLIENT: DEFSCR 5 4
VMTHSC697E HSC server VMCLIENT ACSRQ=DEFSCR RC=16
VTCS Management Classes
Reason=00001004
VMTHSC721E HSC scratch pool initialization failed.
VMTHSC704I The interface to HSC is ready for use.

Si VM:Tape intenta usar una subagrupación reutilizable que no está definida en el servidor HSC, el cliente de VM responderá con un código de retorno y un código de motivo de TMI distintos de cero. Por ejemplo:

VMTHSC000I Sending to VMCLIENT: QSCRATCH TEST
VMTHSC697E HSC server VMCLIENT ACSRQ=QSCRATCH
RC=16 Reason=00008036
VMTHSC698R 'QSCRATCH TEST ' to VMCLIENT failed;
Enter RETRY, CANCEL, or NOARM;; Reply 1

Es responsabilidad del cliente mantener los nombres de las subagrupaciones reutilizables y los volúmenes dentro de las subagrupaciones sincronizados con el TMS de VM.

Clases de gestión de VTCS

Se recomienda usar el comando POOLmap del cliente de VM para asociar una clase de gestión de VTCS con una subagrupación reutilizable que contenga volúmenes de cinta virtuales (VTV). Si el cliente de VM recibe una solicitud de TMI que especifica un nombre de subagrupación reutilizable, el cliente de VM usará la clase de gestión de POOLmap para seleccionar y montar los VTV.

Consulte POOLmap para obtener más información acerca del comando POOLmap.

Salida de asignación de VM:Tape

Si la configuración de VM:Tape contiene varias unidades de cinta y estas unidades de cinta se definen en diferentes ACS dentro de un TapePlex, las solicitudes de montaje reutilizable requerirán la instalación de una salida de asignación de VM:Tape. Como ejemplo, la configuración puede incluir dos unidades de cinta 9840C, una definida en ACS00 y, la otra, definida en ACS01.

Para instalar una salida de asignación de VM:Tape, complete los siguientes pasos:

1. Copie el archivo de muestra SMCVMTAP en el minidisco 191 de VMTAPE con un nombre de archivo y un tipo de archivo de SMCVMTAP EXEC. Deberá modificar el ID de máquina virtual del cliente de VM en este archivo.

2. Modifique el archivo de configuración VMTAPE para activar la salida de la asignación. Por ejemplo:

EXIT ALLOCATE SMCVMTAP EXEC

3. Modifique PROFILE EXEC de VMTAPE para acceder al disco de ejecución del cliente de VM y ejecutar SMCALLOC EXEC para cargar los programas necesarios en el almacenamiento. Asegúrese de incluir estos comandos antes de invocar el inicio de VMTAPE, EXEC. Por ejemplo:

CP LINK VSMC730A 202 202 RR
ACCESS 202 J
EXEC SMCALLOC

8 Mensajes

En este capítulo, se describen los mensajes del sistema ejecutados por el cliente de VM. Estos mensajes se identifican con el prefijo SMC.

Descripciones de mensajes

SMC0000

{(CCCCCCCC)} command string

Nivel: 0

Explicación: el cliente de VM recibió un comando de entrada de una máquina virtual de operador. El ID de la máquina virtual, si está disponible, se muestra seguido de la cadena de comandos.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0001

VM Client Vn.n.n system initializing

Nivel: 0

Explicación: se ha inicializado el proceso de inicialización del sistema del cliente de VM versión n.n.n.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0002

CCCCCCCCCCCC failed; return code=XXXX, reason code=XXXX

Nivel: 0

Explicación: se completó la utilidad del sistema operativo CCCCCCCCCCCC con el código de motivo y el código de retorno distintos de cero especificados.

Acción del sistema: según el tipo de error, es posible que la inicialización o la terminación intenten continuar.

Respuesta del usuario: busque mensajes relacionados de IBM en SYSLOG y consulte la documentación adecuada de IBM para obtener la explicación.

SMC0005

Invalid command CCCCCCCC [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: el cliente de VM encontró un comando no definido, CCCCCCCC.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta o introduzca el comando corregido.

SMC0010

Unable to acquire storage for CCCCCCCC; return code=XXXX

Nivel: 0

Explicación: durante la inicialización, el subsistema del SMC no pudo adquirir suficiente almacenamiento para el módulo o el bloque de control dinámico especificado, CCCCCCCC.

Acción del sistema: el subsistema del SMC termina.

Respuesta del usuario: asegúrese de que haya suficiente espacio de almacenamiento disponible en el CSA. Consulte la documentación de IBM adecuada para obtener la explicación del código de retorno XXXX.

SMC0011

Load failed for module MMMMMMMM

Nivel: 0

Explicación: el subsistema del SMC no pudo cargar el módulo requerido MMMMMMMM.

Acción del sistema: el subsistema del SMC termina.

Respuesta del usuario: asegúrese de que el proceso de inicio del SMC tenga acceso a todas las bibliotecas distribuidas del SMC en la concatenación steplib.

SMC0013

TRACE settings:

CCCC....CCCC

Nivel: 0

Explicación: se especificó el comando TRACE con la palabra clave LIST. El mensaje SMC0013 de varias líneas muestra la configuración actual del cliente de VM.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0014

Unmatched [quote|or invalid parenthesis] detected; command ignored [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: el cliente de VM encontró un comando que contenía una cadena entre comillas sin terminar, o un paréntesis no válido o paréntesis no coincidentes.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta o introduzca el comando corregido.

SMC0015

Invalid keyword KKKKKKKK for the CCCCCCCC command[at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: el cliente de VM encontró un comando que especificó una palabra clave no válida KKKKKKKK.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta o introduzca el comando corregido.

SMC0016

Invalid value VVVVVVVV for keyword KKKKKKKK of the CCCCCCCC command [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: el cliente de VM encontró un comando que especificó una palabra clave no válida KKKKKKKK con un valor no válido VVVVVVVV.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta o introduzca el comando corregido.

SMC0017

Keyword KKKKKKKK of the CCCCCCCC command requires a value [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: el cliente de VM encontró un comando que especificó la palabra clave KKKKKKKK sin un valor correspondiente (requerido por la mayoría de las palabras clave).

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta o introduzca el comando corregido.

SMC0018

Keyword KKKKKKKK of the CCCCCCCC command is not allowed for EEEEEEEE [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: el SMC encontró un comando que especificó la palabra clave KKKKKKKK, que no es válida en el entorno operativo actual EEEEEEEE. Por ejemplo, es posible que algunas palabras clave o pares de palabra clave=valor no sean válidas, según si el usuario está ejecutando JES2 o JES3.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: asegúrese de que la palabra clave especificada sea válida en el entorno.

SMC0019

Duplicate keyword KKKKKKKK specified for the CCCCCCCC command [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: el cliente de VM encontró un comando que especificó la misma palabra clave, KKKKKKKK, más de una vez.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta o introduzca el comando corregido.

SMC0020

Keyword KKKKKKK1 of the CCCCCCCC command is mutually exclusive with keyword KKKKKKK2 [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: el cliente de VM encontró un comando CCCCCCCC que especificó varias palabras claves, dos de ellas (KKKKKKK1 y KKKKKKK2) se excluyen mutuamente.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta o introduzca el comando corregido.

SMC0022

Invalid format or missing keywords for the CCCCCCCC command [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: el cliente de VM encontró un comando CCCCCCCC que contenía demasiadas palabras clave o muy pocas palabras clave en la línea de comandos.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta o introduzca el comando corregido.

SMC0023

CCCCCCCC command successfully processed [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: el cliente de VM validó y procesó correctamente el comando CCCCCCCC.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0024

VM Client system initialization complete; RC=nn

Nivel: 0

Explicación: se completó el proceso de inicialización del sistema del cliente de VM con el código de retorno indicado y el sistema del cliente de VM ahora está listo para recibir solicitudes.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0025

No {CCCCCCCC|control block} entries to list

Nivel: 0

Explicación: se especificó el comando CCCCCCCC con la palabra clave LIST. Sin embargo, no se encontraron entradas en la cola del cliente de VM para el comando especificado.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0027

Keyword KKKKKKK1 of the CCCCCCCC command requires keyword KKKKKKK2 [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: el cliente de VM encontró un comando que especificó la palabra clave KKKKKKK1, pero no la palabra clave de requisito conjunto requerida, KKKKKKK2.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta o introduzca el comando corregido.

SMC0029

CCCCCCCC command processing error; [matching entry not found|command line truncated; will be ignored|parameter truncated; command ignored] [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: se encontró un error durante el procesamiento del comando CCCCCCCC.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta e introduzca el comando corregido.

SMC0034

VM Client startup parameter PPPPPPPP must have a value

Nivel: 0

Explicación: durante la inicialización, el programa de inicialización del subsistema del cliente de VM encontró un parámetro de ejecución válido, pero no se especificó como un par de palabra clave y valor, y se requiere un valor.

Acción del sistema: el sistema del cliente de VM termina.

Respuesta del usuario: corrija el parámetro exec de la inicialización del sistema del cliente de VM para especificar los parámetros de ejecución correcta.

SMC0035

Error processing VM Client startup parameter PPPPPPPP; CCCCCCCCCCCC

Nivel: 0

Explicación: durante la inicialización, el programa de inicialización del sistema del cliente de VM encontró un error en la cadena de parámetros de ejecución. La cadena CCCCCCCCCCCC indica el tipo de error que se encontró.

Acción del sistema: el sistema del cliente de VM termina.

Respuesta del usuario: corrija el parámetro startup exec de la inicialización del sistema del cliente de VM para corregir la cadena de parámetros de ejecución.

SMC0036

VM Client startup parameter PPPPPPPP successfully processed

Nivel: 0

Explicación: durante la inicialización del cliente de VM, se verificó y se procesó correctamente el parámetro de ejecución PPPPPPPP.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0037

Invalid VM Client startup parameters; system terminating

Nivel: 0

Explicación: durante la inicialización, el programa de inicialización del sistema del cliente de VM detectó un error durante el procesamiento de la cadena de parámetros de ejecución.

Acción del sistema: el sistema del cliente de VM termina.

Respuesta del usuario: busque mensajes relacionados del cliente de VM en el log de la máquina de servicio. Los mensajes asociados pueden ser, entre otros, SMC0033 SMC0034 o SMC0035.

SMC0041

{Command|Comment} beginning at line nnnn of {SMCCMDS|SMCPARMS} is unterminated

Nivel: 0

Explicación: un comando o comentario que comienza en la línea nnnn de un archivo de comando de entrada que finaliza con un carácter de continuación (+), pero no se encontró ninguna continuación.

Acción del sistema: el procesamiento continúa. El comando que contiene la cadena sin terminar se ignora.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta.

SMC0053

**** VM Client U1099 ABEND AT CCCCCCCCn ****

Nivel: 0

Explicación: una tarea del cliente de VM tuvo una finalización anormal en el módulo CCCCCCCC con el número de secuencia anormal n.

Acción del sistema: si la finalización anormal se produce en el procesamiento de una solicitud de TMI, no se procesará la solicitud.

Respuesta del usuario: guarde los logs y los volcados asociados, y póngase en contacto con el soporte de software de StorageTek.

SMC0056

nn bytes:

AAAAAAAA +0000| XX..XX XX..XX XX..XX XX..XX | CC..CC |

Nivel: 0

Explicación: se ejecutó un comando LIst del cliente de VM. El mensaje SMC0056 de varias líneas muestra los nn bytes de almacenamiento en el hexadecimal convertido (XX.XX) y el formato de caracteres (CC.CC), cada línea muestra los siguientes 16 bytes de almacenamiento, comenzando por la dirección hexadecimal AAAAAAAA.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0057

No {SMCPARMS|SMCCMDS} DDNAME statement found

Nivel: 0

Explicación: durante la inicialización del cliente de VM, el SMCPARMS DD o SMCCMDS DD especificados no estaban presentes en el parámetro startup exec del cliente de VM.

Acción del sistema: la inicialización continúa.

Respuesta del usuario: ninguna.

SMC0058

Error opening {DDNAME {SMCPARMS|SMCCMDS}|DSNAME DDDDDDDD}

Nivel: 0

Explicación: el cliente de VM encontró un comando READ, pero no se pudo abrir el DDNAME o el DSNAME especificado.

Acción del sistema: se ignora el comando READ.

Respuesta del usuario: busque mensajes relacionados de IBM en log y consulte la documentación adecuada de IBM para obtener más información.

SMC0060

I/O error reading {DDNAME {SMCPARMS|SMCCMDS}|DSNAME DDDDDDDD}

Nivel: 0

Explicación: el cliente de VM recibió un error de E/S mientras intentaba leer el juego de datos de SMCPARMS o SMCCMDS especificado en el parámetro startup exec del cliente de VM o en el juego de datos especificado en un comando READ.

Acción del sistema: el juego de datos indicado no se procesó.

Respuesta del usuario: especifique el nombre correcto del juego de datos.

SMC0061

Command beginning at line nnnn of {SMCCMDS|SMCPARMS} is too long; input ignored

Nivel: 0

Explicación: el cliente de VM encontró un comando de varias líneas que comienza en la línea nnnn del archivo especificado. Este comando supera los 1024 caracteres de longitud.

Acción del sistema: el procesamiento continúa. Se ignoran completamente todas las líneas.

Respuesta del usuario: asegúrese de que la sintaxis del juego de datos del comando sea correcta.

SMC0062

Command CCCCCCCC [with parameter PPPPPPPP] is not allowed [{from console|at line nnnn of SMCCMDS|SMCPARMS}]

Nivel: 0

Explicación: el cliente de VM encontró un comando o un parámetro de comando que no se admite para el origen del comando indicado.

Acción del sistema: se ignora el comando.

Respuesta del usuario: ejecute el comando desde un origen de comando válido.

SMC0063

MSGDEF settings:

CCCC....CCCC

Nivel: 0

Explicación: se ejecutó el comando MSGDEF con la palabra clave LIST. El mensaje SMC0063 de varias líneas muestra la configuración actual del cliente de VM.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0084

MMM DD YYYY HH:MM:SS UUUUUUUU active on hostid VVVVVVVV

Nivel: 0

Explicación: la fecha (MMMM DD YYYY), la hora (HH:MM:SS), el ID de usuario de la máquina de servicio (UUUUUUUU) y el ID de host (VVVVVVVV) se muestran una vez al día a medianoche durante la inicialización del cliente de VM.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0086

SMC system tasks:

A(PCE) Thread Use C-S Userid Last
-------- ------ ------ --- -------- ------------
AAAAAAAA TTTTTT UUUUUU C-S UUUUUUUU TTTTTTTT

Nivel: 0

Explicación: se ejecutó un comando LIst TASKs del cliente de VM. El mensaje SMC0086 de varias líneas muestra la dirección de SMCPCE, el ID de thread, el recuento de uso y la información de estado actual de todas las tareas del cliente de VM.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0088

Unable to [acquire/release] resource CCCCCCCC; attempt by VVVVVVVV XXXXXXXX1 owned by XXXXXXXX2

Nivel: 0

Explicación: no se pudo adquirir o liberar correctamente un recurso compartido del cliente de VM. Una tarea de la máquina virtual JJJJJJJJ está intentando actualmente adquirir o liberar el recurso, pero no puede porque otra tarea retiene el recurso.

Acción del sistema: es posible que la solicitud de la máquina virtual VVVVVVVV no se procese correctamente.

Respuesta del usuario: póngase en contacto con el soporte de software de StorageTek.

SMC0093

TCPIP SETTINGS:

CCCC....CCCC
TCPIP TCPNAME=CCCCCCCC

Nivel: 0

Explicación: se ejecutó un comando LIst de TCPIP. El mensaje SMC0093 de varias líneas muestra la configuración actual del sistema del cliente de VM.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0105

Keyword KKKKKKKK of the CCCCCCCC command is required

Nivel: 0

Explicación: se ejecutó el comando CCCCCCCC sin la palabra clave requerida KKKKKKKK.

Acción del sistema: el comando no se procesa.

Respuesta del usuario: vuelva a ejecutar el comando con la palabra clave requerida.

SMC0113

SERVER=SSSSSSSS CCCCCCCC

Status={active|never active|inactive|disabled}
Errors=nnnn
Messages=nnnn
Retries=nnnn

Nivel: 0

Explicación: se ejecutó el comando SERVer con la palabra clave LIST. El mensaje SMC0113 de varias líneas muestra la configuración del servidor y el estado de cada servidor definido en el cliente de VM. Consulte el comando SERVer para obtener las descripciones de parámetros.

- STATUS indica el estado del servidor.

- Errors indica el número total de errores en este servidor.

- Messages indica el número de mensajes lógicos (solicitudes de consulta de volúmenes, montajes y desmontajes) en esta ruta de servidor.

- Retries indica cuántos reintentos de mensajes se han realizado.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0116

Cannot find TAPEPLEX PPPPPPPP for SERVER SSSSSSSS [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: se ejecutó el comando SERVer con un nombre de TapePlex que no se definió anteriormente.

Acción del sistema: no se agregó ni se actualizó el servidor.

Respuesta del usuario: especifique un comando TAPEPlex para definir el TapePlex y, a continuación, especifique el comando SERVer.

SMC0117

Cannot change TAPEPLEX name for existing SERVER SSSSSSSS [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: se ejecutó el comando SERVer con el NAME de un servidor existente y el nombre de un TapePlex, pero el nombre del TapePlex del servidor existente no coincide con el nombre del TapePlex del comando nuevo.

Acción del sistema: se rechaza el comando.

Respuesta del usuario: omita el nombre del Tapeplex, cambie el nombre del para que coincida con el servidor existente o cambie el nombre del servidor para agregar un nuevo servidor al Tapeplex especificado.

SMC0119

SERVER CCCCCCCC now disabled

Nivel: 0

Explicación: el cliente de VM detectó errores de TCP/IP en el exceso del recuento de FAIL. Consulte los mensajes SMC0128/SMC0129 que aparecen más adelante para conocer el motivo de la desactivación.

Acción del sistema: ninguna. Si no hay rutas de servidor adicionales definidas para la biblioteca asociada, ya no se podrá acceder al hardware de la biblioteca.

Respuesta del usuario: corrija el problema con la red TCP/IP, el servidor o el sistema operativo del host y vuelva a activar SERVer.

SMC0123

Drive range mismatch between CLIENT(XXXX1-XXXX2) and SERVER (XXXX3-XXXX4)

Nivel: 0

Explicación: se ejecutó el comando DRIVemap. Uno de los rangos de CLient especificados no coincidía con el formato del rango de SErver correspondiente.

Acción del sistema: ninguna.

Respuesta del usuario: vuelva a ejecutar el comando, asegúrese de que el parámetro CLient y el parámetro SErver tengan formatos y número de unidades correspondientes.

SMC0128

TapePlex error:

{Fatal comm error detected|
Initialization error number nn or {nn|unlimited}|
Comm error number nn of {nn|unlimited}
Comm error limit exceeded}
USER=UUUUUUUU TASK=XXXXXXXXXX {MSG=XXXXXXXX}
TAPEPLEX=TTTTTTTT SERVER=SSSSSSSS REQUEST=FFFF
{Client {IP=NNN.NNN.NNN.NNN} socket=NN port={nnnn|ANY}}
{Server IP=NNNN.NNNN.NNNN.NNNN port=nnnn}
{Bytes out=nnnn in=nnnn}
{Error=EEEE....EEEE}
{Reason=RRRR....RRRR}
{Response from STK HTTP server follows: HHHH...HHHH}
VM Client comm RC=nnnn

Nivel: 0

Explicación: el cliente de VM encontró un error de interfaz o de comunicación cuando intentaba comunicarse con un sistema TapePlex. El mensaje SMC0128 de varias líneas muestra primero el ID de usuario de la VM, el tipo de transacción y el nombre de TapePlex asociado con el error, seguido por el error de comunicación y las cadenas de motivos.

Algunos ejemplos de las cadenas de motivos son:

- Errores específicos de funciones de TCP/IP (conectar, enviar, recibir, etc.)

- Errores de datos (respuesta de datos incompleta o no válida)

- Errores de funciones del servidor del HSC

- Errores del servidor HTTP del SMC

Algunos errores de comunicación pueden causar una visualización de la respuesta completa del servidor HTTP, de la siguiente manera:

HTTP 1.0 401 Unauthorized

- Si el mensaje indica que se excedió Comm error limit (nnn), entonces el mensaje SMC0128 estará seguido por un mensaje SMC0119 y el cliente de VM desactivará la ruta de servidor.

- Si el mensaje indica un error de inicialización, entonces el error se produjo antes de cualquier comunicación exitosa con la ruta del servidor mencionada. Dichos errores no se cuentan en el recuento de errores acumulativos en la ruta del servidor y no causarán que el cliente de VM desactive automáticamente el servidor designado. Además, los mensajes de errores de inicialización no se generarán para todas las solicitudes, únicamente se generarán en intervalos de 5 minutos hasta que se active correctamente la ruta.

Acción del sistema: es posible que el cliente de VM no procese el evento de asignación o montaje.

Respuesta del usuario: use el motivo de error especificado para identificar la causa del problema.

SMC0129

{ERROR|WARNING}: No cartridge transport(s) for XXXX1- [XXXX2] for {UNITATTR|DRIVEMAP} {ADDRESS|CLIENT}

Nivel: 0

Explicación: se ejecutó el comando UNITATTR o DRIVEMAP mediante la especificación de un dispositivo XXXX1 o un rango XXXX1-XXXX2. Ninguno de los dispositivos especificados es un dispositivo de transporte de cartuchos definido por MVS.

Acción del sistema:

- Si el mensaje indica un ERROR, no se procesa el comando.

- Si el mensaje indica WARNING, el cliente de VM almacena el valor y puede usarlo para traducir direcciones para dispositivos RTD de definidos por MVS.

Respuesta del usuario: revise los dispositivos especificados en el comando y, si son incorrectos, vuelva a ejecutar el comando.

SMC0133

TAPEPLEX=PPPPPPPP

CCCC....CCCC
Status={disabled|active|inactive|never active}
Requests=nnnn
[SERVER=SSSSSSSS
Status={disabled|active|inactive|never active}]

Nivel: 0

Explicación: se ejecutó el comando TAPEPlex con la palabra clave LIST. El mensaje SMC0133 de varias líneas muestra los parámetros de configuración y el estado de cada TapePlex definido por el cliente de VM. De manera opcional, si se especificó la palabra calve SERVerlist, también se muestra el estado de servidor de todos los servidores asociados con este sistema TapePlex.

- El estado de TapePlex indica el estado del sistema TapePlex.

- disabled indica que un comando del operador desactivó el TapePlex.

- active indica que la última comunicación con este TapePlex se realizó correctamente.

- inactive indica que una ruta de comunicación con este TapePlex ya no está activa, aunque uno estuvo activa anteriormente.

- never active indica que se estableció correctamente una ruta de comunicación con este TapePlex.

- Requests indica el número total de solicitudes (configuración, consulta de volúmenes, montaje, desmontaje e intercambio) que se dirigieron al TapePlex especificado.

Si se especificó la palabra clave SERVER, también se mostrarán todas las rutas de servidor definidas para este TapePlex, junto con el estado.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0135

Mount/dismount message from TAPEPLEX=PPPPPPPP SERVER=SSSSSSSS

Nivel: 0

Explicación: está activa la opción ECHOMNTERR(ON). Se realizó un montaje o desmontaje en un sistema TapePlex del HSC, pero no se completó correctamente. El mensaje SMC0135 indica el nombre del sistema TapePlex y el nombre del servidor donde se solicitó el montaje o el desmontaje. El mensaje SMC0136 refleja el mensaje de montaje o desmontaje de servidor del HSC en el cliente del VM.

Nota:
Los mensajes SMC0135 y SMC0136 se ejecutan para todos los errores de montaje y desmontaje si el nivel de montaje es 12 o mayor, independientemente de la configuración de ECHOMNTERR y para todos los mensajes de montaje y desmontaje del HSC si el nivel de montaje es 16 o superior.

Acción del sistema: ninguna.

Respuesta del usuario: corrija el problema que se indica en el mensaje de montaje o desmontaje del HSC.

SMC0136

HSC mount or dismount message

Nivel: 4

Explicación: está activa la opción ECHOMNTERR(ON). Se realizó un montaje o desmontaje en un sistema TapePlex del HSC, pero no se completó correctamente. El mensaje SMC0135 indica el nombre del sistema TapePlex y el nombre del servidor donde se solicitó el montaje o el desmontaje. El mensaje SMC0136 refleja el mensaje de montaje o desmontaje de servidor del HSC en el cliente del VM.

Acción del sistema: ninguna.

Respuesta del usuario: corrija el problema que se indica en el mensaje de montaje o desmontaje del HSC.

SMC0138

XML {input|output} parse error RC=nnn; transaction=TTTTTTTT {TAPEPLEX|STORMNGR}=PPPPPPPP

Nivel: 0

Explicación: el SMC encontró un error de análisis de XML. Los errores de entrada de XML se generan cuando no se puede analizar la transacción de entrada de XML.

Los errores de salida de XML se producen cuando los datos de respuesta de la transacción no se pueden convertir a XML.

Acción del sistema: según el tipo de error y las características del servidor, es posible que el SMC no procese el evento de asignación o montaje.

Respuesta del usuario: póngase en contacto con el soporte de software de StorageTek.

SMC0160

Invalid range XXXX1-XXXX2 for keyword ADDRESS of the UNITATTR command

Nivel: 0

Explicación: se ejecutó un comando UNITATTR que especifica un rango de dispositivo XXXX1-XXXX2, donde XXXX1 es mayor que XXXX2.

Acción del sistema: el comando UNITATTR no procesa este rango de dispositivo.

Respuesta del usuario: vuelva a ejecutar el comando mediante la especificación de un rango válido.

SMC0161

Restoring all default settings for the CCC...CCC command

Nivel: 0

Explicación: se ejecutó el comando CCC...CCC con el parámetro OFF. Se restauraron todos los valores de CCC...CCC para el sistema del cliente de VM.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0162

CCC...CCC object successfully {added|updated|deleted}

Nivel: 0

Explicación: se procesó correctamente el comando CCC...CCC.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0163

DRIVEMAP settings:

CLIENT=XXXX1{-XXXX2} SERVER=XXXX3{-XXXX4}

Nivel: 0

Explicación: se ejecutó el comando DRIVEMAP con la palabra clave LIST. El mensaje de varias líneas SMC0163 muestra los DRIVEMAP actualmente activos. Se genera una línea para cada rango de cliente/servidor.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0164

CLIENT range XXXX1{-XXXX2} not found for the OFF keyword of the DRIVEMAP command

Nivel: 0

Explicación: se ejecutó el comando DRIVEMAP con el parámetro OFF y el parámetro CLIENT. No se encontró ningún rango de DRIVEMAP que coincidiera con el parámetro CLIENT.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0165

Keyword {CLIENT/SERVER} range XXXX1{-XXXX2} overlaps with previous DRIVEMAP entry

Nivel: 0

Explicación: se ejecutó un comando DRIVEMAP que contiene un rango de cliente o servidor que se superpone con un rango especificado en un comando DRIVEMAP ejecutado anteriormente.

Acción del sistema: el comando DRIVEMAP no se procesa.

Respuesta del usuario: ejecute el comando DRIVEMAP LIST para ver la lista de rangos de DRIVEMAP actualmente activos. Corrija el comando DRIVEMAP para especificar un nuevo rango. O bien, use el comando DRIVEMAP CLIENT(XXXX1-XXXX2) OFF para desactivar el rango que se superpone actualmente y vuelva a especificar el comando con rangos únicos.

SMC0166

Excessive READ depth at line nn of DSN DDDDDDDD

Nivel: 0

Explicación: se ejecutó el comando READ desde un archivo. Sin embargo, hay muchos archivos de comando abiertos y se ha superado la profundidad del comando de lectura. La profundidad del comando Read se define como el número de archivos que se pueden abrir simultáneamente debido a comandos Read incrustados.

Acción del sistema: el comando READ no se procesa.

Respuesta del usuario: reestructure los archivos de comando para reducir la profundidad del comando READ y asegúrese de que los archivos a los que se hace referencia no contengan un bucle recursivo.

SMC0167

CCCCCCC summary:

TAPEPLEX PPPPPPPP is {disabled|inactive|active on
server SSSSSSSS}
{All TAPEPLEX(s) active|
n of n TAPE TAPEPLEX(s) active|
WARNING: All TAPEPLEX(s) inactive|
WARNING: No TAPEPLEX(s) defined|
WARNING: No TAPEPLEX(s) enabled}

Nivel: 0

Explicación: se ejecutó el comando CCCCCCCC y se realizó una resincronización del sistema TapePlex. Cada sistema TapePlex está representado por una línea en la WTO de varias líneas que muestra el estado.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0172

Specified TAPEPLEX PPPPPPPP not {defined|HSC|active|enabled|valid for UUI}

Nivel: 0

Explicación: se ejecutó un comando del cliente de VM que especifica TAPEPLEX PPPPPPPP. Sin embargo, no se puede completar el comando porque el TAPEPLEX no está definido en el cliente de VM o no es elegible.

Acción del sistema: el comando no se procesa.

Respuesta del usuario: introduzca el nombre de un sistema TAPEPLEX válido o corrija el estado del sistema TAPEPLEX y vuelva a ejecutar el comando.

SMC0173

Response from {TAPEPLEX|STORMNGR} PPPPPPPP:

CCCC....CCCC
Response RC=nn

Nivel: 0

Explicación: se ejecutó el comando Route del cliente de VM que especificó TAPEPLEX o STORMNGR PPPPPPPP. El mensaje SMC0173 muestra el nombre de TAPEPLEX o STORMNGR, seguido por la respuesta, terminado por un mensaje SMC0173 que muestra el código de retorno del comando.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0175

Communication initialized on TAPEPLEX=name SERVER=name

Nivel: 0

Explicación: el cliente de VM se comunicó correctamente con el sistema TapePlex especificado la primera vez.

Acción del sistema: el procesamiento continúa.

Respuesta del usuario: ninguna.

SMC0176

No active TAPEPLEX(s) for DISPLAY command

Nivel: 0

Explicación: se introdujo un comando DISPLAY del cliente de VM. Sin embargo, el cliente de VM no puede establecer comunicación con ningún sistema TapePlex.

Acción del sistema: si se introdujo el comando DISPLAY (o QUERY) VOLUME, el comando termina, ya que no hay sistemas TapePlex para dirigir la solicitud. Si se introdujo el comando DISPLAY (o QUERY) DRIVE, el comando continuará aunque la información de la unidad no refleje la propiedad de TapePlex.

Respuesta del usuario: ninguna.

SMC0177

VM Client {DISPLAY|QUERY} VOLUME

Volser TapePlex Location Media Rectech Scr Volume Data
------ -------- -------- -------- -------- --- ----------
VVVVVV PPPPPPPP {AA:LL}  MMMMMMMM RRRRRRRR SSS DDDDDDDD

Nivel: 0

Explicación: se introdujo un comando DISPLAY (o QUERY) VOLUME del cliente de VM. Los mensajes SMC0177 muestran los volser que coinciden con la solicitud. El Rectech que se muestra para un volumen refleja una combinación del tipo de medio de volumen, configuración de VOLATTR (si corresponde) y datos del volumen, como densidad. Por ejemplo, un volumen que muestra Rectech de STK1RC puede tener un servidor VOLATTR que especifica un RECTECH de STK1RC o puede estar montado como reutilizable en una unidad 9840C. El estado reutilizable se mostrará como "Yes" o ""No". Los datos de volumen de un volumen reflejan las características conocidas de densidad y cifrado del volumen, tal como se almacenan en el CDS del HSC. Los datos de volumen de DEN=1 hastaDEN=3 significan densidad baja, alta y más alta, respectivamente.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0178

VM Client {DISPLAY|QUERY} DRIVE

Addr TapePlex Location        Model    Serv VM Client Status
------ -------- ------------- -------- ---- ----------------
AAAA PPPPPPPP {AA:LL:PP:DD}   MMMMMMMM SSSS CCCCCCCC

O bien:

Addr TapePlex Location        Model    Serv S Serial Number
------ -------- ------------- -------- ---- ----------------
AAAA PPPPPPPP {AA:LL:PP:DD}   MMMMMMMM SSSS Z NNNNNNNNNNNN

Nivel: 0

Explicación: se introdujo un comando DISPLAY (o QUERY) DRIVE del cliente de VM. Los mensajes SMC0178 muestran las unidades que coinciden con la solicitud. La dirección AAAA refleja la dirección de la unidad tal como la conoce el CP. El cliente de VM intentará hacer coincidir el ID de equivalencia de VM de la unidad (EQID) con el número de serie devuelto en la solicitud de configuración de XAPI. Si esto no se hace correctamente, se usarán las entradas de DRIVEMAP para asignar la dirección del servidor (SSSS) a la dirección del cliente (AAAA).

La opción DISPLAY DRIVE IDentity sustituye el campo "VM Client Status" con el campo "S Serial Number", donde:

- Z identifica el origen o el estado del número de serie.

- NNNNNNNNNNNN: número de serie de unidad o en blanco si no está disponible.

- M: indica el número de serie de EQID que coincide con la configuración de XAPI.

- NNNNNNNNNNNN: número de serie de unidad o en blanco si no está disponible.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0179

{TAPEPLEX|ESOTERIC} VVVVVVVV not defined for CCCCCCCC

Nivel: 0

Explicación: se introdujo el comando CCCCCCCC que especifica el sistema TAPEPLEX o ESOTERIC VVVVVVVV. Sin embargo, VVVVVVVV no está definido en el SMC o en MVS.

Acción del sistema: ninguna.

Respuesta del usuario: corrija el comando especificado y vuelva a introducirlo.

SMC0189

CCCCCCCC entry EEEEEEE not found for {list|update|delete}

Nivel: 0

Explicación: se introdujo un comando CCCCCCCC que especificaba que se debía mostrar, suprimir o actualizar la entrada EEEEEEEE. Sin embargo, no se encontró ninguna entrada que coincidiera con EEEEEEE.

Acción del sistema: ninguna.

Respuesta del usuario: ejecute el comando CCCCCCCC con la opción LIST para mostrar todas las entradas CCCCCCCC. A continuación, vuelva a ejecutar el comando mediante la especificación del nombre de entrada correcto.

SMC0190

CCCCCCCC OOOOOOOO set to {ON|OFF|XXXXXXXX}

Nivel: 0

Explicación: se introdujo el comando CCCCCCCC que especifica que la opción OOOOOOOO se debe configurar en ON, OFF o el valor especificado XXXXXXXX. Si se especificaron varias opciones en un único comando CCCCCCCC, se ejecutarán varios mensajes SMC0190, uno para cada opción especificada.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

Nota:
Los mensajes SMC0190 se muestran solamente si se especifica MSGDef VERBose(ON).

SMC0191

CCCCCCCC OOOOOOOO set to {ON|OFF|XXXXXXXX} for entry EEEEEEEE

Nivel: 0

Explicación: se introdujo el comando CCCCCCCC que especifica que la opción OOOOOOOO se configurará en ON, OFF o en el valor especificado XXXXXXXX para la entrada EEEEEEEE de CCCCCCCC. Si se especificaron varias opciones en un único comando CCCCCCCC, se ejecutarán varios mensajes SMC0191, uno para cada opción especificada.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

Nota:
Los mensajes SMC0191 se muestran solamente si se especifica MSGDef VERBose(ON).

SMC0195

READ processing started for {SMCPARMS|SMCCMDS|data set name}

Nivel: 0

Explicación: el cliente de VM ha iniciado los comandos de procesamiento en el archivo designado.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0196

READ processing complete; RC=nn from {SMCPARMS|SMCCMDS|data set name}

Nivel: 0

Explicación: el cliente de VM ha completado los comandos de procesamiento en el archivo designado. El código de retorno más alto para cualquier comando es nn.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

Nota:
Los mensajes de SMC0196 se muestran solamente si se especifica el cliente de VM MSGDef VERBose(ON).

SMC0203

COMMTEST:

USER=UUUUUUUU TASK=XXXXXXXXXXXXXXXX {MSG=XXXXXXXX}
TAPEPLEX=LLLLLLLL SERVER=SSSSSSSS REQUEST=FFFF
Client {IP=NNN.NNN.NNN.NNN} socket=NN port={nnnn|ANY}
Server IP=NNNN.NNNN.NNNN.NNNN port=nnnn
Bytes out=nnnn in=nnnn
Error=EEEE....EEEE
Reason=RRRR....RRRR
{Response from STK HTTP server follows: HHHH...HHHH}
Current LIBPATH status=
{active|inactive|never active|disabled}
VM Client comm RC=nnnn elapsed time=nn.nn

Nivel: 0

Explicación: se introdujo el comando COMMtest. Se muestra el mensaje SMC0203 para cada ruta de comunicación que se intenta.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0204

No eligible COMMPATH(s) found

Nivel: 0

Explicación: se introdujo el comando COMMtest, pero el TAPEPlex especificado, SERVer, y los parámetros de estado no mostraron ninguna ruta de comunicación elegible seleccionada para la prueba.

Acción del sistema: ninguna.

Respuesta del usuario: corrija y vuelva a ejecutar el comando COMMtest.

SMC0205

Disabling bind to PORTRANGE nnnn-nnnn; any ephemeral port will be used

Nivel: 0

Explicación: se introdujo el comando TCPip PORTrange (OFF). Los sockets ya no estarán enlazados al rango de puerto fino de nnnn-nnnn, pero se usará un puerto efímero.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0206

No PORTRANGE currently defined

Nivel: 0

Explicación: se introdujo un comando TCPip PORTrange (OFF) pero actualmente no hay ningún PORTrange activo especificado para desactivar.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0207

Specified SERVER SSSSSSSS not {found|defined for TAPEPLEX=TTTTTTTT}

Nivel: 0

Explicación: se introdujo un comando COMMtest que especificó un sistema TapePlex específico y un servidor. Sin embargo, el servidor no está definido en el cliente de VM o no está definido para el sistema TapePlex especificado.

Acción del sistema: ninguna.

Respuesta del usuario: corrija y vuelva a ejecutar el comando COMMtest.

SMC0226

Path switch from server=SSSSSSSS to PPPPPPPP for TAPEPLEX=TTTTTTTT

Nivel: 0

Explicación: el cliente de VM cambió automáticamente la ruta de comunicación desde el servidor secundario SSSSSSSS al servidor primario PPPPPPPP para TAPEPLEX TTTTTTTT.

Acción del sistema: el procesamiento continúa.

Respuesta del usuario: ninguna.

SMC0227

Keyword KKKKKKKK of the CCCCCCCC command ignored; RRRRRRRR

Nivel: 0

Explicación: el comando CCCCCCCC especificó una palabra clave que ya no es aceptable. Es posible que la palabra clave KKKKKKKK sea obsoleta en la versión actual del producto o es posible que sea inaceptable en el entorno de procesamiento actual.

Acción del sistema: se descarta la palabra clave KKKKKKKK y los valores asociados, pero aún se procesa el resto del comando.

Respuesta del usuario: si la palabra clave es obsoleta en la versión actual, suprima la palabra clave del comando, ya que se puede marcar como error en las versiones subsiguientes, lo que invalida el comando completo.

SMC0228

Copyright nnnn, nnnn, Oracle and/or its affiliates. All rights reserved.

Nivel: 0

Explicación: se está inicializando el sistema del cliente de VM.

Acción del sistema: el procesamiento continúa.

Respuesta del usuario: ninguna.

SMC0232

Warning: No TAPEPLEX command processed

Nivel: 0

Explicación: el sistema del cliente de VM completó la inicialización, pero no se encontraron comandos de TAPEPLEX en SMCPARMS ni en el juego de datos de SMCCMDS.

Acción del sistema: el procesamiento continúa.

Respuesta del usuario: introduzca los comandos TAPEPLEX and SERVER.

SMC0236

CCC...CCC command RC=XX exceeds MAXRC=NN at startup

Nivel: 0

Explicación: se inició el cliente de VM con el parámetro de inicio MAXRC y, durante la inicialización del cliente de VM, el comando CCC...CCC devolvió un código de finalización que excedió la especificación de MAXRC.

Acción del sistema: el procesamiento continúa para el resto de los comandos especificados en los juegos de datos SMCPARMS o SMCCMDS. Sin embargo, la inicialización del sistema del cliente de VM terminará con el mensaje SMC0237 cuando finalice el procesamiento de SMCPARMS o SMCCMDS.

Respuesta del usuario: corrija el comando CCC...CCC especificado y reinicie el cliente de VM.

Nota:
Se generarán varios mensajes SMC0236 en el inicio, ya que todos los comandos del cliente de VM de los juegos de datos SMCPARMS y SMCCMDS se procesan en el inicio, independientemente de los mensajes anteriores de SMC0236.

SMC0237

VM Client terminating due to MAXRC=nn exceeded at startup

Nivel: 0

Explicación: se inició el cliente de VM con el parámetro de inicio MAXRC y, durante la inicialización del cliente de VM, se ejecutó un mensaje de SMC0236 que indica que el comando del cliente de VM del juego de datos SMCPARMS o SMCCMDS devolvió un código de finalización que excedió la especificación de MAXRC.

Acción del sistema: el cliente de VM termina.

Respuesta del usuario: revise el log del cliente de VM para los mensajes SMC0236 que indican los comandos con error, corrija los comandos indicados y reinicie el cliente de VM.

SMC0242

Cannot add STORMNGR CCC...CCC before TAPEPLEX(es)

Nivel: 0

Explicación: los comandos STORMNGR se deben introducir después de los comandos TAPEPLEX.

Acción del sistema: el procesamiento continúa.

Respuesta del usuario: introduzca los comandos TAPEPLEX antes de los comandos STORMNGR.

SMC0243

CCCCCCCC command specifies {TAPEPLEX|STORMNGR} NNNNNNNN; but NNNNNNNN is a {STORMNGR|TAPEPLEX} [at line nnnn of {SMCCMDS|SMCPARMS}]

Nivel: 0

Explicación: se introdujo el comando CCCCCCCC y se especificó el sistema TAPEPLEX o StorageTek Storage Manager designado. Sin embargo, NNNNNNNN no corresponde al tipo de entidad descrita.

Acción del sistema: el comando no se procesa.

Respuesta del usuario: cambie el tipo de entidad de TAPEPLEX a STORMNGR o viceversa, y vuelva a ejecutar el comando.

SMC0244

METADATA command not supported for {non-UUI origin|non-XML responses|command CCCC}

Nivel: 0

Explicación: se procesó el comando METADATA, pero no es válido por uno de los siguientes motivos:

- non-UUI origin
Indica que el comando se recibió desde una consola de operador o desde los juegos de datos SMCPARMS o SMCCMDS. Únicamente se permite el comando METADATA desde la interfaz de la UUI; ya sea desde las utilidades SMCUUUI o SMCUSIM, o desde la interfaz de programación de la UUI.

- non-XML responses
Indica que el comando METADATA se originó de la interfaz de la UUI, pero que no se solicitaron respuestas de XML. METADATA únicamente es válido como respuesta de XML.

- comando CCCC
Indica que el comando CCCC no genera un salida XML, de modo que los metadatos no están disponibles.

Acción del sistema: ninguna.

Respuesta del usuario: corrija el comando METADATA.

SMC0245

Code nnnn (X'xxxx'): sssssssssss

Nivel: 0

Explicación: se procesó el comando Display RC para el código de motivo especificado nnnn o para el código de motivo hexadecimal xxxx. Se muestra el motivo correspondiente. Si se especificó la opción DETAIL, también se mostrará la explicación del código de motivo.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0260

TAPEPLEX|STORMNGR CCCCCCCC commpath PPPPPPPP inactive; RC=RRRR, EEEEEEEEEEEE

Nivel: 0

Explicación: el SMC no se puede comunicar con el sistema TAPEPLEX o STORMNGR mediante la ruta de comunicación PPPPPPPP, donde PPPPPPPP es el nombre del servidor o (local). El valor RRRR es el código de retorno decimal, con una explicación traducida EEEEEEEEEEEE.

Acción del sistema: el mensaje se ejecuta para cada ruta de comunicación local definida o SERVER, y no se desplaza si el SMC no se puede comunicar con el sistema TAPEPLEX.

Respuesta del usuario: corrija el error informado de, al menos, una ruta de comunicación.

SMC0261

TAPEPLEX|STORMNGR CCCCCCCC inactive; no available communication paths

Nivel: 0

Explicación: el CCCCCCCC de TAPEPLEX o STORMNGR no tiene rutas de comunicación definidas o todas las rutas tienen estado desactivado.

Acción del sistema: no se intentó ninguna comunicación al sistema TAPEPLEX o STORMNGR.

Respuesta del usuario: agregue una ruta de comunicación o active una ruta local existente o SERVER.

SMC0268

Unrecognized XML tag=TTTTTTTT for command=CCCCCCCC

Nivel: 0

Explicación: una solicitud de entrada en formato XML contenía una etiqueta no reconocida como válida para el comando.

Este mensaje se puede generar cuando el nivel de software actual no admite una etiqueta que era válida en un nivel anterior o no ha sido actualizada para admitir una nueva etiqueta.

Acción del sistema: se ignora el parámetro.

Respuesta del usuario: verifique que se especifique el comando correctamente.

SMC0269

Value=VVVVVVVV is invalid type for keyword or tag=KKKKKKKK in command=CCCCCCCC [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: un comando de entrada contenía un valor para una palabra clave o etiqueta XML que no era del tipo requerido, por ejemplo, no era un número válido o una lista para un parámetro que no permite una lista.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: corrija el error y vuelva a especificar la solicitud.

SMC0270

Keyword or tag=KKKKKKKK may not have a value in command CCCCCCCC [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: un comando de entrada contenía un valor para una palabra clave o etiqueta XML que no permite un valor.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: corrija el error y vuelva a especificar la solicitud.

SMC0271

Length of value=VVVVVVVV is invalid for keyword or tag=KKKKKK in command CCCCCCCC [at line nnnn of SMCCMDS|SMCPARMS]

Nivel: 0

Explicación: un comando de entrada contenía un valor para una palabra clave o etiqueta XML que era más corta o más larga que la longitud requerida.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: corrija el error y vuelva a especificar la solicitud.

SMC0272

Error parsing XML values for XML tag=TTTTTTTT in command=CCCCCCCCC; RC=nnn

Nivel: 0

Explicación: un comando XML contenía un valor o un error de análisis relacionado con la etiqueta que se muestra. El código de retorno de análisis se incluye en el mensaje para diagnóstico.

Acción del sistema: el procesamiento continúa. Se ignora el comando.

Respuesta del usuario: corrija el error y vuelva a especificar la solicitud.

SMC0300

Message|Command nnnnn Help Text:

Nivel: 0

Explicación: se ejecutó el comando Help. Se muestra el texto de ayuda para el mensaje o para el comando.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0301

HELP for XXXXXX not found

Nivel: 0

Explicación: se ejecutó el comando Help. No se encuentra el asunto XXXXXX.

Acción del sistema: ninguna.

Respuesta del usuario: vuelva a introducir el comando Help con un asunto válido.

SMC0302

XXXXXX is an invalid range

Nivel: 0

Explicación: se ejecutó el comando Help. El asunto XXXXXX es un rango no válido.

Acción del sistema: ninguna.

Respuesta del usuario: vuelva a introducir el comando Help con un asunto válido.

SMC0805

VM Client failed setting ANCHOR: rc=nnn

Nivel: 0

Explicación: se recibió un código de retorno diferente a cero cuando se ejecutó la macro CMS ANCHOR SET.

Acción del sistema: el cliente de VM termina.

Respuesta del usuario: póngase en contacto con el soporte de software de StorageTek.

SMC0806

TCP/IP server available: id=YYYYYY

Nivel: 0

Explicación: el cliente de VM se conectó correctamente con el ID de TCP/IP, YYYYYY.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0807

TCP/IP server is unavailable; id=YYYYYY errno=NNN errmsg

Nivel: 0

Explicación: las funciones TCP/IP del cliente de VM devolvieron un error mientras se intentaba establecer una conexión de socket con YYYYYY.

Acción del sistema: ninguna.

Respuesta del usuario: corrija el ID de TCP/IP especificado en el archivo SMCPARMS y reinicie el cliente de VM. Si el ID de TCP/IP es correcto, póngase en contacto con el soporte de software de StorageTek.

SMC0810

Dynamic Allocation NOT supported

Nivel: 0

Explicación: el comando READ intentó asignar de manera dinámica un archivo para lectura.

Acción del sistema: el comando no se procesa.

Respuesta del usuario: vuelva a introducir el comando READ, especifique el archivo SMCCMDS desde el FILEDEF de inicio.

SMC0811

cp command

Nivel: 0

Explicación: se muestra la salida del comando CP.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0812

LOG command requires CONSOLE or DISK

Nivel: 0

Explicación: el comando LOG requiere que se introduzca CONSOLE o DISK.

Acción del sistema: el comando no se procesa.

Respuesta del usuario: vuelva a introducir el comando LOG con las opciones adecuadas.

SMC0813

mmmm+nnnn - aaaaa - PSW data ppppEvent eeee - Data dddd - Thread nnnnData at PSW addr - xxxx<>xxxx

Nivel: 0

Explicación: se detectó una finalización anormal.

- mmmm+nnn indica el módulo y el desplazamiento que finalizaron de manera anormal.

- aaaa indica el código de finalización anormal.

- pppp indica el PSW generado en la finalización anormal.

- eeee indica la dirección de los datos VMERROR devueltos por el evento de error.

- dddd indica la dirección del área de datos devuelta por el evento de error.

- nnnn indica el ID del thread de finalización anormal.

- xxxx<>xxxx indica los datos de la dirección de PSW.

- <> marca la dirección de PSW.

Continúan los registros de la finalización anormal.

Acción del sistema: termina el comando o la solicitud de TMI.

Respuesta del usuario: póngase en contacto con el soporte de software de StorageTek.

SMC0814

Dump sent to nnnnn ddd dumps remain

Nivel: 0

Explicación: el sistema produjo un volcado de almacenamiento en respuesta al comando DUMP o debido a un programa de finalización anormal.

Acción del sistema: se transfiere el archivo de volcado al ID de usuario nnnnn.

Respuesta del usuario: si el número de volcados permitidos (ddd) se acerca a 0, ejecute el comando DUMPOPTS RESET para restablecer el número de volcados permitidos o cambiar el límite de volcado máximo. Si este mensaje no es en respuesta al comando DUMP, comuníquese con el soporte de software de StorageTek.

SMC0815

Dump not taken due to dump Max Count - nnnn

Nivel: 0

Explicación: se produjo el número máximo de volcados permitidos por el comando DUMPOPTS.

Acción del sistema: la solicitud de volcado se ignora. Hasta que no se recibe el comando DUMPOPTS RESET, no se atienden solicitudes de volcado.

Respuesta del usuario: ejecute el comando DUMPOPTS RESET para restablecer el número de volcados realizados o cambiar el límite de volcado máximo.

SMC0816

DUMPOPTS settings:

DUMPS TAKEN=tttt
DUMPS MAX COUNT=mmmmm
TO=uuuuuuuuu

Nivel: 0

Explicación: se ejecutó el comando DUMPOpts con la palabra clave LIST. Se muestra la configuración de DUMPOPTS.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0817

LOG settings:

CONSOLE=ON|OFF
CLASS=c
TO=uuuuuuuu
DISK=ON|OFF
FM=a

Nivel: 0

Explicación: se ejecutó el comando LOG con la palabra clave LIST. Se muestra la configuración de LOG.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0818

OPERATOR settings:

ID=uuuuuuuu

Nivel: 0

Explicación: se ejecutó el comando OPERator con la palabra clave LIST. Se muestra la configuración de OPERATOR.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0819

Disk FM m is READONLY

Nivel: 0

Explicación: el disco especificado en el parámetro FM es READONLY. El disco debe estar habilitado para escritura.

Acción del sistema: el comando no se procesa.

Respuesta del usuario: vuelva a introducir el comando con los parámetros adecuados.

SMC0820

Disk FM m is not defined

Nivel: 0

Explicación: el disco especificado en el parámetro FM no está definido.

Acción del sistema: el comando no se procesa.

Respuesta del usuario: vuelva a introducir el comando con los parámetros adecuados.

SMC0821

UUUUUU is not a defined VM userid

Nivel: 0

Explicación: el valor introducido no es un ID de usuario de VM definido.

Acción del sistema: el comando no se procesa.

Respuesta del usuario: vuelva a introducir el comando con los parámetros adecuados.

SMC0822

XXXXXXXX has initiated VM Client termination

Nivel: 0

Explicación: se recibió el comando EXIT del origen XXXXXXXX.

Acción del sistema: el cliente de VM está iniciando el procesamiento de terminación.

Respuesta del usuario: ninguna.

SMC0823

UUUUUUUU is not authorized for VM Client ZZZ requests

Nivel: 0

Explicación: se denegó una solicitud de ZZZ del cliente de VM recibida desde el ID de usuario de VM UUUUUUUU. El ID de usuario no está autorizado para ejecutar solicitudes de ZZZ.

Acción del sistema: el cliente de VM ignora la solicitud y continúa con el procesamiento.

Respuesta del usuario: use el comando AUTHORIZE para permitir que los ID de usuario de VM ejecuten las solicitudes de comandos y TMI del cliente de VM. Otra opción consiste en usar la salida del cliente de verificación del cliente de VM SMCXIT01.

SMC0824

MOUNT|DISMOUNT command failed; RC=NNNN - Reason=MMMM

Nivel: 0

Explicación: falló el comando MOUNT o DISMOUNT con el código de retorno NNNN. El código de retorno (MMMM) puede ser el número de mensaje del HSC que describe el motivo del fallo.

Acción del sistema: el comando falla.

Respuesta del usuario: corrija el problema que se indica en el mensaje de montaje o desmontaje del HSC.

SMC0825

FORCE parameter invalid for virtual drive DDDD

Nivel: 0

Explicación: no se admite el parámetro DISMOUNT FORCE para dispositivos virtuales.

Acción del sistema: el desmontaje no se procesa.

Respuesta del usuario:vuelva a ejecutar el comando DISMOUNT sin el parámetro FORCE. Si es necesario, ejecute el comando CMS TAPE RUN o CP DETACH para descargar la unidad.

SMC0826

Authorized users: UUUUUUUU Requests: req1 req2 ...

Nivel: 0

Explicación: se ejecutó el comando AUTHorize con la palabra clave LIST. Se muestran los usuarios autorizados y los tipos de solicitudes para las que están autorizados.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0827

POOLMAP SCRATCH MANAGEMENT

SUBPOOL        CLASS
PPPPPPPPPPPPP  MMMMMMMM

Nivel: 0

Explicación: se ejecutó el comando POOLmap con la palabra clave LIST. Los nombres de subagrupaciones reutilizables, PPPPPPPPPPPPP, se muestran con los nombres de clase de gestión correspondientes, MMMMMMMM.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0828

POOLMAP validation failed; reason

Nivel: 0

Explicación: el comando POOLmap recibió un error mientras se validaba la clase de gestión y el nombre de la subagrupación con el servidor del HSC.

Los motivos posibles son:

- clase de gestión no válida

- nombre de subagrupación no válido

- servidor del HSC no disponible

Acción del sistema: ninguna.

Respuesta del usuario: corrija el parámetro no válido y vuelva a ejecutar el comando.

SMC0829

Mount of volume VVVVVV complete on drive DDDD

Nivel: 0

Explicación: se montó correctamente el volumen de cinta, VVVVVV, en la unidad de cinta DDDD.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC0830

Waiting for a TapePlex SSSS server to become active

Nivel: 12, 16, 20, 24, 28

Explicación: este mensaje se muestra si está especificada la opción WAIT para el comando RESYNC y no hay servidores TapePlex disponibles.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

SMC9999

MMMMMMMM Variable text

Nivel: 0

Explicación: los mensajes de SMC9999 son para determinación y resolución del problema por parte del soporte de software de StorageTek. MMMMMMMM es el nombre del módulo de ejecución.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna. El nivel de mensaje (LVL) 12 o superior generalmente se especifica solamente cuando es dirigida por el soporte de software de StorageTek.

9 Interfaz de gestión de cintas del cliente de VM

En este capítulo, se describe la interfaz de gestión de cintas del cliente de VM (VMTMI).

TapePlex hace referencia al complejo de recursos gestionados por el software StorageTek, incluidos los recursos de la biblioteca para cartuchos reales y los recursos de VSM para volúmenes virtuales.

Una unidad TapePlex es el hardware gestionado por un único CDS del HSC. El cliente de VM proporciona acceso a una única unidad de TapePlex. El cliente de VM usa TCP/IP para enrutar transacciones a un servidor HSC que se ejecuta en z/OS. Se pueden definir varias instancias de HSC en varios hosts como servidores para proporcionar redundancia. Las transacciones entre el cliente de VM y el servidor HSC usan una API basada en XML denominada XAPI. El software VM Client convierte las transacciones de la interfaz de gestión de cintas a formato XAPI para que el servidor pueda interpretarlas y convierte la salida de estas transacciones en formato XAPI para la respuesta.

Dado que la interfaz de gestión de cintas ahora interactúa con un componente de cliente que, a su vez, interactúa con HSC (y VTCS) en z/OS, ya no se admiten algunos comandos de TMI que se admitían en versiones anteriores. En algunos casos, la funcionalidad no se admite en un entorno de cliente/servidor, mientras que es posible que otros comandos se admitan en versiones futuras.

Los siguientes comandos de TMI no se admiten para VM Client 7.3:

- DEFSCR y DEFPOOL
Estos comandos son sustituidos por la función POOLPARM/VOLPARM del HSC presentada en ELS 7.0. Consulte la publicación Configuración de HSC y VTCS para obtener información acerca de esta función.

- QEJECT

- QREQUEST

- SETOPER
El cliente de VM no admite respuestas del operador; por lo tanto, todos los comandos se procesan como si se ejecutara el comando SETOPER. Las condiciones que anteriormente hubieran generado mensajes de WTOR se devuelven como mensajes de error.

- STOP

Además, el cliente de VM no admite el uso de claves de consulta TAPEREQ, como nombres de trabajos, nombres de pasos, nombres de programas y nombres de juegos de datos para seleccionar medios y valores de técnicas de registro.

La descripción general de las interfaces entre los sistemas de gestión de cintas (TMS) y el cliente de VM incluye los siguientes temas:

- Responsabilidades de TMS
Esta sección describe los servicios que proporciona un TMS.

- Puntos de decisión de TMS
En esta sección, se describe dónde la interacción con TapePlex ayuda a los servicios de TMS para recursos gestionados por TapePlex.

- Información de TapePlex devuelta al TMS
En esta sección, se describe la información devuelta como consecuencia de la interacción de TapePlex.

- Consideraciones del vehículo de comunicaciones entre usuarios (IUCV)
En esta sección, se describen los parámetros que se usan con la macro de IUCV.

- Interacción entre TMS y el cliente de VM
En esta sección, se describen varios escenarios que involucran la interacción de TMS con el cliente de VM.

Las siguientes secciones describen estos temas en detalle.

Responsabilidades de TMS

El sistema de gestión de cintas tiene tres funciones principales:

- Interfaz de usuario

- Asignación de recursos de cintas

- Interfaz del operador

Interfaz de usuario

Generalmente, el usuario final solicita las funciones de TapePlex de forma indirecta mediante la solicitud de servicios desde el sistema de gestión de cintas (TMS). Estas solicitudes son enrutadas por TMS al cliente de VM y, a continuación, al servidor TapePlex. La interacción directa entre el usuario final y el cliente de VM solamente se produce si el usuario final ejecuta los comandos del cliente de VM directamente mediante la función VM Special Message (Mensaje especial de VM, SMSG) o si invoca directamente a VMTMI. Para ver un ejemplo, consulte el EJEMPLO de VMTMI.

Asignación de recursos de cintas

Los recursos de control del TMS incluyen:

- Transportes
El TMS generalmente tiene la propiedad de los transportes para reconocimiento automático de volúmenes (AVR) y también asigna transportes a los usuarios que solicitan servicios de cintas. El TMS determina la disponibilidad de los transportes de cintas para solicitudes de asignación. El TMS también conoce los tipos de medios y la densidad que admite cualquier transporte. El cliente de VM ayuda al TMS en la sección de transportes controlados por TapePlex cuando es necesario.

- Juegos de datos
El TMS asigna juegos de datos a volúmenes de cintas y puede asignar etiquetas externas a etiquetas internas. El TapePlex no contiene dicha información.

- Volúmenes reutilizables
El TMS es la autoridad final en relación con el estado de reutilización de los volúmenes. Este estado también incluye la afiliación de subagrupaciones reutilizables. Para automatizar el procesamiento de montaje para un TMS que genera montajes "no específicos" (solicitudes para volúmenes reutilizables que no especifican VOLSER), el TapePlex también conserva su propia información de estado de reutilización. La lista de estado de reutilización del TMS no se considera una lista de todos los volúmenes reutilizables disponibles, sino un subjuego del número total de volúmenes reutilizables disponibles.

- Volúmenes específicos
El TMS controla cuáles usuarios tiene acceso a volúmenes específicos. El TapePlex maneja los volúmenes que controla según la solicitud de un operador autorizado o del TMS.

Interfaz del operador

El montaje y el desmontaje de cintas, y la selección de agrupaciones reutilizables se maneja mediante el tráfico de mensajes entre el TMS y el operador. El cliente de VM usa la información proporcionada en mensajes al operador para dirigir montajes, desmontajes, etc.

Puntos de decisión del TMS

El servidor TapePlex puede tener influencia sobre las decisiones del TMS cuando los servicios de TapePlex estén disponibles para el TMS mediante el cliente de VM. El servidor TapePlex tiene influencia sobre las decisiones del TMS en los siguientes puntos:

Inicialización del TMS

Cuando se inicializa el TMS, se debe establecer mediante el TMS una ruta de IUCV a la máquina del cliente de VM para determinar si el cliente de VM y el servidor TapePlex funcionan y se comunican correctamente. Si la máquina del cliente VM no funciona correctamente en el inicio del TMS, establezca una ruta de IUCV tan pronto como sea posible después de la inicialización del cliente de VM y del TapePlex. Es posible establecer una conexión independiente para cada transacción, pero esto causa un procesamiento innecesario. Para usar IUCV con eficacia, se debe establecer una ruta y se debe mantener mediante la sesión de comunicaciones del TMS.

Asignación de unidades

Al momento de la asignación, el cliente de VM puede proporcionar información acerca del medio y la ubicación de volúmenes específicos y recuentos de volúmenes reutilizables. El TMS puede usar el resultado de consultas para seleccionar unidades óptimas compatibles para una solicitud de asignación.

Asignación de volúmenes reutilizables

Si el TMS lo solicita, el cliente de VM puede proporcionar al VOLSER un volumen reutilizable antes de una solicitud de MOUNT. Esta selección se puede rechazar o se puede usar en el montaje subsiguiente. Si esta información no es necesaria, las solicitudes de MOUNT no específicas causan la selección de un volumen reutilizable.

Movimiento de volúmenes

Cuando se requiere un montaje, desmontaje u otro movimiento de un volumen, el TMS decide si el TapePlex lleva a cabo la acción o si se requiere una operación manual. El cliente de VM devuelve la información de estado para las solicitudes de movimiento de volúmenes.

Cómo regresar un volumen al estado reutilizable

Es necesario mantener el estado reutilizable del TMS y del TapePlex sincronizado. El primer momento es en el desmontaje y, el último, cuando se genera una lista de desplegable de volúmenes reutilizables del TMS. Las solicitudes de TMI y los comandos del cliente de VM están disponibles para coordinar esta actividad.

Información de TapePlex devuelta al TMS

La información de TapePlex devuelta incluye lo siguiente:

Información de configuración

La información de configuración incluye:

- Número máximo de transportes en el ACS más grande

- Número de transportes en el control de la biblioteca

- Número de ACS

- Número de LSM

- Tamaños de áreas de respuesta

Estado de volumen

La información de estado del volumen incluye lo siguiente:

- Volumen en una celda

- Volumen en una unidad

- Volumen que no está en una biblioteca

- Volumen al que no se puede acceder

- Ubicación incierta del volumen (erróneo)

Ubicación de volumen

La información de ubicación del volumen incluye lo siguiente:

- ACSid

- LSMid

- Ubicación del panel

- Ubicación de filas

- Ubicación de columnas

Unidades elegibles

Desde la perspectiva de un TapePlex, las unidades elegibles son las que están en el mismo ACS o VTSS que el volumen, y con una técnica de registro compatible con el volumen. No se tiene en cuenta la disponibilidad real de las unidades (capacidad de conexión, estado en línea).

Estado de movimiento y códigos de error

Las solicitudes de movimiento de volúmenes devuelven un código que indica que la operación se ha realizado correctamente. Si se produce un error, también se devuelve un código adicional que corresponde al mensaje emitido para el operador.

Estado de LSM y ACS

El estado de LSM es en línea o fuera de línea. En línea indica que se puede llevar a cabo el montaje automatizado. Fuera de línea indica que solamente es posible el montaje manual.

El estado de ACS es conectado o desconectado. Si el estado es Disconnected (Desconectado), no se podrá acceder al ACS desde este host y toda la actividad deberá ser maneja desde otro host.

- VOLSER para gestión de reutilización
Si se solicita la selección de un volumen reutilizada, se devolverá un VOLSER marcado como reutilizable en el juego de datos del control de TapePlex. Esta selección hace que el volumen se marque como no reutilizable.

- Notación de la biblioteca para volúmenes y unidades virtuales
El uso del cliente de VM permite a TMS acceder a las unidades y los volúmenes virtuales. La interfaz de gestión de cintas asigna cada VTSS a un ID de ACS y a un juego de ID de LSM, de modo que el TMS pueda manejar unidades y volúmenes virtuales como si fueran volúmenes reales. El cliente de VM proporciona la asignación de VTSS a ACS y garantiza que los ID de ACS que representan VTSS no se superpondrán con ACS reales. Las operaciones de movimiento de volúmenes, como EJECT, MOVE y ENTER no se permiten para volúmenes virtuales.

Consideraciones del vehículo de comunicaciones entre usuarios (IUCV)

El vehículo de comunicaciones entre usuarios (IUCV) es una interfaz de comunicaciones proporcionada por IBM.

Nota:
VMTMI SAMPLE es un programa de muestra que ilustra el uso de la interfaz de gestión de cintas de cliente de VM. Se encuentra en el ID de usuario MAINTSTK.

Para usar IUCV para emitir solicitudes, siga estos pasos:

1. Establezca una conexión con la máquina del servicio del cliente de VM mediante la función CONNECT de IUCV.

- Solamente las máquinas virtuales autorizadas pueden ejecutar comandos en la máquina de servicio del cliente de VM. Para obtener permiso, la máquina virtual que ejecuta el comando de TMI o del cliente de VM debe obtener privilegios mediante el comando AUTHorize del cliente de VM ejecutado en la máquina de servicio del cliente de VM en el campo SMCPARMS o SMCCMDS en el inicio, o desde una máquina virtual autorizada anteriormente.

- Además, la máquina virtual debe estar autorizada para CP mediante una sentencia de control de IUCV en la entrada del directorio de CP. Generalmente, esto lo realiza un programador o administrador del sistema. Asegúrese de que OPTION MAXCONN especifique suficientes rutas para su uso.

- Para establecer esta conexión de IUCV (ruta), la macro de IUCV se ejecuta con los siguientes parámetros:

IUCV CONNECT,
PRMLIST=addr,          * address of IUCV parm list
USERID=addr,           * address of CL8 ’userid’
USERDATA=addr,         * address of CL16 ’ddname’
PRMDATA=NO             * no parm data in IPARML

donde:

userid indica el nombre de la máquina de servicio del cliente de VM.

ddname indica el nombre de la interfaz IUCV del cliente de VM que se solicita para la conexión. Es un área de 16 bytes como la siguiente:

DC CL8'SLSTLMS'       ddname
DC CL8' '       reserved

Cuando ejecute la función, compruebe el código de estado de PSW. Si el código de estado es 0, guarde el ID de la ruta desde el área de IPARML que se transmite a la macro. El programa debe esperar que la máquina de servicio del cliente de VM acepte mediante ACCEPT de IUCV la conexión pendiente antes de enviar mensajes. Si no se devuelve el mensaje ''connection complete'' (conexión completa) o ''path severed'' (ruta cortada), entonces el cliente de VM no está activo, no se ha inicializado completamente o el solicitante CONNECT de IUCV especificó parámetros no válidos.

2. Envíe el mensaje a la máquina de servicio del cliente de VM mediante la función SEND de IUCV. Especifique los siguientes parámetros en la macro del IUCV:

IUCV SEND,
PATHID=adpid,
TYPE=2WAY,
BUFLEN=buflen,
RBUF=reply,
RLEN=reply length

donde:

- adpid es la dirección de un área de datos que contiene el ID de ruta del IUCV.

- TYPE=2WAY especifica que se espera una respuesta del IUCV.

- buflen es la longitud del ''buffer''.

- reply es la dirección del buffer que contiene la respuesta.

- reply length es la longitud de la respuesta del buffer.

3. Cuando haya terminado de usar una conexión a la máquina de servicio del cliente de VM, libere la ruta mediante la función SEVER del IUCV.
No se admiten los siguientes parámetros de IUCV para esta interfaz:

TYPE=1WAY

El cliente de VM debe ejecutar la función REPLY del IUCV.

TRGCLS= TRGCLS

El cliente de VM ignora esta función.

DATA=PRMMSG CP

No permite que se ejecute la función SEND.

PRMMSG=address

CP no permite que se ejecute la función SEND.

PRTY=YES

El comando CP usa esto para modificar las colas de la máquina de servicio del cliente de VM. La máquina de servicio del cliente de VM no maneja el mensaje de manera especial.

El resto de los parámetros del IUCV se pueden usar como se desee.

Consideraciones adicionales

Tres campos de la lista de parámetros del IUCV (IPARML) merecen una mención especial:

USERID=

Este parámetro especifica el nombre de la máquina de servicio que ejecuta el cliente de VM. Oracle recomienda que el ID de usuario se pueda modificar, el lugar de estar codificado, para facilitar los cambios.

USERDTA=

Este parámetro especifica el nombre del proceso de la máquina de servicio que recibe la comunicación del TMS (ACSINT). Debe ser SLSTLMS.

UWORD=

Este parámetro especifica una palabra que aparecerá en R0 al momento de la interrupción. Resulta útil para establecer acceso a un área común de datos. Esto contiene un área con una lista de solicitudes pendientes, estados de rutas y valores de configuración a los que se hace referencia en diferentes rutinas.

Consulte la publicación de IBM VM/SP System Facilities for Programming (Funciones del sistema de VM/SP para programación) o VM/XA CP Programming Services (Servicios de programación de CP para VM/XA) para obtener información adicional sobre la interfaz del IUCV y los parámetros que se muestran arriba.

Interacción entre el TMS y el cliente de VM

El cliente de VM requiere varios puntos de interfaz con un sistema de gestión de cintas (TMS):

- Conexión inicial del TMS al cliente de VM

- Asignación de unidades

- Procesamiento de mensajes del operador

El TMS proporciona una interfaz de usuario entre el cliente de VM y el usuario, y mantiene la asignación, el juego de datos y los servicios de agrupación reutilizable. El cliente de VM proporciona al TMS la manipulación del montaje/desmontaje y la selección de volúmenes reutilizables, e influye en la asignación de esos volúmenes y unidades bajo el control de TapePlex.

La invocación de una macro (ACSRQ) prepara una llamada al vehículo de comunicaciones entre usuarios (IUCV) para establecer una comunicación entre del TMS y el cliente de VM. El TMS realiza la llamada al IUCV.

Las siguientes funciones de gestión de cintas admiten la comunicación:

- Una interfaz al momento de la asignación para proporcionar información sobre el volumen reutilizable y el tipo de dispositivo.

- Una interfaz en el momento del mensaje para manejar el mensaje que generalmente se muestra al operador.

- Una lista de direcciones de unidades de transporte y medios correspondientes, e información sobre la ubicación.

- Un gestor de interrupciones del IUCV.

Conexión inicial del TMS al cliente de VM

La hora de conexión inicial es útil para determinar el tamaño de las áreas de datos relacionadas para una pequeña parte de las respuestas más largas. Las opciones varían según la configuración de TapePlex. A continuación, estas áreas se asignan antes del uso requerido.

Cuadro de diálogo de conexión inicial

Al momento de la conexión, se debe ejecutar una solicitud de QCONFIG para determinar el tamaño de las áreas de datos de respuesta que son necesarias para otras solicitudes. Por ejemplo:

Ejemplo 9-1 Cuadro de diálogo de conexión inicial

TMS                                   VM CLIENT
|
ICUV CONNECT     <==============>     IUCV ACCEPT
|
ACSRQ QCONFIG           |
IUCV SEND        <==============>     IUCV RECEIVE
|             Format return data
<==============>     IUCV REPLY
Calculate sizes         |
Store in global area    |

Asignación de unidades

Mientras que el TMS es completamente responsable de la asignación de unidades, el cliente de VM y TapePlex ayudan en este proceso mediante la presentación de una lista de unidades en orden de idoneidad para satisfacer los montajes de volúmenes específicos y reutilizables.

En la siguiente sección, se describe la interacción entre la interfaz de asignación de TMS y el cliente de VM.

Interacción de asignación

La máquina de servicio de TMS recibe una solicitud de una máquina virtual para montar un volumen e invoca a la rutina de la interfaz de asignación.

Si no se establece una ruta del IUCV a la máquina de servicio del cliente del cliente de VM, el sistema de gestión de cintas intenta establecer una. Si el intento falla, no se lleva a cabo la ayuda de asignación, un código de retorno indica el estado y se puede configurar un indicador para informar a la interfaz de mensajes que el mensaje del operador no se puede llevar a cabo ya que no se ha realizado ninguna asignación especial.

Cuadro de diálogo de asignación

1. La interfaz de asignación del TMS envía una solicitud mediante un mensaje del IUCV a la máquina de servicio del cliente de VM:

ACSRQ QDRLIST,VOLSER=voladr

Una solicitud alternativa es:

ACSRQ QDRLIST,VOLSER=voladr,COUNT=,LIST=

La solicitud de arriba incluye los parámetros COUNT= y LIST=. Estos dos parámetros describen una lista de los dispositivos que TMS considera elegibles. Esta información se transmite al cliente de VM.

TMS                                   VM CLIENT
|
ACSRQ QCONFIG           |
ICUV SEND        <==============>     IUCV RECEIVE
|             Format lists of
|             drives and status
Select drive     <==============>     IUCV REPLY
|

2. La interfaz de asignación espera una respuesta mediante la función REPLY del IUCV.

3. Una rutina del cliente de VM recopila los datos, aplica formato a la respuesta y ejecuta una respuesta mediante la función REPLY del IUCV. La función REPLY del IUCV se asigna mediante la macro de SLX.

4. El IUCV del TMS admite funciones para notificar al proceso de asignación de espera que se ha recibido una respuesta.

5. A continuación, la rutina de la interfaz de asignación cambia el formato de la respuesta a una lista de preferencia de unidades (formato dependiente del TMS), compara la respuesta con las unidades disponibles gestionadas por el TMS y sale de la interfaz.

6. Si se necesita una selección de volúmenes reutilizables, ejecute:

ACSRQ SELSCR,DRIVE=drivadr

Esto devuelve un VOLSER y marca el volumen como no utilizable en el juego de datos de control o indica que no hay ningún volumen reutilizable disponible.

TMS                                   VM CLIENT
|
ACSRQ SELSCR            |
ICUV SEND        <==============>     IUCV RECEIVE
|             Select VOLSER and
|             mark nonscratch
Store VOLSER     <==============>     IUCV REPLY
|

Terminación de interfaz de asignación

El control se devuelve al TMS cuando la rutina de la interfaz de asignación completa el procesamiento.

Procesamiento de mensajes de operación

En la siguiente sección, se describe la interacción entre la interfaz de mensaje de TMS y el cliente de VM. La sección Cuadro de diálogo de mensajes del operador describe el procesamiento de una solicitud de MOUNT. Otras solicitudes de punto de interfaz de mensajes (por ejemplo, DISMOUNT, SCRATCH), siguen una secuencia de eventos similar y no se describen de forma separada. El TMS puede suprimir o cambiar el mensaje según la finalización del proceso.

Se ejecuta una solicitud de DISMOUNT en respuesta a las condiciones detectadas por el TMS que requieren un desmontaje del volumen (por ejemplo, el volumen montado no es el solicitado) o si el TMS siempre desmonta los volúmenes después del uso.

El TMS ejecuta una solicitud de SCRATCH para regresar los volúmenes de "trabajo'' al estado reutilizable. El juego de datos del control del HSC en el servidor se actualiza para reflejar estos cambios.

Interacción de mensajes del operador

La máquina de servicio del TMS recibe una solicitud de una máquina virtual para montar un volumen. La máquina de servicio del TMS debe tener una ruta del IUCV establecida para ejecutar comandos en el cliente de VM. La unidad ya se ha seleccionado.

Cuadro de diálogo de mensajes del operador

1. El código de la interfaz del mensaje determina que la solicitud es para una unidad.

2. La interfaz del mensaje puede enviar una solicitud mediante el uso de un mensaje del IUCV a la máquina de servicio del cliente de VM para obtener información de ubicación.

ACSRQ QVOLUME,VOLSER=voladr

3. La interfaz del mensaje espera una respuesta mediante IUCV REPLY.

4. El cliente de VM determina el estado del volumen, agrega los datos de ubicación y ejecuta una respuesta mediante IUCV REPLY. Si la información de estado del volumen se mantiene desde la rutina de asignación, se deben omitir los cuatro pasos anteriores.

5. Si el volumen se encuentra en el TapePlex, la interfaz de mensajes del operador envía una solicitud mediante un mensaje de IUCV a la máquina de servicio y se especifica el volumen que se montará y la unidad que se usará.

ACSRQ MOUNT,VOLSER=volser,DRIVE=drivadr,PROTECT=

6. La interfaz del mensaje espera una respuesta mediante IUCV REPLY.

7. La rutina del cliente de VM MOUNT solicita al servidor que realice el montaje, aplica formato a una respuesta de operación correcta/con fallo, y emite una respuesta. La respuesta de IUCV REPLY al mensaje de origen se asigna mediante la macro de SLX.

Nota:
La solicitud de MOUNT dirigida a una unidad de transporte que contiene un volumen descargado causa un desmontaje de ese volumen, seguido del montaje solicitado.

8. El IUCV del TMS admite rutinas para notificar a la interfaz de mensajes de espera que se ha recibido una respuesta.

9. La rutina de la interfaz de mensajes examina la respuesta para determinar si el montaje se ha realizado correctamente, configura un código de retorno adecuado y sale de la interfaz.

Terminación de la interfaz de mensajes del operador

El control regresa al sistema de gestión de cintas cuando la rutina de la interfaz de mensajes completa el procesamiento.

Desmontaje detectado por PROP

Cuando se desconecta una unidad de StorageTek conectada a una máquina virtual o si la máquina virtual ha cerrado sesión, se ejecuta el mensaje DETACH en el operador del sistema de VM. Si una unidad se desconecta mientras se monta una biblioteca o un volumen virtual, es posible que no se notifique al TMS y que no se ejecute un mensaje de DISMOUNT normal en la máquina de servicio del cliente de VM.

Para manipular correctamente el desmontaje, la función PROP (Operador programable) de VM (PRogrammable OPerator) deberá interceptar determinados mensajes y procesarlos según corresponda.

Nota:
Al igual que la máquina de TMS, la máquina PROP deberá estar autorizada por la máquina de servicio del cliente de VM para los comandos. La función llamada mediante PROP RTABLE debe tener el nombre de una máquina de servicio de cliente de VM disponible.

SMCPROP EXEC, LOGTAPE SAMPLE y RTABLE SAMPLE se proporcionan como ejemplos. Los EXEC se pueden usar sin modificar o modificados para ajustarse al entorno. Estos se deben configurar para ejecutarse de manera similar a la siguiente secuencia:

1. PROP detecta el mensaje DETACH e invoca una rutina (SMCPROP EXEC) para comprobar si se montó anteriormente una biblioteca o un volumen (virtual) en la unidad (guardada mediante SMCPROP EXEC). Si es así, ejecute el siguiente comando:

CP SMSG vmclientuser DISMOUNT DRIVE cuu

2. SMCPROP EXEC ejecuta el comando mediante la interfaz de CP SMSG a la máquina de servicio del cliente de VM.

3. El cliente de VM recibe la solicitud de desmontaje.

Escenario A: desmontaje normal

Si el volumen está en la unidad, el desmontaje se procesa normalmente y el proceso es completo. Por ejemplo:

Ejemplo 9-2 Escenario A de desmontaje detectado por PROP: desmontaje normal

PROP                               |   VM CLIENT
|
Receive msg:                       |
.SLS#124I MOUNT OF vvvvv1 ON     |
DRIVE cuu - COMPLETE        |
Save volume and transport address  |
|
Receive msg:                       |
TAPE cuu DETACHED ...           |
|
Use drive address to get saved     |
volume.                         |
|
If a volume was previously saved   |
for the transport, issue dismount: |
CP SMSG smcuser DISMOUNT DRIVE cuu ====> Receive dismount request
|
|   Process dismount
|   DISMOUNT OF vvvvv1 FROM
|   DRIVE cuu COMPLETE
|

Escenario B: desmontaje procesado automáticamente

Si la unidad ya se ha reasignado y se ha ejecutado una solicitud de montaje, el cliente de VM encontrará el volumen anterior en la unidad e iniciará automáticamente el proceso de desmontaje para ese volumen. Cuando se complete este desmontaje automático, se monta el nuevo volumen. Por ejemplo:

Ejemplo 9-3 Escenario B de desmontaje detectado por PROP: desmontaje procesado automático

PROP                               |   VM CLIENT
Receive msg:                       |
.SLS#124I MOUNT OF vvvvv1 ON     |
DRIVE cuu - COMPLETE   |
|
Save volume and transport address  |
Receive msg:                       |
TAPE cuu DETACHED ...            |
|   Receive mount for vvvvv2
|   from TMS
Use transport address to get       |
save volume.                     |
|   Issue msg:
|     .SLS##81I VOLUME vvvvv1
|               FOUND MOUNTED
|               ON DRIVE cuu
|   ATTEMPTING DISMOUNT.
|
|   Process automatic dismount
|   of vvvvvv1
|
|   Process mount of vvvvv2|
Issue dismount:                    |
CP SMSG smcuser DISMOUNT DRIVE cuu ======> Receive dismount for vvvvv1
|     from PROP|
Receive msg:                       |
.SLS0124I MOUNT OF vvvvv2 ON    |
DRIVE cuu - COMPLETE  |
|
Save volume and transport address. |
|

Macro de ACSRQ

La interfaz de gestión de cintas usa la macro de invocación de ACSRQ para preparar un mensaje de IUCV que contenga una solicitud para el cliente de VM. Después de que la macro de ACSRQ devuelve el control al emisor de llamada, la rutina del TMS debe ejecutar la función IUCV SEND.

Solicitudes de ACSRQ

Los tipos de solicitudes usadas para interactuar con la biblioteca incluyen:

- información de consulta

- configuración de parámetros del entorno

- procesamiento de volúmenes

Invoque todas las solicitudes el cliente de VM mediante la instrucción de la macro de ACSRQ. En general, especifique el nombre de la función que se llevará a cabo, la dirección del área de datos que se enviará (ACSINT) y los demás parámetros de palabra clave requeridos.

La macro de ACSRQ genera el bloque de interfaz del ACS (ACSINT) y, de manera opcional, genera un IPARML para la función IUCV SEND. La instrucción IUCV que hace referencia a la función IPARML desarrollada se deberá codificar después de la macro de ACSRQ. La recepción de ACSINT invoca las rutinas adecuadas en el cliente de VM y devuelve información al remitente mediante la función IUCV REPLY.

Se aplican las restricciones del IUCV documentadas en las publicaciones de IBM VM/SP System Facilities for Programming (Funciones del sistema de VM/SP para programación) y VM/XA CP Programming Services (Servicios de programación de CP para VM/XA). Debido a los tamaños de las áreas de datos, no se admite PRMMSG. Tampoco se admiten BUFLIST ni ANSLIST.

TMS                                   VM CLIENT
|
ASRQ xxxxxxx            |
ICUV SEND        <==============>     IUCV RECEIVE
WAIT                    |             Process Request
<==============>     IUCV REPLY
(External Interrupt)    |
Check return code       |
Process reply           |

Consulte Asignación de la macro de SLX para obtener información sobre la asignación del área de respuesta.

Sintaxis de la macro de ACSRQ

A continuación, se muestra la sintaxis de la macro de ASRQ:

Figura 9-1 Sintaxis de la macro de ACSRQ

Function es una de las siguientes funciones:

- DISMOUNT

- EJECT

- MOUNT

- MOVE

- QCAP

- QCONFIG

- QDRIVES

- QDRLIST

- QSCRATCH

- QVOLUME

- QVOLUSE

- SCRATCH

- SELSCR

Parameter es uno de los siguientes parámetros:

- ,ACCT1=acct1addr

- ,ACCT2=acct2taddr

- ,CAP=capidaddr

- ,COL=coladdr

- ,COUNT=countaddr

- ,DRIVE=driveaddr

- ,HOSTID=hostidaddr

- ,IPARML=YES

- ,LIST=listaddr

- ,LSM=lsmidaddr

- ,MEDIA=medaddr

- ,MGMTCLS=mgmtcls

- ,NOTIFY=INSDEL/NOINSDEL

- ,PAN=paneladdr

- ,PATHID=pathadr

- ,PROTECT=YES

- ,RECTECH=recaddr

- ,ROW=rowaddr

- ,RSPADDR=bufadr

- ,RSPLEN=buflen

- ,SCRATCH=YES

- ,SUBPOOL=subpooladdr

- ,TEXT=textaddr

- ,TOLSM=lsmidaddr

- ,TOPAN=paneladdr

- ,USER=useridaddr

- ,VOLSER=voladdr

La interfaz de gestión de cintas (TMI), que permite a los usuarios solicitar información de consulta, movimientos de volúmenes y servicios de control de volúmenes reutilizables desde el cliente de VM, incluye solicitudes que permiten especificar los medios y la técnica de registro.

Entre las solicitudes que pueden usar medios y técnicas de grabación, se incluyen:

- MOUNT

- QDRLIST

- QSCRATCH

- SELSCR

Estas solicitudes se describen en las siguientes páginas.

La TMI determina los valores de los medios y las técnicas de grabación para una solicitud directamente mediante los parámetros MEDia y RECtech.

Nota:
Si se especifica DSECT=YES, el resto de las funciones o los parámetros no son válidos. Se genera una instancia de ACSINT DSECT.

DISMOUNT

La solicitud de DISMOUNT hace que se extraiga un cartucho de una unidad específica. Se mueve un cartucho de la biblioteca a una celda del LSM (seleccionada por el HCS) y se marca como disponible para solicitudes futuras. Los volúmenes virtuales residen en el VTSS y usan las definiciones de MGMTCLAS para determinar la migración, la replicación y las políticas de residencia en el buffer.

Consideraciones

El éxito de una solicitud de DISMOUNT depende de si el volumen ha recibido una solicitud de REWIND/UNLOAD CCW. Si la unidad aún no ha recibido una solicitud de REWIND/UNLOAD CCW, se anulará la solicitud de DISMOUNT.

Una solicitud de DISMOUNT puede cancelar una solicitud de MOUNT para la misma unidad.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ DISMOUNT:

Figura 9-2 Sintaxis de la solicitud de ACSRQ DISMOUNT

Parámetros

ACINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

DRIVE=driveaddr

Especifica la unidad desde la que se desmontará un volumen. Este parámetro es obligatorio.

driveaddr es la dirección de la especificación de unidades de 2 bytes (ccua). Especifique una dirección de datos tipo RX o el número de registro que contiene la dirección de los datos.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

VOLSER=voladdr

De manera opcional, especifica el VOLSER del volumen que se desmontará.

voladdr es la dirección de una etiqueta de volumen de 6 caracteres; una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos.

Se producirá un error si el volumen montado tiene un VOLSER diferente.

Respuesta de solicitud

Se genera una respuesta a una solicitud de DISMOUNT una vez que se han completado todos los movimientos de cartuchos asociados con la solicitud. La respuesta contiene una cabecera de respuesta y un elemento de texto de mensaje. El código de motivo de la cabecera de respuesta (SLXSRC) es un número de mensaje binario que indica cuál mensaje del HSC se ejecutó cuando se completó la solicitud de DISMOUNT. El elemento de texto de mensaje contiene el texto completo del mensaje especificado por el código de motivo.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

EJECT

La solicitud de EJECT inicia la extracción de uno o más cartuchos (hasta 500) de la biblioteca. Los cartuchos se mueven desde las celdas del LSM hasta el CAP de mayor preferencia o a un CAP especificado en la solicitud, de modo que un operador pueda recuperarlos.

Consideraciones

Las solicitudes de expulsar un volumen virtual o un volumen no definido en el juego de control de datos se consideran no válidas.

La longitud de la respuesta puede variar considerablemente, según el número de volúmenes especificados en la solicitud. Hay disponibles varios valores en la respuesta de la solicitud de QCONFIG para uso en la determinación de la longitud del buffer de respuesta adecuada para una solicitud de EJECT. Los valores incluyen:

- SLXZEJC1 contiene la longitud de una respuesta de EJECT para un único volumen. Use este valor para la longitud del buffer de respuesta cuando una solicitud de EJECT especifique VOLSER= o COUNT=1.

- SLXXVOLL contiene la longitud de un único elemento de información de volumen y SLXXMSGL contiene la longitud de un único elemento de texto de mensaje. Cuando una solicitud de EJECT especifica COUNT=n, la longitud del buffer de respuesta se calcula mediante la fórmula: (((n-1)*(SLXXVOLL+SLXXMSGL))+SLXZEJC1).

- SLXZEJCT contiene la longitud de una respuesta de EJECT cuando el número máximo de VOLSER (500) se especifica en la lista de solicitudes. Use este valor para la longitud del buffer de respuesta cuando la fórmula de arriba no se pueda usar y cuando el solicitante pueda comprometer una cantidad mayor de almacenamiento (aproximadamente 78 KB) para la solicitud.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ EJECT:

Figura 9-3 Sintaxis de la solicitud de ACSRQ EJECT

Parámetros

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

CAP=capidaddr

De manera opcional, especifica la dirección del CAP que se usa para satisfacer la solicitud.

capidaddr es la dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

El formato es AALLCC00, donde AA es el número del ACS (decimal de 00 a 99), LL es el número del LSM (decimal de 00 a 99) y CC es el número decimal del CAP. Estos identificadores siempre están seguidos por 00.

COUNT=countaddr

De manera opcional, especifica la dirección de un campo de 2 bytes que contiene el número de VOLSER en la lista designada por el parámetro LIST.

countaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

COUNT es obligatorio con el parámetro LIST y es mutuamente excluyente con el parámetro VOLSER.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

LIST=listaddr

De manera opcional, especifica la dirección de la lista de elementos.

listaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Todos los elementos de esta lista son un VOLSER de 6 bytes.

Un formato especial de este parámetro, LIST=* indica a ACSRQ que la lista ya se ha anexado al área de datos de ACSINT y que no es necesario moverla.

LIST es obligatorio con el parámetro COUNT y es mutuamente excluyente con el parámetro VOLSER.

LSMID=lsmidaddr

De manera opcional, especifica la dirección del LSMid desde el que se expulsan los volúmenes. Si el CAP no está disponible en el LSM especificado, la solicitud falla. Si el usuario no especifica el LSM, el HSC elige un CAPid único en el ACS del primer volumen de la lista. El formato de un LSMid es AALL, donde AA es el número del ACS (decimal) y LL es el número del LSM (decimal). Por ejemplo, 0102 es ACS 01, LSM 02.

lsmidaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección del LSMid.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

SEQ=NO|YES

De manera opcional, especifica si el procesamiento de expulsión del CAP completa las celdas del CAP de forma secuencial o mediante la distancia de la ubicación inicial.

- NO especifica que el proceso de EJECT ordenó los volúmenes solicitados por la ubicación inicial. EJECT completa el CAP o el cargador (para SL8500), según la distancia de la ubicación inicial del volumen al CAP; es decir, los volúmenes más cercanos al CAP se expulsan primero.

- YES especifica que el proceso EJECT coloca los cartuchos en el CAP comenzando por la celda del CAP con mayor disponibilidad y continúa de manera secuencial.

Nota:
El parámetro SEQ es efectivo para todos los tipos de LSM pero se usa principalmente para el entorno de SL8500. Si se desea el orden secuencial para el resto de los tipos de LSM, deberá escribir el código SEQ=YES.

TEXT=textaddr

De manera opcional, especifique una cadena de texto de 32 caracteres para asociación con la solicitud.

textaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

USERID=userisaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

VOLSER=voladdr

De manera opcional, especifica la dirección de una etiqueta de volumen de 6 caracteres.

voladdr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

VOLSER es mutuamente excluyente con los parámetros LIST yCOUNT. Se debe especificar VOLSER o LIST y COUNT.

Respuesta de solicitud

La respuesta de una solicitud de EJECT consiste de una cabecera de respuesta y un elemento de información de volumen, y un elemento de texto de mensaje para cada VOLSER especificado en la solicitud. Los elementos de información del volumen y los elementos de texto del mensaje aparecen en el mismo orden que los VOLSER en la solicitud.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

MOUNT

La solicitud de MOUNT hace que se deba montar un volumen en una unidad específica.

Consideraciones

Se producirá un desmontaje automático cuando se dirija una solicitud de MOUNT a una unidad que contenga un cartucho descargado.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ MOUNT:

Figura 9-4 Sintaxis de la solicitud de ACSRQ MOUNT

Parámetros

La solicitud de ACSRQ MOUNT incluye los siguientes parámetros:

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

DRIVE=driveaddr

Especifica la unidad en la que se montará el volumen; la dirección de la especificación de la unidad de 2 bytes (ccua). Este parámetro es obligatorio.

driveaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

MEDIA=medaddr

De manera opcional, especifica la dirección de un campo de carácter de 8 bytes que contiene el tipo de medio del cartucho que se montará.

Si no se especifica MEDIA, se montará el siguiente el siguiente cartucho reutilizable compatible sin considerar el tipo de medio.

medaddr es una dirección de datos de tipo RX o el número del registro de (2) a (12) que contiene la dirección de los datos.

MGMTCLAS=mgmtclas

De manera opcional, especifica la dirección de un campo de ocho caracteres que contiene la clase de gestión, alineada a la izquierda y completada con espacios en blanco.

mgmtclas es una dirección de datos de tipo RX o el número del registro de (2) a (12) que contiene la dirección de los datos.

Si no se especifica MGMTCLS, pero se especifica SUBPOOL, se podrá configurar MGMTCLS según el comando POOLmap del cliente de VM.

IPARM=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

PROTECT=YES

De manera opcional, especifica que se deberá proteger el volumen contra escritura. Si no se especifica PROTECT=YES, la posición física de la rueda selectora determina si el volumen está protegido contra escritura.

PROTECT=YES es válido solamente con VOLSER.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

SCRATCH=YES

De manera opcional, especifica que la solicitud es para un volumen (reutilizable) no específico. Se selecciona un VOLSER reutilizable en este momento y se monta en el transporte especificado.

Se debe especificar SCRATCH=YES o VOLSER.

SUBPOOL=subpoolname

De manera opcional, especifica la dirección de un campo de 13 caracteres que contiene el nombre de la subagrupación reutilizable.

subpoolname es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. SCRPOOL (índice de subagrupación) ya no se admite; debe usar el parámetro SUBPOOL para seleccionar una agrupación reutilizable.

SUBPOOL es válido solamente si se especifica SCRATCH=YES. Si no se especifica SUBPOOL, pero se especifica MGMTCLS, se podrá configurar MGMTCLS según el comando POOLmap del cliente de VM.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

VOLSER=voladdr

De manera opcional, especifica la dirección de una etiqueta de volumen de 6 caracteres.

voladdr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Se debe especificar VOLSER o SCRATCH=YES. Este parámetro especifica el VOLSER del volumen que se montará. Se debe especificar VOLSER o SCRATCH=YES.

Respuesta de solicitud

Se genera una respuesta a una solicitud de MOUNT una vez que se han completado todos los movimientos de cartuchos asociados con la solicitud. La respuesta contiene una cabecera de respuesta, un elemento de texto de mensaje y, si la solicitud especificó SCRATCH=YES, un elemento de información de volumen. El código de motivo de la cabecera de respuesta (SLXSRC) es un número de mensaje binario que indica cuál mensaje del HSC se ejecutó cuando se completó la solicitud de MOUNT. El elemento de texto de mensaje contiene el texto completo del mensaje especificado por el código de motivo. El elemento de la información del volumen está presente si la solicitud especificó SCRATCH=YES y describe el volumen reutilizable que se montó.

MOVE

La solicitud de MOVE hace que mueva un volumen a una ubicación específica en el ACS.

Consideraciones

La función MOVE permite el movimiento de un único volumen a otra ubicación dentro de un ACS. El destino de los volúmenes movidos puede ser el mismo LSM o un LSM diferente.

Las funciones de MOVE proporcionan movimiento de volúmenes y control de gestión de cintas mejorado.

Las solicitudes para mover un volumen virtual o un volumen no definido en el juego de control de datos se consideran no válidas.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ MOVE:

Figura 9-5 Sintaxis de la solicitud de ACSRQ MOVE

Parámetros

La solicitud de ACSRQ MOVE incluye los siguientes parámetros:

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

VOLSER=volseraddr

De manera opcional, especifica la dirección de una etiqueta de volumen de 6 caracteres.

voladdr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Se debe especificar VOLSER o SCRATCH=YES. Este parámetro especifica el VOLSER del volumen que se montará. Se debe especificar VOLSER o SCRATCH=YES.

LSM=lsmaddr

De manera opcional, especifica la dirección de un LSMid. El formato de un LSMid es AALL, donde AA es el número del ACS (decimal) y LL es el número del LSM (decimal). Por ejemplo, 0110 es ACS 01, LSM 10.

lsmaddr es una dirección de datos de tipo RX del LSMid o el número del registro de (2) a (12) que contiene la dirección de los datos.

Los parámetros COL, PAN y ROW deben acompañar el parámetro LSM. Este parámetro es obligatorio si no se especifica VOL.

PAN=paneladdr

De manera opcional, especifica la dirección de un número de panel. El formato de número de panel es pp, donde pp es un número decimal.

paneladdr es una dirección de datos de tipo RX del panel o el registro (de 2 a 12) que contiene la dirección del número de panel.

PAN es obligatorio si se especifica LSM.

ROW=rowaddr

De manera opcional, especifica la dirección de un número de fila. El formato de número de fila es rr, donde rr es un número decimal.

rowaddr es una dirección de RX de la fila o el registro (de 2 a 12) que contiene la dirección del número de fila.

ROW es obligatorio si se especifica LSM.

COL=columnaddr

De manera opcional, especifica la dirección de un número de columna. El formato de número de columna es cc, donde cc es un número decimal.

coladdr es una dirección de RX de la columna o el registro (de 2 a 12) que contiene la dirección del número de columna.

COL es obligatorio si se especifica LSM.

TOLSM=lsmaddr

Especifica la dirección del LSMid adonde se movió el volumen. El LSMid son dos bytes hexadecimales con el formato AALL, donde AA es el número del ACS (00-FF hexadecimal) y LL es el número del LSM (LL es 00-17 hexadecimal). Este parámetro es obligatorio.

lsmaddr es una dirección de datos de tipo RX del LSMid o el número del registro de (2) a (12) que contiene la dirección de los datos.

TOPAN=paneladdr

De manera opcional, especifica la dirección de un número de panel. Este parámetro es obligatorio.

paneladdr es una dirección de datos de tipo RX del panel o el registro (de 2 a 12) que contiene la dirección del número de panel.

Respuesta de solicitud

Se genera una respuesta a una solicitud de MOVE una vez que se han completado todos los movimientos de cartuchos asociados con la solicitud. La respuesta contiene una cabecera de respuesta, un elemento de texto de mensaje y, si la solicitud se realizó correctamente, un elemento de información de volumen. El código de motivo de la cabecera de respuesta (SLXSRC) es un número de mensaje binario que indica cuál mensaje del HSC se ejecutó cuando se completó la solicitud de MOVE. El elemento de texto de mensaje contiene el texto completo del mensaje especificado por el código de motivo.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

QCAP

Esta solicitud permite consultar la capacidad y el estado de un CAP.

Consideraciones

Si ACSID, LSM, CAP o LIST y COUNT no se especifican, los datos devueltos son para todos los CAP.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ QCAP:

Figura 9-6 Sintaxis de la solicitud de ACSRQ QCAP

Parámetros

La solicitud de ACSRQ QCAP incluye los siguientes parámetros:

ACSID=acsidaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

CAP=capidaddr

De manera opcional, especifica la dirección del CAP que se usa para satisfacer la solicitud.

capidaddr es la dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

El formato de capidaddr es AALLCC00, donde AA es el número del ACS (decimal), LL es el número del LSM (decimal) y CC es el número del CAP. Estos identificadores siempre están seguidos por 00.

Si se especifica CAP, se devuelve información sobre el CAP especificado.

COUNT=countaddr

De manera opcional, especifica la dirección de un campo de 2 bytes que contiene el número de CAPID en la lista designada por el parámetro LIST.

countaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

COUNT es obligatorio con el parámetro LIST.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

LIST=listitemaddr

De manera opcional, especifica la dirección de la lista de los CAP que se consultarán.

listitemaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si se especifica LIST, se devuelve información sobre todos los CAP de la lista.

LSM=lsmidaddr

De manera opcional, especifica la dirección de un LSMid. El formato de un LSMid es AALL, donde AA es el número del ACS (00-FF hexadecimal) y LL es el número del LSM (LL es 00-17 hexadecimal). Por ejemplo, 0102 es ACS 01, LSM 02. Todos los valores tienen el formato hexadecimal.

lsmidaddr es una dirección de tipo RX del LSMid o el registro de (2) a (12) que contiene la dirección del LSMid.

Si se especifica LSM, los datos devueltos son para el LSM específico. Si ACSID, LSM, CAP o LIST y COUNT no se especifican, los datos devueltos son para todos los CAP.

PATHID=pathidaddr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta del IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

Respuesta de solicitud

La respuesta a la solicitud de QCAP contiene una cabecera de respuesta y un elemento de información del CAP que contiene información acerca de cada CAP solicitado.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

QCONFIG

La solicitud de QCONFIG permite obtener información de resumen acerca de la configuración de TapePlex y las longitudes del buffer de respuesta recomendado para otras solicitudes de la interfaz del TMS.

Consideraciones

La solicitud de QCONFIG debe ser la primera solicitud ejecutada después de que se ha establecido una conexión de IUCV, ya que la respuesta contiene una longitud del buffer de respuesta recomendada (longitud de respuesta) para cada tipo de solicitud de interfaz del TMS.

La longitud de la respuesta de QCONFIG puede cambiar de una versión a otra. El TMS deberá usar la siguiente técnica para obtener la longitud del buffer de respuesta recomendada para una solicitud de QCONFIG:

1. Ejecute una solicitud de QCONFIG con una longitud del buffer de respuesta del decimal 16. La respuesta de esta solicitud consiste de una cabecera de respuesta, truncada en 16 bytes. El código de devolución de la cabecera es 4, que indica que el buffer de respuesta era demasiado pequeño para contener la respuesta completa. La palabra del desplazamiento del decimal 12, SLXCRLN, contiene la longitud del buffer de respuesta recomendada para una solicitud de QCONFIG.

2. Vuelva a ejecutar la solicitud de QCONFIG mediante la longitud del buffer de respuesta recomendada.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ QCONFIG:

Figura 9-7 Sintaxis de la solicitud de ACSRQ QCONFIG

Parámetros

La solicitud de ACSRQ QCONFIG incluye los siguientes parámetros:

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufaddr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

Respuesta de solicitud

La respuesta de QCONFIG contiene una cabecera de respuesta y un elemento de resumen de configuración. QCONFIG devuelve la longitud de cada tipo de elemento de respuesta (por ejemplo, elemento de volumen).

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

QDRIVES

La solicitud de QDRIVES permite obtener información detallada acerca de todos los transportes y los LSM asociados con la biblioteca o con un ACS determinado.

Consideraciones

Ninguno.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ QDRIVES:

Figura 9-8 Sintaxis de la solicitud de ACSRQ QDRIVES

Parámetros

La solicitud de ACSRQ QDRIVES incluye los siguientes parámetros:

ACSID=acsidaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

Respuesta de solicitud

La respuesta de QDRIVES consiste de una cabecera de respuesta, una sección de información de unidades y una sección de información del LSM. La sección Drive Information (Información de unidades) contiene un elemento de información de unidades para cada transporte en la biblioteca o en el ACS. La sección LSM Information (Información del LSM) contiene un elemento de información del LSM para cada LSM en la biblioteca o en el ACS.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

QDRLIST

La solicitud de QDRLIST permite obtener la recomendación de TapePlex para un transporte de biblioteca especificado para una solicitud de MOUNT subsiguiente.

Consideraciones

El cliente de VM realiza su recomendación mediante la devolución de una lista de elementos de información de unidades, que se ordenan de modo que el primer elemento describa el mejor transporte para usar, que el segundo elemento describa el segundo mejor transporte para usar, etc.

Cuando la solicitud de QDRLIST especifica un cartucho determinado (es decir, se especifica VOLSER), los elementos de información de unidades se organizan de modo que el primer transporte que se muestra en la lista sea el LSM más cercano (o igual) al LSM que contiene el cartucho. El último transporte que se muestra en la lista está en el LSM más alejado del LSM que contiene el cartucho. Solamente los transportes que se encuentran en el mismo ACS que el cartucho se representan en la sección Drive Information (Información de unidades).

Cuando la solicitud de QDRLIST especifica un volumen reutilizable (es decir, se especifica SCRATCH=YES), los elementos de información de unidades se organizan de modo que el primer transporte que se muestra aparezca en el LSM que contiene la mayoría de los volúmenes reutilizables. El último transporte que se muestra en el LSM que contiene la menor cantidad de volúmenes reutilizables. Todos los transportes de todos los ACS se representan en la sección Drive Information (Información de unidades).

Para solicitudes para un volumen virtual específico, se devuelven las unidades del VTSS en el que reside el volumen o las unidades que se pueden recuperar. Para solicitudes de un volumen virtual reutilizable, se devuelven las unidades del VTSS que admiten la clase de gestión solicitada.

El cliente de VM ignora si un transporte ya tiene un volumen montado o si se encuentra en un LSM o ACS fuera de línea cuando ordena los elementos de información de unidades.

Se puede proporcionar una lista opcional de direcciones con la solicitud de QDRLIST. Si se proporciona una lista, el cliente de VM la lusa como pantalla mientras genera la respuesta. Se incluye un elemento de información de unidades en la respuesta solamente cuando la dirección de transporte está presente en la lista.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ QDRLIST:

Figura 9-9 Sintaxis de la solicitud de ACSRQ QDRLIST

Parámetros

La solicitud de ACSRQ QDRLIST incluye los siguientes parámetros:

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

COUNT=countaddr

De manera opcional, especifica la dirección de un campo de 2 bytes que contiene el número de CAPID en la lista designada por el parámetro LIST.

countaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

COUNT es obligatorio con el parámetro LIST.

MEDIA=medaddr

De manera opcional, especifica la dirección de un campo de carácter de 8 bytes que contiene el tipo de medio del cartucho que se montará.

Si no se especifica MEDIA, se montará el siguiente el siguiente cartucho reutilizable compatible sin considerar el tipo de medio.

medaddr es una dirección de datos de tipo RX o el número del registro de (2) a (12) que contiene la dirección de los datos.

RECTECH=recaddr

De manera opcional, especifica la dirección de un campo de 8 bytes que contiene la técnica de registro usada para registrar las pistas de datos en la superficie de la cinta.

Si no se especifica RECtech, los transportes se seleccionan según el tipo de MEDia que se ha especificado.

recaddr es una dirección de datos de tipo RX o el número del registro de (2) a (12) que contiene la dirección de los datos.

Consulte Técnica de registro (RECtech) para obtener una lista de valores válidos de técnicas de registro.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

LIST=listaddr

De manera opcional, especifica la dirección de la lista de elementos.

listaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Cada elemento de esta lista es una dirección de unidad de 2 bytes (ccua).

Un formato especial de este parámetro, LIST=* indica a ACSRQ que la lista ya se ha anexado al área de datos de ACSINT y que no es necesario moverla.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

SCRATCH=YES

De manera opcional, especifica que la solicitud es para un volumen (reutilizable) no específico. Se selecciona un VOLSER reutilizable en este momento y se monta en el transporte especificado.

Se debe especificar SCRATCH=YES o VOLSER.

SUBPOOL=subpoolname

De manera opcional, especifica la dirección de un campo de 13 caracteres que contiene el nombre de la subagrupación reutilizable.

subpoolname es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. SCRPOOL (índice de subagrupación) ya no se admite; debe usar el parámetro SUBPOOL para seleccionar una agrupación reutilizable.

SUBPOOL es válido solamente si se especifica SCRATCH=YES.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

VOLSER=voladdr

De manera opcional, especifica la dirección de una etiqueta de volumen de 6 caracteres.

voladdr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Se debe especificar VOLSER o SCRATCH=YES. Este parámetro especifica el VOLSER del volumen que se montará. Se debe especificar VOLSER o SCRATCH=YES.

Respuesta de solicitud

La respuesta de QDRLIST contiene una cabecera de respuesta y una sección de información de unidades. Si se especificó VOLSER, la respuesta también contiene un elemento de información de volumen.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

QSCRATCH

La solicitud de QSCRATCH permite obtener información detallada acerca de todos los LSM asociados con la biblioteca o con un ACS determinado. Esta información incluye el número de volúmenes reutilizables en cada LSM.

Consideraciones

Cuando la biblioteca y el juego de datos de control asociado son compartidos por más de un HSC, los totales de volúmenes reutilizables informados pueden ser diferentes de los totales verdaderos, ya que no pueden contabilizar la actividad de los volúmenes recientes en otros procesadores. Sin embargo, cada HSC refresca sus totales de volúmenes reutilizables desde el juego de datos de control cada cinco minutos, de modo que la variación debe ser mínima.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ QSCRATCH:

Figura 9-10 Sintaxis de la solicitud de ACSRQ QSCRATCH

Parámetros

La solicitud de ACSRQ QSCRATCH incluye los siguientes parámetros:

ACSID=acsidaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

MEDIA=medaddr

De manera opcional, especifica la dirección de un campo de carácter de 8 bytes que contiene el tipo de medio del cartucho reutilizable solicitado.

Si no se especifica MEDia, los cartuchos reutilizables se seleccionarán sin considerar el tipo de medio.

medaddr es una dirección de datos de tipo RX o el número del registro de (2) a (12) que contiene la dirección de los datos.

Consulte Tipo de medio (MEDia) para obtener una lista de tipos de medios válidos.

RECTECH=recaddr

De manera opcional, especifica la dirección de un campo de 8 bytes que contiene la técnica de registro usada para registrar las pistas de datos en la superficie de la cinta.

Este parámetro es opcional. Si no se especifica RECtech, los cartuchos reutilizables se seleccionan según el tipo de MEDia que se ha especificado.

recaddr es una dirección de datos de tipo RX o el número del registro de (2) a (12) que contiene la dirección de los datos.

Consulte Técnica de registro (RECtech) para obtener una lista de valores válidos de técnicas de registro.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

SUBPOOL=subpoolname

De manera opcional, especifica la dirección de un campo de 13 caracteres que contiene el nombre de la subagrupación reutilizable.

subpoolname es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. SCRPOOL (índice de subagrupación) ya no se admite; debe usar el parámetro SUBPOOL para seleccionar una agrupación reutilizable.

SUBPOOL es válido solamente si se especifica SCRATCH=YES.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

Respuesta de solicitud

La respuesta de QSCRATCH contiene una cabecera de respuesta y un elemento de información del LSM para cada LSM.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

QVOLUME

La solicitud de QVOLUME permite obtener el estado de la biblioteca actual de uno o más cartuchos (hasta 500).

Consideraciones

La longitud de la respuesta puede variar considerablemente, según el número de volúmenes especificados en la solicitud. Hay disponibles varios valores en la respuesta de una solicitud de QCONFIG para uso en la determinación de la longitud del buffer de respuesta adecuada para una solicitud de QVOLUME. Los valores incluyen:

- SLXZQVOL contiene la longitud de una respuesta de QVOLUME para un único volumen. Use este valor para la longitud del buffer de respuesta cuando una solicitud de QVOLUME especifique VOLSER= o COUNT=1.

- SLXXVOLL contiene la longitud de un único elemento de información de volumen. Cuando una solicitud de QVOLUME especifica COUNT=n, la longitud del buffer de respuesta se calcula mediante la fórmula: (((n-1)*SLXXVOLL)+SLXZQVOL).

- SLXZVOL contiene la longitud de una respuesta de QVOLUME cuando el número máximo de VOLSER (500) se especifica en la lista de solicitudes. Use este valor para la longitud del buffer de respuesta cuando la fórmula de arriba no se pueda usar y cuando el solicitante pueda comprometer una cantidad mayor de almacenamiento (aproximadamente 16 KB) para la solicitud.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ QVOLUME:

Figura 9-11 Sintaxis de la solicitud de ACSRQ QVOLUME

Parámetros

La solicitud de ACSRQ QVOLUME incluye los siguientes parámetros:

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

COUNT=countid

De manera opcional, especifica la dirección de un campo de 2 bytes que contiene el número de CAPID en la lista designada por el parámetro LIST.

countaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

COUNT es obligatorio con el parámetro LIST.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

LIST=listaddr

De manera opcional, especifica la dirección de la lista de elementos.

listaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Cada elemento de esta lista es una dirección de unidad de 2 bytes (ccua).

Un formato especial de este parámetro, LIST=* indica a ACSRQ que la lista ya se ha anexado al área de datos de ACSINT y que no es necesario moverla.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

VOLSER=voladdrid

De manera opcional, especifica la dirección de una etiqueta de volumen de 6 caracteres.

voladdr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Se debe especificar VOLSER o SCRATCH=YES. Este parámetro especifica el VOLSER del volumen que se montará. Se debe especificar VOLSER o SCRATCH=YES.

Respuesta de solicitud

La respuesta de QVOLUME consiste de una cabecera de respuesta y un elemento de información de volumen para cada VOLSER especificado en la solicitud. Los elementos de información de volumen aparecen en el mismo orden que los VOLSER en la solicitud.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

QVOLUSE

La solicitud de QVOLUSE permite obtener el estado actual de los volúmenes montados.

Consideraciones

La longitud de la respuesta puede variar considerablemente, según el número de volúmenes devueltos por la solicitud.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ QVOLUSE:

Figura 9-12 Sintaxis de la solicitud de ACSRQ QVOLUSE

Parámetros

La solicitud de ACSRQ QVOLUSE incluye los siguientes parámetros:

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

Respuesta de solicitud

La respuesta de QVOLUSE consiste de una cabecera de respuesta y un elemento de información de volumen para cada VOLSER devuelto por la solicitud. Los elementos de información de volumen aparecen en el mismo orden que los VOLSER devueltos por la solicitud.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

SCRATCH

La solicitud de SCRATCH hace que se coloque un volumen en el estado reutilizable en el juego de datos de control del servidor.

Consideraciones

El cartucho especificado ya debe estar en la biblioteca. No se produce ningún movimiento de cartuchos como resultado de una solicitud de SCRATCH. Sin embargo, le procesamiento de la solicitud de SCRATCH debe seleccionar el cartucho (es decir, debe adquirir el uso exclusivo del cartucho) para cambiar el estado. Como resultado, fallará la solicitud de SCRATCH si el cartucho está montado en una unidad.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ SCRATCH:

Figura 9-13 Sintaxis de la solicitud de ACSRQ SCRATCH

Parámetros

La solicitud de ACSRQ SCRATCH incluye los siguientes parámetros:

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

VOLSER=voladdr

De manera opcional, especifica la dirección de una etiqueta de volumen de 6 caracteres.

voladdr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Se debe especificar VOLSER o SCRATCH=YES. Este parámetro especifica el VOLSER del volumen que se montará. Se debe especificar VOLSER o SCRATCH=YES.

Respuesta de solicitud

La respuesta a SCRATCH contiene solamente una cabecera de respuesta.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

SELSCR

La solicitud de SELSCR hace que el servidor seleccione un volumen reutilizable de la biblioteca y lo elimine del estado reutilizable en el juego de datos de control.

Consideraciones

No se produce ningún movimiento de volúmenes.

Si no se especifica ACSID ni DRIVE, el HSC busca en todos los LSM de la biblioteca y elige un volumen reutilizable del LSM que contiene la mayoría de los volúmenes reutilizables. Si se especifica ACSID, el HSC elige un volumen reutilizable del LSM en el ACS especificado que contiene la mayoría de los cartuchos. Si se especifica DRIVE, el HSC elige un volumen reutilizable desde el LSM más cercano, si la unidad está en un LSM de modo automático.

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ SELSCR:

Figura 9-14 Sintaxis de la solicitud de ACSRQ SELSCR

Parámetros

La solicitud de ACSRQ SELSCR incluye los siguientes parámetros:

ACSID=acsidaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

ACSDRIVE=driveaddr

De manera opcional, especifica la dirección de la especificación de unidad de 2 bytes (ccua).

driveaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

DRIVE se excluye mutuamente con ACSID. Especifica la unidad que deberá estar cerca del volumen reutilizable.

MEDIA=medaddr

De manera opcional, especifica la dirección de un campo de carácter de 8 bytes que contiene el tipo de medio del cartucho reutilizable seleccionado. Si no se especifica MEDIA, los cartuchos reutilizables se seleccionarán sin considerar el tipo de medio.

medaddr es una dirección de datos de tipo RX o el número del registro de (2) a (12) que contiene la dirección de los datos.

Consulte Tipo de medio (MEDia) para obtener una lista de tipos de medios válidos.

RECTECH=recaddr

De manera opcional, especifica la dirección de un campo de 8 bytes que contiene la técnica de registro usada para registrar las pistas de datos en la superficie de la cinta.

Si no se especifica RECtech, los cartuchos reutilizables se seleccionan según el tipo de MEDia que se ha especificado.

recaddr es una dirección de datos de tipo RX o el número del registro de (2) a (12) que contiene la dirección de los datos.

Consulte Técnica de registro (RECtech) para obtener una lista de valores válidos de técnicas de registro.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

SUBPOOL=subpoolname

De manera opcional, especifica la dirección de un campo de 13 caracteres que contiene el nombre de la subagrupación reutilizable.

subpoolname es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. SCRPOOL (índice de subagrupación) ya no se admite; debe usar el parámetro SUBPOOL para seleccionar una agrupación reutilizable.

SUBPOOL es válido solamente si se especifica SCRATCH=YES.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

Respuesta de solicitud

La respuesta de SELSCR contiene una cabecera de respuesta y un elemento de información de volumen. La cabecera de respuesta contiene un código de retorno (SLXCMDRC) que indica el éxito de la operación. El elemento de información de volumen describe el volumen seleccionado.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

UNSCRATCH

La solicitud de UNSCRATCH hace que se extraiga un volumen del estado reutilizable en el juego de datos de control.

Consideraciones

Una solicitud de marcar como no reutilizable un volumen no definido en el juego de datos de control se considera no válido.

Para los volúmenes reales, no se produce ningún movimiento de cartuchos debido a la solicitud de UNSCRATCH. Sin embargo, el procesamiento de la solicitud de UNSCRATCH debe seleccionar el volumen (es decir, debe adquirir el uso exclusivo del volumen) para cambiar el estado. Como resultado, la solicitud de UNSCRATCH fallará si se monta el volumen en una unidad real o virtual (consulte Consideraciones).

Sintaxis de

En la siguiente figura, se muestra la sintaxis de la solicitud de ACSRQ UNSCRATCH:

Figura 9-15 Sintaxis de la solicitud de ACSRQ UNSCRATCH

Parámetros

La solicitud de ACSRQ UNSCRATCH incluye los siguientes parámetros:

ACSINT=acsintaddr

Especifica la dirección del área de datos que se envía a la máquina de servicio del cliente de VM. Este parámetro es obligatorio.

acsintaddr es una dirección de datos de tipo RX o el número de registro que contiene la dirección de los datos. ACSRQ hace referencia a ACSINT en esta dirección cuando se completan los datos.

HOSTID=hostidaddr

De manera opcional, especifica la dirección de un ID de host de ocho caracteres, alineada a la izquierda y completada con espacios en blanco. Si no se especifica este parámetro, se usa el ID de host que ejecuta la solicitud.

hostidaddr es una dirección de ID de host de tipo RX o el registro de (2) a (12) que contiene la dirección del ID del host.

IPARML=YES

De manera opcional, especifica que el solicitante ha establecido la capacidad de direccionar a un IUCV IPARML y que se ha inicializado IPARML.

PATHID=pathadr

De manera opcional, especifica la dirección de un ID de ruta de 2 bytes de IUCV de la máquina de servicio de la biblioteca.

pathadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND PATHID.

PATHID es válido solamente si se especifica IPARML=YES. Si no se especifica PATHID, el siguiente IUCV SEND deberá especificarlo.

RSPADDR=bufadr

De manera opcional, especifica la dirección del buffer de respuesta IUCV.

bufadr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSBUF.

RSPADDR es válido solamente si se especifica IPARML=YES. Si no se especifica RSPADDR, el siguiente IUCV SEND deberá especificarlo.

RSPLEN=buflen

De manera opcional, especifica la dirección de la longitud del buffer de respuesta IUCV.

buflen es una dirección de tipo RX del campo de 2 bytes o el número de registro que contiene la dirección de los datos. Estos datos se usan en la sentencia IUCV SEND ANSLEN.

RSPLEN es válido solamente si se especifica IPARML=YES. Si no se especifica RSPLEN, el siguiente IUCV SEND deberá especificarlo. La longitud de la respuesta debe ser, por lo menos, el valor devuelto en SLXZDISM por QCONFIG.

USER=useridaddr

De manera opcional, especifica un ID de usuario de 8 bytes asociado con un ID de consola para la solicitud.

useridaddr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Si no se especifica USER, se usa el ID de usuario que ejecuta la solicitud.

VOLSER=voladdr

De manera opcional, especifica la dirección de una etiqueta de volumen de 6 caracteres.

voladdr es una dirección de datos de tipo RX o el número del registro que contiene la dirección de los datos.

Se debe especificar VOLSER o SCRATCH=YES. Este parámetro especifica el VOLSER del volumen que se montará. Se debe especificar VOLSER o SCRATCH=YES.

Respuesta de solicitud

La respuesta a UNSCRATCH contiene solamente una cabecera de respuesta.

Consulte Asignación de la macro de SLX para obtener información sobre la macro de SLX.

Áreas de datos de interfaz

Esta sección describe las áreas de datos de interfaz para la macro de SLX.

Macro de SLX

La respuesta siempre comienza con una cabecera. Es posible que la cabecera esté seguida por una o más "secciones". Cada sección es una tabla de ”elementos’’ de un tipo particular (por ejemplo, elemento de información de volumen). Si la cabecera de respuesta está alineada con un límite de palabra doble, se garantizará que todas las secciones y los elementos subsiguientes comiencen con límites de palabra doble.

Se define un directorio de sección (número/desplazamiento/longitud) en la cabecera de respuesta para cada tipo de sección posible, incluso aunque ninguna respuesta contenga alguna vez todos los tipos de secciones. El orden en el que aparecen los directorios de sección dentro de la cabecera no tiene relación con el orden en el que se organizan físicamente las secciones después de la cabecera.

El número de directorio de la sección especifica cuántos elementos de ese tipo están realmente presentes en la respuesta. Si el número del directorio de la sección es diferente a cero, el desplazamiento del directorio de la sección especifica el desplazamiento, desde el inicio de la cabecera de respuesta, al primer (o único) elemento de ese tipo. Si el número del directorio de la sección es mayor que uno, la longitud del directorio de la sección, que especifica la longitud de un único elemento de ese tipo, se deberá usar para acceder al segundo elemento y a los elementos subsiguientes de ese tipo. Por ejemplo, agregue la longitud del desplazamiento para obtener el desplazamiento al segundo elemento; agregue nuevamente la longitud para obtener el desplazamiento al tercer elemento y así sucesivamente. El número de elementos de cada sección varía. Las siguientes tablas denotan cuáles secciones de la respuesta se devolverán para una solicitud determinada.

La siguiente tabla proporciona una matriz de parámetros de la macro de SLS:

Tabla 9-1 Macro de SLS: matriz de parámetros

Sección de respuesta

Cabecera

Configuración

CAP

Volumen

Unidad

LSM

Texto de mensaje

DISMOUNT

1

N/D

N/D

N/D

N/D

N/D

1

EJECT

1

N/D

N/D

*

N/D

N/D

*

MOUNT

1

N/D

N/D

1 (si es reutilizable)

N/D

N/D

1

MOVE

1

N/D

N/D

1 (si es correcto)

N/D

N/D

1

QCAP

1

N/D

1+

N/D

N/D

N/D

N/D

QCONFIG

1

1

N/D

N/D

N/D

N/D

N/D

QDRIVES

1

N/D

N/D

N/D

1+

1+

N/D

QDRLIST

1

N/D

N/D

1 (si no es reutilizable)

1+

N/D

N/D

QEJECT

1

N/D

N/D

N/D

N/D

N/D

N/D

QREQUEST

1

N/D

N/D

N/D

N/D

N/D

N/D

QSCRATCH

1

N/D

N/D

N/D

N/D

N/D

N/D

QVOLUME

1

N/D

N/D

*

N/D

N/D

N/D

QVOLUSE

1

N/D

N/D

*

N/D

N/D

N/D

SCRATCH

1

N/D

N/D

N/D

N/D

1+

N/D

SELSCR

1

N/D

N/D

1

N/D

N/D

N/D

UNSCRATCH

1

N/D

N/D

N/D

N/D

N/D

N/D

Nota:

- 1 es igual a 1 y solamente a 1.

- * (EJECT y QVOLUME) son limitados por el número de elementos de información de volumen contenidos en el área de respuesta de SLX (máximo de 500).

- 1+ indica un número de 1 a n, según la configuración de la biblioteca.

Asignación de la macro de SLX

En el siguiente ejemplo, se muestra la salida del formato de registro de SLX:

Ejemplo 9-4 Formato de registro de SLX

SLX - VM CLIENT EXTERNAL INTERFACE REPLY
FUNCTION:
MAPS A REPLY AREA RETURNED BY ONE OF THE FOLLOWING VM CLIENT REQUESTS:
DISMOUNT - DISMOUNT A VOLUME
EJECT - EJECT A VOLUME FROM THE LIBRARY
MOUNT - MOUNT A VOLUME
MOVE - MOVE A VOLUME
QCAP - RETURN CAP SUMMARY
QCONFIG - RETURN CONFIGURATION SUMMARY
QDRIVES - RETURN DRIVE AND LSM INFORMATION
QDRLIST - RETURN DRIVE INFORMATION, ORDERED BY PREFERENCE
QSCRATCH - RETURN LSM INFORMATION, ORDERED BY PREFERENCE
QVOLUME - RETURN VOLUME INFORMATION
SCRATCH - CHANGE A VOLUME’S STATUS TO ’SCRATCH’
SELSCR - SELECT A SCRATCH VOLUME

SPECIAL CONSIDERATIONS:
A REPLY ALWAYS BEGINS WITH A HEADER. THE HEADER MAY BE FOLLOWED BY ONE OR MORE ”SECTIONS”. EACH SECTION IS A TABLE OF ”ELEMENTS” OF A PARTICULAR TYPE (E.G. VOLUME INFORMATION ELEMENT). IF THE REPLY HEADER IS ALIGNED ON A DOUBLEWORD BOUNDARY, THEN ALL SUBSEQUENT SECTIONS AND ELEMENTS ARE GUARANTEED TO ALSO BEGIN ON DOUBLEWORD BOUNDARIES.

A SECTION DIRECTORY (NUMBER/OFFSET/LENGTH) IS DEFINED IN THE REPLY HEADER FOR EACH POSSIBLE SECTION TYPE, EVEN THOUGH NO REPLY WILL EVER CONTAIN ALL TYPES OF SECTIONS. THE ORDER IN WHICH THE SECTION DIRECTORIES APPEAR WITHIN THE HEADER HAS NO RELATIONSHIP TO THE ORDER IN WHICH SECTIONS ARE PHYSICALLY ARRANGED AFTER THE HEADER.

A SECTION DIRECTORY’S NUMBER SPECIFIES HOW MANY ELEMENTS OF THAT TYPE ARE ACTUALLY PRESENT IN THE REPLY. IF A SECTION DIRECTORY’S NUMBER IS NONZERO, THEN THAT SECTION DIRECTORY’S OFFSET SPECIFIES THE OFFSET, FROM THE START OF THE REPLY HEADER, TO THE FIRST (OR ONLY) ELEMENT OF THAT TYPE. IF A SECTION DIRECTORY’S NUMBER IS GREATER THAN ONE, THEN THAT SECTION DIRECTORY’S LENGTH, WHICH SPECIFIES THE LENGTH OF A SINGLE ELEMENT OF THAT TYPE, MUST BE USED TO ACCESS THE SECOND AND SUBSEQUENT ELEMENTS OF THAT TYPE: ADD THE LENGTH TO THE OFFSET TO GET THE OFFSET TO THE SECOND ELEMENT; ADD IN THE LENGTH AGAIN TO GET THE OFFSET TO THE THIRD ELEMENT; AND SO ON.

HEADER
DEC    HEX     TYPE          LENGTH     LABEL        DESCRIPTION
0      (0)      STRUCTURE               SLX
0      (0)      AREA          1         SLXRPLY      REPLY HEADER
0      (0)      CHARACTER     3         SLXHID       HEADER IDENTIFIER
3      (3)      A-ADDR        1         SLXCMDRC     RETURN CODE:
0      (00)     CONST                   SLXROK       REQUEST PROCESSED
SUCCESSFULLY

4      (04)     CONST                   SLXRWARN     REQUEST SUCCESSFUL WITH
WARNING SLXSRC WILL
PROVIDE THE SPECIFIC
REASON FOR THE WARNING

DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
8      (08)     CONST                    SLXRBADP    REQUEST FAILED; THE REQUEST
BLOCK (MAPPED BY ACSINT)
CONTAINED INVALID DATA (E.G.,
INCOMPATIBLE OPTIONS); SLXSRC
(REASON CODE) WILL PROVIDE
THE OFFSET OF THE ACSINT
FIELD FOUND TO BE IN ERROR.

DEC    HEX      TYPE          LENGTH     LABEL       DESFRIPTION
12     (0C)     CONST                    SLXRIERR    REQUEST FAILED; AN
UNRECOVERABLE INTERNAL ERROR
OCCURRED WHILE PROCESSING THE
REQUEST.

DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
16     (10)     CONST                    SLXRFAIL    REQUEST FAILED; SLXSRC WILL
PROVIDE THE SPECIFIC REASON
FOR THE FAILURE.
20     (14)     CONST                    SLXRNHSC    REQUEST FAILED - HSC NOT
AVAILABLE

44     (2C)     CONST                    SLXRBADL    REQUEST FAILED; REPLY AREA
PROVIDED BY REQUESTOR WAS TOO
SMALL TO CONTAIN ALL REPLY
DATA ASSOCIATED WITH THE
REQUEST. IF FIELD SLXCRLN IS
NON-ZERO, IT CONTAINS THE
LENGTH VALUE THAT SHOULD BE
SPECIFIED FOR THE REPLY AREA
FOR THIS REQUEST.

48     (30)     CONST                    SLXRNVCI    VCIRQST AND VCIRESP NOT
SUPPORTED. EITHER VTCS IS NOT
INSTALLED - OR - IS NOT AT
THE REQUIRED LEVEL TO SUPPORT
THE PGMI VCI RESPONSES.

DEC    HEX      TYPE          LENGTH     LABEL
4      (04)     A-ADDR        1          SLXVERS     REPLY VERSION CODE:
7      (07)     CONST         3          SLXVCODE    THIS IS VERSION 9 OF THE
REPLY AREA.
5      (5)      HEXSTRING     4          -RESERVED-  RESERVED.
8      (8)      SIGNED-FWORD             SLXSRC      REASON CODE FOR FAILED
OPERATION.
32818  (8032)   CONST                    SLXTINTR    PGMI TASK INTERRUPTED.
32822  (8036)   CONST                    SLXSANF     SEARCH ARGUMENT NOT FOUND.
32826  (803A)   CONST                    SLXMSTT     MISMATCHED TOKEN TYPES.
32832  (8040)   CONST                    SLXTRNF     TOKEN AREA NOT FOUND.
32848  (8050)   CONST                    SLXSFUL     REPLY AREA FULL.
32849  (8051)   CONST                    SLXDVMM     MEDIA INCOMPATIBLE WITH
DEVICE TYPE.
12     (C)      SIGNED-FWORD  4          SLXCRLN     IF RETURN CODE (SLXCMDRC) IS
2C (SLXRBADL), THEN THIS
FIELD CONTAINS EITHER THE
MINIMUM ACCEPTABLE REPLY AREA
LENGTH FOR THE REQUEST, OR 0
IF THE MINIMUM LENGTH
COULDN’T BE DETERMINED.
OTHERWISE (I.E., RETURN CODE
ISN’T 2C), THIS FIELD
CONTAINS THE ACTUAL LENGTH OF
THIS REPLY.
16     (10)     SIGNED-FWORD  4          SLXPEOFF    PARAMETER ERROR OFFSET IF
SLSXRC <> 0 THEN THIS POINTS
TO AN ELEMENT IN A LIST WHERE
PROCESSING STOPPED WHEN THE
REQUEST WAS ”QCAP”.
20     (14)     LENGTH                   SLXHL       TO MAKE COMPATIBLE WITH MVS
CODE

CONFIGURATION SUMMARY SECTION DIRECTORY
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
20     (14)     SIGNED-FWORD  4          SLXXCFGN    NUMBER OF CONFIGURATION
ELEMENTS PRESENT IN THIS
REPLY.
24     (18)     SIGNED-FWORD  4          SLXXCFGO    OFFSET TO CONFIGURATION
SECTION, FROM START OF REPLY,
OR 0 IF REPLY DOESN’T CONTAIN
ANY CONFIGURATION ELEMENTS.
28     (1C)     SIGNED-FWORD  4          SLXXCFGL    LENGTH OF A
CONFIGURATION ELEMENT.

VOLUME INFORMATION SECTION DIRECTORY
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
32     (20)     SIGNED-FWORD  4          SLXXVOLN    NUMBER OF VOLUME ELEMENTS
PRESENT IN THIS REPLY.
36     (24)     SIGNED-FWORD  4          SLXXVOLO    OFFSET TO VOLUME SECTION,
FROM START OF REPLY, OR 0 IF
REPLY DOESN’T CONTAIN ANY
VOLUME ELEMENTS.
40     (28)     SIGNED-FWORD  4          SLXXVOLL    LENGTH OF A VOLUME ELEMENT.

DRIVE INFORMATION SECTION DIRECTORY
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION

44     (2C)     SIGNED-FWORD  4          SLXXDRVN    NUMBER OF DRIVE ELEMENTS
PRESENT IN THIS REPLY.
48     (30)     SIGNED-FWORD  4          SLXXDRVO    OFFSET TO DRIVE SECTION, FROM
START OF REPLY, OR 0 IF REPLY
DOESN’T CONTAIN ANY DRIVE
ELEMENTS.
52     (34)     SIGNED-FWORD  4          SLXXDRVL    LENGTH OF A DRIVE ELEMENT.

LSM INORMATION SECTION DIRECTORY
DEC    HEX     TYPE           LENGTH     LABEL       DESCRIPTION

56    (38)      SIGNED-FWORD  4          SLXXLSMN    NUMBER OF LSM ELEMENTS
PRESENT IN THIS REPLY
60    (3C)      SIGNED-FWORD  4          SLXXLSMO    OFFSET TO LSM SECTION, FROM
START OF REPLY, OR 0 IF REPLY
DOESN’T CONTAIN ANY LSM
ELEMENTS.
64    (40)      SIGNED-FWORD  4          SLXXLSML    LENGTH OF AN LSM ELEMENT.

MESSAGE TEXT SECTION DIRECTORY
WARNING: THIS DIRECTORY DOES NOT EXIST WHEN THE VALUE IN THE REPLY VERSION NUMBER FIELD, SLXVERS, IS LESS THAN 2.
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
68     (44)     SIGNED-FWORD  4          SLXXMSGN    NUMBER OF MESSAGE ELEMENTS
PRESENT IN THIS REPLY.
72     (48)     SIGNED-FWORD  4          SLXXMSGO    OFFSET TO MESSAGE SECTION,
FROM START OF REPLY, OR 0 IF
REPLY DOESN’T CONTAIN ANY
MESSAGE ELEMENTS.
76     (4C)     SIGNED-FWORD  4          SLXXMSGL    LENGTH OF A MESSAGE ELEMENT

QCAP INFORMATION SECTION DIRECTORY
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION

80    (50)      SIGNED-FWORD  4          SLXXCAPN    NUMBER OF CAP ELEMENTS
PRESENT IN THIS REPLY.
84    (54)      SIGNED-FWORD  4          SLXXCAPO    OFFSET TO CAP SECTION FROM
START OF REPLY.
88    (58)      SIGNED-FWORD  4          SLXXCAPL    LENGTH OF A CAP ELEMENT.
CONFIGURATION SUMMARY ELEMENT
THIS ELEMENT APPEARS IN THE
REPLY TO A QCONFIG REQUEST
AND SUPPLIES SUMMARY
INFORMATION ABOUT THE LIBRARY
AND ABOUT REPLY LENGTHS
NECESSARY FOR OTHER TYPES OF
REQUESTS.
0    (0)        STRUCTURE                SLXSCFG     CONFIGURATION SUMMARY
ELEMENT.
0    (0)        CHARACTER     3          SLXLID      ELEMENT IDENTIFIER.
3    (3)        HEXSTRING     1          -RESERVED-  RESERVED.
4    (4)        CHARACTER     8          SLXLHNAM    HOST NAME.
12   (C)        SIGNED-FWORD  4          SLXLHHBT    HOST PULSE VALUE.
16   (10)       SIGNED-FWORD  4          SLXLRSTM    RESERVE TIMEOUT LIMIT.
20   (14)       CHARACTER     8          SLXLQNAM    ENQ MAJOR NAME.
28   (1C)       CHARACTER     8          SLXLEJPS    EJECT COMMAND PASSWORD
(ENCRYPTED)
36   (24)       CHARACTER     1          SLXLCMPF    COMMAND PREFIX CHARACTER.
37   (25)       A-ADDR        1          SLXLSCLB    LIBRARY DEFAULT SCRATCH LABE
L TYPE CODE:
1    (01)       CONST                    SLXLLBSL    STANDARD (SL).
2    (02)       CONST                    SLXLLBAL    ASCII (AL).
3    (03)       CONST                    SLXLLBNL    NON-LABELED (NL).
4    (04)       CONST                    SLXLLBNS    NON-STANDARD LABEL (NSL)
38   (26)       A-ADDR        1          SLXLSMF     SMF RECORD TYPE
39   (27)       HEXSTRING     1          -RESERVED-  RESERVED.
40   (28)       SIGNED-FWORD  4          SLXQMDR     LARGEST NUMBER OF DRIVES IN
ANY ACS.
44   (2C)       SIGNED-FWORD  4          SLXQDRCT    NUMBER OF DRIVES IN THE
LIBRARY.
48   (30)       SIGNED-FWORD  4          SLXQACNT    NUMBER OF ACSS IN THE
LIBRARY.
52   (34)       SIGNED-FWORD  4          SLXQLCNT    NUMBER OF LSMS IN THE
LIBRARY.
56   (38)       SIGNED-FWORD  4          SLXZVOL     MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QVOLUME REQUEST THAT
SPECIFIES THE LARGEST
SUPPORTED NUMBER OF VOLUMES
(500).
60   (3C)       SIGNED-FWORD  4          SLXZQDRV    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QDRIVES REQUEST.
64   (40)       SIGNED-FWORD  4          SLXZQDRL    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QDRLIST REQUEST.
68   (44)       SIGNED-FWORD  4          SLXQVOL     MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QVOLUME REQUEST THAT
SPECIFIES ONLY 1 VOLUME.
72    (48)      SIGNED-FWORD  4          SLXZGSCR    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
SELSCR REQUEST.
76    (4C)      SIGNED-FWORD  4          SLXZMDM     MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
MOUNT REQUEST.
80    (50)      SIGNED-FWORD  4          SLXZQSCR    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QSCRATCH REQUEST.
84    (54)      SIGNED-FWORD  4          SLXZDISM    MAXIMUM LENGTH OF REPLY
DATA RETURNED IN RESPONSE TO
A DISMOUNT REQUEST.
88    (58)      SIGNED-FWORD  4          SLXZEJCT    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO AN
EJECT REQUEST THAT SPECIFIES
THE LARGEST SUPPORTED NUMBER
OF VOLUMES (500).
92    (5C)      SIGNED-FWORD  4          SLXZSCR     MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
SCRATCH REQUEST.

WARNING: THE REMAINING FIELDS OF THIS ELEMENT ARE AVAILABLE FOR VERSION(S) 3 AND
ABOVE.
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
108   (6C)      SIGNED-FWORD  4          SLXZMOVE    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO AN
MOVE REQUEST.
112   (70)      SIGNED-FWORD  4          SLXZEJC1    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO AN
EJECT REQUEST FOR ONLY 1
VOLUME.
WARNING: THE REMAINING FIELDS OF THIS ELEMENT ARE AVAILABLE FOR VERSION(S) 6 AND ABOVE.
DEC    HEX      TYPE          LENGTH     LABEL       DESCRIPTION
116   (74)      A-ADDR        4          SLXQUCSA    MVS -- ADDRESS OF SLSUXCSA.
120   (78)      SIGNED-FWORD  4          -RESERVED-  RESERVED.
124   (7C)      SIGNED-FWORD  4          SLXQLCAP    NUMBER OF CAPS IN LIBRARY.
128   (80)      SIGNED-FWORD  4          SLXEXLM0    ExLM R15
132   (84)      SIGNED-FWORD  4          SLXEXLM1    ExLM R1
136   (88)      SIGNED-FWORD  4          SLXEXLM2    ExLM R2
140   (8C)      SIGNED-FWORD  4          SLXZQCAP    MAXIMUM LENGTH OF REPLY DATA
RETURNED IN RESPONSE TO A
QCAP REQUEST.
156   (9C)      SIGNED-FWORD  4          -RESERVED-  RESERVED FUTURE USE.
160   (A0)      SIGNED-HWORD  2          SLXHSCV     HSC VERSION NUMBER
162   (A2)      HEXSTRING     6          -RESERVED-
168   (A8)      CONST                    SLXSCFGL    LENGTH OF A CONFIGURATION
ELEMENT.

QDSN INFORMATION ELEMENT
THIS ELEMENT APPEARS IN THE REPLY TO A QDSN REQUEST AND SUPPLIES SUMMARY INFORMATION ABOUT THE CURRENT REFERENCED DATASETS USED BY THE HSC.
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXDSNIM    DATASET INFORMATION MAP.
0     (0)       CHARACTER     3          SLXQDID     SECTION IDENTIFIER.
3     (03)      BITSTRING     1          SLXDSFLG    DATASET TYPE.
1     (01)      CONST                    SLXDSPRM    CDS PRIMARY.
2     (02)      CONST                    SLXDSSEC    CDS SECONDARY.
3     (03)      CONST                    SLXDSSBY    CDS STANDBY.
4     (04)      CONST                    SLXDSVAT    VOLUME ATTRIBUTES.
5     (05)      CONST                    SLXDSUAT    UNIT ATTRIBUTES.
6     (06)      CONST                    SLXDSTRQ    TAPEREQS.
7     (07)      CONST                    SLXDSPLB    PARMLIB.
8     (08)      CONST                    SLXDSJNP    PRIMARY JOURNAL.
9     (09)      CONST                    SLXDSJNA    ALTERNATE JOURNAL.
9     (09)      CONST                    SLXDSMAX    MAX NUMBER OF QDS RETURNED.
4     (04)      CHARACTER     44         SLXDSNAM    DATASET NAME.
48    (30)      CHARACTER     8          SLXDSMBR    MEMBER NAME.
56    (38)      CHARACTER     6          SLXDSVOL    VOLUME NAME.
62    (3E)      CHARACTER     8          SLXDSUNT    UNIT NAME.
70    (46)      CHARACTER     2          -RESERVED-  RESERVED.
72    (48)      CHARACTER     96         -RESERVED-  RESERVED.
168   (A8)      AREA          8          -RESERVED-  ALIGN
168   (A8)      LENGTH                   SLXDSNEL    LENGTH OF ONE DATASET ENTRY.

CAP INFORMATION ELEMENT
THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE LIBRARY CAP
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXSCAP
0     (0)       CHARACTER     4          SLXCID      SECTION IDENTIFIER.
4     (4)       HEXSTRING     1          SLXCACS     ACS ADDRESS.
5     (5)       HEXSTRING     1          SLXCLSM     LSM ADDRESS.
6     (6)       HEXSTRING     1          SLXCCAP     CAP NUMBER.
7     (7)       HEXSTRING     1          -RESERVED-  RESERVED.
8     (8)       AREA          2          SLXCSTAT    CAP STATUS.
8     (8)       BITSTRING     1          SLXCSTB1    CAP STATUS.
1... .... X’80’          SLXCSTCA    CAP IS ACTIVE.
.1.. .... X’40’          SLXCSTNR    CAP NEEDS RECOVERY.
..1. .... X’20’          SLXCSTAM    CAP IS IN AUTOMATIC MODE.
...1 .... X’10’          SLXCSTCL    CAP IS LINKED.
.... 1... X’08’          SLXCSTCO    CAP IS ONLINE.
9     (9)       BITSTRING     1          SLXCSTB2    CAP MODE.
1... .... X’80’          SLXCSTIE    CAP IS ENTERING.
.1.. .... X’40’          SLXCSTID    CAP IS DRAINING.
..1. .... X’20’          SLXCSTIJ    CAP IS EJECTING.
...1 .... X’10’          SLXCSTIC    CAP IS CLEANING.
.... 1... X’08’          SLXCSTII    CAP IS IDLE .
10   (A)        BITSTRING     1          SLXTYPE     TYPE OF CAP.
1... .... X’80’          SLXCTPC     PRIORITY CAP
.... ...1 X’01’          SLXCTCIM    CIMARRON
.... ..1. X’02’          SLXCTCLP    CLIPPER.
.... ..11 X’03’          SLXCTTWS    STANDARD CLIPPER
.... .1.. X’04’          SLXCTTWO    OPTIONAL CLIPPER
.... .1.1 X’05’          SLXCTTIM    (9740/TimberWolf)
12   (C)        SIGNED-HWORD  2          SLXCCELL    CELLS IN CAP.
14   (E)        HEXSTRING     1          SLXCNROW    ROWS.
15   (F)        HEXSTRING     1          SLXCNCOL    COLUMNS.
16   (10)       HEXSTRING     1          SLXCCMAG    MAGAZINES.
17   (11)       HEXSTRING     1          SLXCCMGC    CELLS IN MAGAZINE.
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
18    (12)      CHARACTER     8          SLXCJOB     JOBNAME OF OWNER.
26    (1A)      HEXSTRING     6          -RESERVED-  ALIGN TO DOUBLE WORD
32    (20)      CONST                    SLXSCAPL    LENGTH OF A CAP ELEMENT.

VOLUME INFORMATION ELEMENT
THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE VOLUME AND IS REPEATED FOR EACH VOLUME ASSOCIATED WITH A REQUEST. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS:
QDRLIST - RETURN DRIVE INFORMATION, ORDERED BY PREFERENCE
QVOLUME - RETURN VOLUME INFORMATION
SELSCR - SELECT A SCRATCH VOLUME
EJECT - EJECT VOLUMES
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXSVOL     VOLUME INFORMATION ELEMENT.
0     (0)       CHARACTER     3          SLXVID      ELEMENT IDENTIFIER.
3     (3)       BITSTRING     1          SLXVSTA     VOLUME STATUS:
1... .... X’80’          SLXVILB     VOLUME IS IN LIBRARY
. .1.. .... X’40’        SLXVOHST    VOLUME IS IN USE BY ANOTHER
HOST
. ..1. .... X’20’        SLXVSCR     VOLUME IS CONSIDERED SCRATCH
. ...1 .... X’10’        SLXVMAL     VOLUME IS IN MANUAL-MODE LSM.
.... 1... X’08’          SLXVDSC     VOLUME IS IN DISCONNECTED
ACS.
.... .1.. X’04’          SLXVMNT     VOLUME IS MOUNTED ON A DRIVE.
.... ..1. X’02’          SLXVERR     VOLUME IS ’ERRANT’ (I.E., ITS
LOCATION WITHIN THE LIBRARY
IS UNCERTAIN).
.... ...1 X’01’          SLXVTV      VOLUME IS A VTCS VIRTUAL
VOLUME
4     (4)       CHARACTER     6          SLXVSER     VOLUME SERIAL.
10    (A)       A-ADDR        1          SLXVLC      VOLUME LOCATION CODE:
0     (0)       CONST                    SLXVUNK     LOCATION DATA UNAVAILABLE
(SLXVLOC IS 0).
1     (1)       CONST                    SLXVCEL     LOCATION DATA DESCRIBES A
CELL.
2     (02)      CONST                    SLXVDRV     LOCATION DATA DESCRIBES A
DRIVE.
11    (B)       AREA          5          SLXVLOC     VOLUME LOCATION DATA:
11    (B)       A-ADDR        1          SLXVACS     ACS ID.
12    (C)       A-ADDR        1          SLXVLSM     LSM ID.
13    (D)       A-ADDR        3          SLXVPNL     CELL’S PANEL ID, ROW ID,
COLUMN ID.
13    (D)       A-ADDR        2          SLXVDRIV    DRIVE ADDRESS (0CUU).
15    (F)       BITSTRING     1          SLXVSTA2    MORE VOLUME STATUS: EQU X’E0’
RESERVED.
...1 .... X’10’          SLXVMLMU    VOLUME MEDIA TYPE CAME FROM
LMU. EQU X’08’ RESERVED.
.... .1.. X’04’          SLXVMUNR    VOLUME MEDIA TYPE UNREADABLE.
.... ..1. X’02’          SLXVMVLA    VOLUME MEDIA TYPE CAME FROM
VOLATTR.
.... ...1 X’01’          SLXVMDFL    VOLUME MEDIA TYPE DEFAULT
ASSIGNED.
16    (10)      AREA          8          SLXVTSSN    VTSS NAME
16    (10)      SIGNED-FWORD  4          SLXVDATI    HI-WORD OF TOD AT INSERTION.
20    (14)      SIGNED-FWORD  4          SLXVDATL    HI-WORD OF TOD LAST
SELECTION.
24    (18)      SIGNED-FWORD  4          SLXVSCNT    SELECTION COUNT.
28    (1C)      SIGNED-FWORD  4          SLXVDATD    HI-WORD OF TOD LAST MOUNT.
32    (20)      CHARACTER     8          SLXVMED     TYPE OF MEDIA.
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
40    (28)      CONST                    SLXSVOLN    LENGTH OF A VOLUME ELEMENT.
40    (28)      CONST                    SLXSVOLL    LENGTH OF A VOLUME ELEMENT.

DRIVE INFORMATION ELEMENT
THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE LIBRARY TAPE DRIVE AND IS REPEATED FOR EACH DRIVE ASSOCIATED WITH A REQUEST. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS:
QDRIVES - RETURN DRIVE AND LSM INFORMATION
QDRLIST - RETURN DRIVE INFORMATION, ORDEREDBY PREFERENCE
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXSDRV     DRIVE INFORMATION ELEMENT.
0     (0)       CHARACTER     3          SLXDID      ELEMENT IDENTIFIER
3     (3)       BITSTRING     1          SLXDSTA     LIBRARY STATUS:
...1 .... X’10’          SLXDMANU    LSM IS IN MANUAL MODE.
.... 1... X’08’          SLXDDISC    ACS IS DISCONNECTED.
4     (4)       A-ADDR        1          SLXQDEAC    ACS ID.
5     (5)       A-ADDR        1          SLXQDELS    LSM ID.
6     (6)       A-ADDR        2          SLXQDECU    DRIVE ADDRESS (0CUU).
8     (8)       CHARACTER     8          SLXQDRT     RECORDING TECHNIQUE OF DRIVE
16    (10)      CONST                    SLXSDRVL    LENGTH OF A DRIVE ELEMENT.

LSM INFORMATION ELEMENT
THIS ELEMENT SUPPLIES INFORMATION ABOUT A SINGLE LSM (LIBRARY STORAGE MODULE) AND IS REPEATED FOR EACH LSM ASSOCIATED WITH A REQUEST. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS:
QDRIVES - RETURN DRIVE AND LSM INFORMATION
QSCRATCH - RETURN LSM INFORMATION, ORDERED BY PREFERENCE
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXSLSM     LSM INFORMATION ELEMENT
0     (0)       CHARACTER     3          SLXMID      ELEMENT IDENTIFIER.
3     (3)       BITSTRING     1          SLXMSTAT    LIBRARY STATUS:
...1 .... X’10’          SLXMANUL    LSM IS IN MANUAL MODE
.... 1... X’08’          SLXMDISC    ACS IS DISCONNECTED.
4     (4)       A-ADDR        1          SLXMACS     ACS ID.
5     (5)       A-ADDR        1          SLXMLSM     LSM ID.
6     (6)       SIGNED-FWORD  1          SLXMADJN    NUMBER OF ADJACENT LSMS.
7     (7)       A-ADDR        1          SLXMADJ(4)  LIST OF LSM IDS OF ADJACENT
LSMS (ONLY THE FIRST N IDS
ARE VALID, WHERE N IS THE
VALUE IN SLXMADJN).
11    (B)       HEXSTRING     1          -RESERVED-  RESERVED.
12    (C)       SIGNED-FWORD  4          SLXMNSCR    NUMBER OF SCRATCH VOLUMES IN
THIS LSM.
16    (10)      SIGNED-FWORD  4          SLXMTCEL    TOTAL CELLS IN LSM.
20    (14)      SIGNED-FWORD  4          SLXMFCEL    FREE CELLS IN LSM.
24    (18)      CONST                    SLXSLSML    LENGTH OF AN LSM ELEMENT.

MESSAGE TEXT ELEMENTTHIS ELEMENT SUPPLIES THE COMPLETE TEXT OF THE MESSAGE WHOSE BINARY MESSAGE ID NUMBER IS REPORTED IN HEADER FIELD SLXSRC. THIS ELEMENT MAY APPEAR IN REPLIES TO THE FOLLOWING REQUESTS:DISMOUNT - DISMOUNT A VOLUMEMOUNT - MOUNT A VOLUMEMOVE - MOVE A VOLUMEEJECT - EJECT VOLUMES
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                SLXSMSG     MESSAGE TEXT ELEMENT.
0     (0)       CHARACTER     3          SLXGID      ELEMENT IDENTIFIER.
3     (3)       CHARACTER     125        SLXGTEXT    TEXT OF THE MESSAGE WHOSE
NUMBER IS IN FIELD SLXSRC OF
THE REPLY HEADER.
0     (0)       STRUCTURE                SLXSMSG
128   (80)      CONST                    SLXSMSGL    LENGTH OF A MESSAGE ELEMENT.

Referencia cruzada

En la siguiente tabla, se proporciona una referencia cruzada para la macro de SLX:

Tabla 9-2 Referencia cruzada de la macro de SLX

Nombre

Longitud

Valor de desplazamiento

SLXCACS

000001

04

SLXCCAP

000001

06

SLXCCELL

000002

0C

SLXCCMAG

000001

10

SLXCCMGC

000001

11

SLXCID

000004

00

SLXCJOB

000008

12

SLXCLSM

000001

05

SLXCMDRC

000001

03

SLXCNCOL

000001

0F

SLXCNROW

000001

0E

SLXCRLN

000004

0C

SLXCSTAM

N/D

20

SLXCSTAT

000002

08

SLXCSTB1

000001

08

SLXCSTB2

000001

09

SLXCSTCA

N/D

80

SLXCSTCL

N/D

10

SLXCSTCO

N/D

08

SLXCSTIC

N/D

10

SLXCSTID

N/D

40

SLXCSTIE

N/D

80

SLXCSTII

N/D

08

SLXCSTIJ

N/D

20

SLXCSTNR

N/D

40

SLXCTCIM

N/D

01

SLXCTCLP

N/D

02

SLXCTPC

N/D

80

SLXCTTIM

N/D

05

SLXCTTWO

N/D

04

SLXCTTWS

N/D

03

SLXCTYPE

000001

0A

SLXDDISC

N/D

08

SLXDID

000003

00

SLXDMANU

N/D

10

SLXDSFLG

000001

03

SLXDSJNA

N/D

09

SLXDSJNP

N/D

08

SLXDSMAX

N/D

09

SLXDSMBR

000008

30

SLXDSNAM

000044

04

SLXDSNEL

N/D

A8

SLXDSPLB

N/D

07

SLXDSPRM

N/D

01

SLXDSSBY

N/D

03

SLXDSSEC

N/D

02

SLXDSTA

000001

03

SLXDSTRQ

N/D

06

SLXDSUAT

N/D

05

SLXDSUNT

000008

3E

SLXDSVAT

N/D

04

SLXDSVOL

000006

38

SLXDVMM

N/D

8051

SLXEND

000008

B0

SLXEXLM0

000004

80

SLXEXLM1

000004

84

SLXEXLM2

000004

88

SLXGID

000003

00

SLXGTEXT

000125

03

SLXHID

000003

00

SLXHL

N/D

14

SLXHSCV

000002

A0

SLXL

N/D

B0

SLXLCMPF

000001

24

SLXLEJPS

000008

1C

SLXLHHBT

000004

0C

SLXLHNAM

000008

04

SLXLID

000003

00

SLXLLBAL

N/D

02

SLXLLBNL

N/D

03

SLXLLBNS

N/D

04

SLXLLBSL

N/D

01

SLXLOCKD

N/D

20

SLXLQNAM

000008

14

SLXLRSTM

000004

10

SLXLSCLB

000001

25

SLXLSMF

000001

26

SLXMACS

000001

04

SLXMADJI

000001

07

SLXMADJN

000001

06

SLXMANUL

N/D

10

SLXMDISC

N/D

08

SLXMFCEL

000004

14

SLXMID

000003

00

SLXMLSM

000001

05

SLXMNSCR

000004

0C

SLXMSTAT

000001

03

SLXMSTT

N/D

803A

SLXMTCEL

000004

10

SLXNORSP

N/D

28

SLXNTCB

N/D

1C

SLXPEOFF

000004

10

SLXQACNT

000004

30

SLXQDEAC

000001

04

SLXQDECU

000002

06

SLXQDELS

000001

05

SLXQDID

000003

00

SLXQDRCT

000004

2C

SLXQDRT

000008

08

SLXQID

000004

00

SLXQJTC

000004

08

SLXQJTD

N/D

00

SLXQJTL

N/D

18

SLXQJTN

N/D

FFFF

SLXQJTS

000002

0C

SLXQJTT

000004

04

SLXQJTV

000006

0E

SLXQLCAP

000004

7C

SLXQLCNT

000004

34

SLXQMDR

000004

28

SLXQUCSA

000004

74

SLXRBADL

N/D

2C

SLXRBADP

N/D

08

SLXRBTOK

N/D

3C

SLXREOV

N/D

34

SLXRFAIL

N/D

10

SLXRIERR

N/D

0C

SLXRNAUT

N/D

18

SLXRNHSC

N/D

14

SLXRNVCI

N/D

30

SLXROK

N/D

00

SLXRPLY

000001

00

SLXRVNV

N/D

38

SLXRWARN

N/D

04

SLXSANF

N/D

8036

SLXSCAPL

N/D

20

SLXSCFGL

N/D

A8

SLXSDRVL

N/D

10

SLXSFUL

N/D

8050

SLXSID

000004

00

SLXSLSML

N/D

18

SLXSMSGL

N/D

80

SLXSRC

000004

08

SLXSTPE

N/D

EE

SLXSTPK

N/D

00

SLXSTPL

N/D

10

SLXSTPN

N/D

FF

SLXSTPS

000001

09

SLXSTPT

000004

04

SLXSTPY

000001

08

SLXSVOLL

N/D

28

SLXSVOLN

N/D

28

SLXTINTR

N/D

8032

SLXTPROT

N/D

24

SLXTRNF

N/D

8040

SLXVACS

000001

0B

SLXVCEL

N/D

01

SLXVCODE

N/D

07

SLXVDATD

000004

1C

SLXVDATI

000004

10

SLXVDATL

000004

14

SLXVDRIV

000002

0D

SLXVDRV

N/D

02

SLXVDSC

N/D

08

SLXVERR

N/D

02

SLXVERS

000001

04

SLXVID

000003

00

SLXVILB

N/D

80

SLXVLC

000001

0A

SLXVLOC

000005

0B

SLXVLSM

000001

0C

SLXVMAL

N/D

10

SLXVMDFL

N/D

01

SLXVMED

000008

20

SLXVMLMU

N/D

10

SLXVMNT

N/D

04

SLXVMUNR

N/D

04

SLXVMVLA

N/D

02

SLXVOHST

N/D

40

SLXVPNL

000003

0D

SLXVSCNT

000004

18

SLXVSCR

N/D

20

SLXVSER

000006

04

SLXVSTA

000001

03

SLXVSTA2

000001

0F

SLXVTSSN

000008

10

SLXVTV

N/D

01

SLXVUNK

N/D

00

SLXXCAPL

000004

58

SLXXCAPN

000004

50

SLXXCAPO

000004

54

SLXXCFGL

000004

1C

SLXXCFGN

000004

14

SLXXCFGO

000004

18

SLXXDRVL

000004

34

SLXXDRVN

000004

2C

SLXXDRVO

000004

30

SLXXLSML

000004

40

SLXXLSMN

000004

38

SLXXLSMO

000004

3C

SLXXMSGL

000004

4C

SLXXMSGN

000004

44

SLXXMSGO

000004

48

SLXXQDSL

000004

7C

SLXXQDSN

000004

74

SLXXQDSO

000004

78

SLXXQJTL

000004

64

SLXXQJTN

000004

5C

SLXXQJTO

000004

60

SLXXSDL

N/D

B0

SLXXSTPL

000004

70

SLXXSTPN

000004

68

SLXXSTPO

000004

6C

SLXXVCIL

000004

88

SLXXVCIN

000004

80

SLXXVCIO

000004

84

SLXXVOLL

000004

28

SLXXVOLN

000004

20

SLXXVOLO

000004

24

SLXZDEFP

000004

60

SLXZDEFS

000004

64

SLXZDISM

000004

54

SLXZEJCT

000004

58

SLXZEJC1

000004

70

SLXZGSCR

000004

48

SLXZMDM

000004

4C

SLXZMOVE

000004

6C

SLXZQCAP

000004

8C

SLXZQDRL

000004

40

SLXZQDRV

000004

3C

SLXZQDSN

000004

98

SLXZQEJT

000004

90

SLXZQSCR

000004

50

SLXZQVOL

000004

44

SLXZSCR

000004

5C

SLXZSETO

000004

68

SLXZSTOP

000004

94

SLXZVOL

000004

38

Solicitud de DSECT ACSINT

ACSINT permite que se transmita información entre el TMS y la máquina de servicio del ACS. Es desarrollado por la macro de ACSRQ cuando se especifica DSECT=YES y se envía mediante el IUCV.

Nota:
El siguiente DSECT incluye algunos parámetros que no admite el cliente de VM. Se incluyen únicamente por motivos de compatibilidad y para brindar información completa.

En el siguiente ejemplo, se muestra la salida del formato de registro de ACSINT:

Ejemplo 9-5 Formato de registro de ACSINT

ACSINT - TMS INTERFACE REQUEST PARAMETER LIST
FUNCTION: THIS DEFINES THE DATA PASSED TO THE TMS VIA IUCV IT DEFINES THE VARIOUS FUNCTIONS THAT CAN BE REQUESTED AND THE STRUCTURE PASSED.
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
0     (0)       STRUCTURE                ACSINT      TMS INTERFACE PARAMETER LIST:
0     (0)       CHARACTER     4          ACSIHDR     PARAMETER LIST IDENTIFIER.
’ACSI’(C1C3E2C9)CHAR CONST               ACSIID
4     (4)       SIGNED-FWORD  4          ACSILEN     PARAMETER LIST LENGTH.
8     (8)       A-ADDR        1          ACSIVER     PARAMETER LIST VERSION
NUMBER.
7     (07)      CONST                    ACSIVN      CURRENT VERSION.
9     (9)       A-ADDR        1          ACSIRT      FUNCTION CODE:
0     (00)      CONST                    ACSINOOP    NOOP - NO OPERATION.
1     (01)      CONST                    ASCIRS01    RESERVED - MVS ONLY.
2     (02)      CONST                    ASCIRS02    RESERVED - MVS ONLY.
3     (03)      CONST                    ASCIRS03    RESERVED - MVS ONLY.
4     (04)      CONST                    ASCISTOP    STOP - STOP AN INTERRUPTABLE
PGMI TASK.
5     (05)      CONST                    ACSISOPR    SETOPER - SET OPERATOR
INTERACTION MODE.
20    (14)      CONST                    ACSIQCNF    QCONFIG - RETURN
CONFIGURATION SUMMARY.
21    (15)      CONST                    ACSIQDRV    QDRIVES - RETURN DRIVE AND
LSM INFO.
22    (16)      CONST                    ACSIQDRL    QDRLIST - RETURN DRIVE
INFORMATION, X .
23    (17)      CONST                    ACSIQSCR    QSCRATCH - RETURN SCRATCH
COUNT INFO.
24    (18)      CONST                    ACSIQVOL    QVOLUME - RETURN VOLUME
INFORMATION.
25    (19)      CONST                    ACSIQEJT    QEJECT - RETURN EJECT STATUS.
26    (1A)      CONST                    ACSIQCAP    QCAP - QUERY CAP STATUS.
27    (1B)      CONST                    ACSIQVLU    QVOLUSE - RETURN MOUNTED
VOLUMES.
28    (1C)      CONST                    ACSIQRQS    QREQUEST - RETURN PENDING
REQUESTS.
29    (1D)      CONST                    ACSIQDSN    QDSN - QUERY DATASET.
40    (29)      CONST                    ACSIMNT     MOUNT - MOUNT VOLUME.
41    (29)      CONST                    ACSIMOVE    MOVE - MOVE A CARTRIDGE TO AN
LSMID X.
42    (2A)      CONST                    ACSIDSM     DISMOUNT - DISMOUNT VOLUME.
43    (2B)      CONST                    ACSIEJCT    EJECT - EJECT A VOL FROM THE
LIBRARY.
60    (3C)      CONST                    ACSISSCR    SELSCR - SELECT A SCRATCH
VOLUME.
61    (3D)      CONST                    ACSISCRA    SCRATCH - CHANGE VOL STATUS
TO ’SCRATCH’.
62    (3E)      CONST                    ACSIUNSC    UNSCRATCH- CHANGE VOLUME
STATUS TO NOT X.
63    (3F)      CONST                    ACSIDSCR    DEFSCR - SPECIFY NO. OF
SCRATCH POOLS.
64    (40)      CONST                    ACSIDPOL    DEFPOOL - SPECIFY A SCRATCH
POOL’S VOLSER RANGE.
10    (A)       BITSTRING     1          ACSIFLG1    FLAG BYTE 1: (PGMI CONTROL 1)
1
1... .... X’80’          ACSIF180    RESERVED MVS OPTION=SYNC
.1.. .... X’40’          ACSIVUSR    USER= SPECIFIED; ACSIUSER
CONTAINS NAME
..1. .... X’20’          ACSIMANO    DIALOG=OFF SPECIFIED.
...1 .... X’10’          ACSIWTOR    DIALOG=ON SPECIFIED.
.... 1... X’08’          ACSINDEL    NOTIFY=INSDEL SPECIFIED.
.... .1.. X’04’          ACSINNDL    NOTIFY=NOINSDEL SPECIFIED.
.... ..1. X’02’          ACSIACC1    ACCT1= SPECIFIED ACCOUNTING
TOKEN.
.... ...1 X’01’          ACSIACC2    ACCT2= SPECIFIED ACCOUNTING
TOKEN.
11   (B)        HEXSTRING     1          ACSIFLG2    FLAG BYTE 2: (PGMI CONTROL
2).
12   (C)        BITSTRING     1          ACSIFLG3    FLAG BYTE 3: (MOVEMENT
CONTROL 1).
1... .... X’80’          ACSIVHST    ACSIHOST CONTAINS HOST_ID.
.1.. .... X’40’          ACSIVACS    ACSIACS CONTAINS AN ACSID.
..1. .... X’20’          ACSIVLSM    ACSILSMI CONTAINS LSMID.
...1 .... X’10’          ACSIVCAP    ACSICAP CONTAINS CAP_ID.
.... 1... X’08’          ACSIF308    RESERVED FUTURE USE.
.... .1.. X’04’          ACSIVVOL    ACSIVOLS CONTAINS A VOLSER.
.... ..1. X’02’          ACSIVLST    ACSILOFF CONTAINS LIST
OFFSET.
.... ...1 X’01’          ACSIVCNT    ACSICNT CONTAINS LIST COUNT.
13   (D)        BITSTRING     1          ACSIFLG4    FLAG BYTE 4: (MOVEMENT
CONTROL 2).
1... .... X’80’          ACSIVTLM    ACSITLSM CONTAINS TO LSM_ID.
.1.. .... X’40’          ACSIVTPN    ACSITPAN CONTAINS TO PANEL.
..1. .... X’20’          ACSIF420    RESERVED FUTURE USE.
...1 .... X’10’          ACSIF410    RESERVED FUTURE USE.
.... 1... X’08’          ACSIVPAN    ACSIPAN CONTAINS PANEL NUMBER
.... .1.. X’04’          ACSIVROW    ACSIROW CONTAINS ROW NUMBER.
.... ..1. X’02’          ACSIVCOL    ACSICOL CONTAINS COLUMN
NUMBER.
.... ...1 X’01’          ACSIVDRV    ACSIDRIV CONTAINS DRIVE
DEVICE NUMBER.
14   (E)        HEXSTRING     1          ACSIFLG5    FLAG BYTE 5: (MOVEMENT
CONTROL 3).
15    (F)        BITSTRING    1          ACSIFLG6    FLAG BYTE 6: (MISCELLANOUS
CONTROL 1).
1... .... X’80’          ACSIPROT    PROTECT=YES SPECIFIED.
.1.. .... X’40’          ACSISCR     SCRATCH=YES SPECIFIED.
..1. .... X’20’          ACSIVSCP    ACSIPOOL CONTAINS SCRATCH
POOL NUMBER.
...1 .... X’10’          ACSISUBN    ACSISUBP CONTAINS SUBPOOL
NAME.
.... 1... X’08’          ACSIVTKN    ACSITKNO CONTAINS TOKEN
NUMBER.
.... .1.. X’04’          ACSIVTXT    ACSITEXT CONTAINS TEXT
STRING.
.... ..1. X’02’          ACSIF602    RESERVED FUTURE USE.
.... ...1 X’01’          ACSIF601    RESERVED FUTURE USE.
16    (10)      HEXSTRING     1          ACSIFLG7    FLAG BYTE 7: (MISCELLANOUS
CONTROL 2).
17    (11)      A-ADDR        1          ACSILABT    SCRATCH LABEL TYPE LTYPE=
PARAMETER.
.... .... X’00’          ACSILLDT    LDT (LIBRARY DEFAULT TYPE).
.... ...1 X’01’          ACSILSL     SL (STANDARD LABEL).
.... ..1. X’02’          ACSILAL     AL (ANSI LABEL).
.... ..11 X’03’          ACSILNL     NL (NON-LABELED).
.... .1.. X’04’          ACSILNS     NSL (NON-STANDARD LABEL).
18    (12)      CHARACTER     8          ACSIUSER    USER NAME USED TO ASSOCIATE
CONSOLE ID.
26    (1A)      CHARACTER     8          ACSIACT1    ACCOUNTING TOKEN 1.
34    (22)      CHARACTER     8          ACSIACT2    ACCOUNTING TOKEN 2.
42    (2A)      HEXSTRING     2          -RESERVED-  RESERVE SLACK BYTES.
44    (2C)      SIGNED-FWORD  4          -RESERVED-  RESERVED MVS.
48    (30)      HEXSTRING     4          ACSITKNO    PASS THROUGH TOKEN NUMBER.
52    (34)      A-ADDR        4          -RESERVED-  RESERVED MVS.
56    (38)      SIGNED-HWORD  2          ACSICNT     COUNT FROM COUNT= PARAMETER.
58    (3A)      SIGNED-HWORD  2          ACSILOFF    OFFSET, FROM START OF
PARAMETER LIST, TO START OF
THE ELEMENT LIST AREA.
60    (3C)      CHARACTER                            CHARACTER 6 ACSIVOLS VOLSER
FROM VOLSER= PARAMETER.
66    (42)      CHARACTER     8          ACSIHOST    ASSOCIATED HOST FROM HOSTID=
PARAMETER.
74    (4A)      AREA          4          ACSIALC     ACS / LSM / CAP
IDENTIFICATION.
74    (4A)      HEXSTRING     1          ACSIACS     ACS ID NUMBER (AA).
74    (4A)      HEXSTRING     2          ACSILSMI    LSM ID NUMBER (AA0L).
74    (4A)      HEXSTRING     4          ACSICAP     CAP ID NUMBER (AA0LCC00).
74    (4A)      HEXSTRING     3          -RESERVED-
77    (4D)      HEXSTRING     1          -RESERVED-  NOT IMPLEMENTED (ALWAYS
X’00’) .
78    (4E)      HEXSTRING     1          ACSIPAN     PANEL FROM PAN= PARAMETER.
79    (4F)      HEXSTRING     1          ACSIROW     ROW FROM ROW= PARAMETER.
80    (50)      HEXSTRING     1          ACSICOL     COLUMN FROM COL= PARAMETER.
81    (51)      HEXSTRING     1          ACSITPAN    TO PANEL FROM TOPAN=
PARAMETER.
82    (52)      HEXSTRING     2          ACSITLSM    TO LSM FROM TOLSM= PARAMETER.
84    (54)      A-ADDR        2          ACSIDRIV    DRIVE DEVICE NUMBER FROM
DRIVE= PARAMETER.
86    (56)      A-ADDR        1          ACSIPOOL    SCRATCH POOL NUMBER, SCRPOOL=
PARAMETER.
87    (57)      CHARACTER     32         ACSITEXT    TEXT ASSOCIATED WITH REQUEST.
119   (77)      CHARACTER     13         ACSISUBP    NAME FROM SUBPOOL= KEYWORD.

TAPEREQ INPUT KEY VALUES.THE FOLLOWING VALUES ARE USED AS THE KEY IN SEARCHING THE CURRENT TAPEREQ PARAMETER FILE.
DEC   HEX       TYPE          LENGTH     LABEL       DESCRIPTION
132   (84)      BITSTRING     1          ACSIFLG8    FLAG BYTE 8: (TAPEREQ CONTROL
1).
1... .... X’80’          ACSIFJOB    ACSIJOBN PRESENT.
.1.. .... X’40’          ACSIFSTP    ACSISTEP PRESENT.
..1. .... X’20’          ACSIFPGM    ACSIPGMN PRESENT.
...1 .... X’10’          ACSIFDSN    ACSIDSN PRESENT.
.... 1... X’08’          ACSIFEXP    ACSIEXPD PRESENT.
.... .1.. X’04’          ACSIFRET    ACSIRETP PRESENT.
.... ..1. X’02’          ACSIFVOL    ACSIVOLT PRESENT.
133   (85)      OFFSET                   ACSITRI     TAPEREQ INPUT VALUES.
133   (85)      CHARACTER     8          ACSIJOBN    STRING TO MATCH TAPEREQ
JOBNAME VALUE.
141   (8D)      CHARACTER     8          ACSISTEP    STRING TO MATCH TAPEREQ
STEPNAME VALUE.
149   (95)      CHARACTER     8          ACSIPGMN    STRING TO MATCH TAPEREQ
PROGNAME VALUE.
157   (9D)      CHARACTER     44         ACSIDSN     STRING TO MATCH TAPEREQ DSN
VALUE.
201   (C0)      HEXSTRING     3          ACSIEXPD    VALUE TO MATCH TAPEREQ EXPDT
VALUE
204   (CC)      HEXSTRING     2          ACSIRETP    VALUE TO MATCH TAPEREQ RETPD
VALUE.
206   (CE)      CHARACTER     1          ACSIVOLT    STRING TO MATCH TAPEREQ
VOLTYPE VALUE.
74    (4A)      LENGTH                   ACSITRIL    TAPEREQ OUTPUT VALUES.

THE FOLLOWING VALUES ARE USED AS OVERRIDE (OR SPECIFIC) VALUES TO THE VALUES FOUND IN THE CURRENT TAPEREQ PARAMETER FILE.
207   (CF)      BITSTRING     1          ACSIFLG9    FLAG BYTE 9: (TAPEREQ CONTROL
2).
1... .... X’80’          ACSIFREC    ACSIRECT PRESENT.
.1.. .... X’40’          ACSIFMED    ACSIMED PRESENT.
208   (D0)      CHARACTER     8          ACSIRECT    RECORDING TECHNIQUE.
216   (D8)      CHARACTER     8          ACSIMED     MEDIA.
224   (E0)      HEXSTRING     256        -RESERVED-  RESERVED FOR FUTURE PARM
EXPANSION.
480   (1E0)     AREA          8          -RESERVED-  ALIGNMENT.
480   (1E0)     LENGTH                   ACSIHLN     LENGTH OF FIXED AREA.
480   (1E0)     AREA          1          ACSILIST    ELEMENT LIST DESIGNATED BY
LIST= PARAMETER BEGINS HERE
(FIELD ACSICNT CONTAINS THE
NUMBER OF ELEMENTS IN THIS
LIST).
2     (02)      CONST                    ACSILDRL    LENGTH OF EACH ELEMENT (DRIVE
DEVICE NUMBER) IN THE LIST
USED BY THE QDRLIST FUNCTION.
1500  (5DC)     CONST                    ACSIMDRL    MAXIMUM NUMBER OF ELEMENTS
ALLOWED IN THE LIST USED BY
THE QDRLIST FUNCTION.
6     (06)      CONST                    ACSILVSL    LENGTH OF EACH ELEMENT
(VOLSER) IN THE LIST USED BY
THE QVOLUME FUNCTION.
500   (1F4)     CONST                    ACSIMVSL    MAXIMUM NUMBER OF ELEMENTS
ALLOWED IN THE LIST USED BY
THE QVOLUME AND EJECT.
12    (0C)      CONST                    ACSILPOL    LENGTH OF EACH ELEMENT
(VOLSER RANGE PAIR) IN THE
LIST USED BY THE DEFPOOL
FUNCTION.
250   (FA)      CONST                    ACSIMPOL    MAXIMUM NUMBER OF ELEMENTS
ALLOWED IN THE LIST USED BY
THE DEFPOOL FUNCTION.
4     (04)      CONST                    ACSILCAP    LENGTH OF EACH ELEMENT (CAP
IDENTIFIER) IN THE LIST USED
BY THE QCAP FUNCTION.
500   (1F4)     CONST                    ACSIMCAP    MAXIMUM NUMBER OF
ELEMENTSALLOWED IN THE LIST
USED BY THE QCAP FUNCTION.
4     (04)      CONST                    ACSILTOK    LENGTH OF EACH ELEMENT
(UNIQUE TOKEN) IN THE LIST
USED BY THE QCAP FUNCTION.
500   (1F4)     CONST                    ACSIMTOK    MAXIMUM NUMBER OF ELEMENTS
ALLOWED IN THE LIST USED BY
THE QEJECT/STOP FUNCTIONS.

Referencia cruzada

En la siguiente tabla, se proporciona una referencia cruzada para la macro de ACSINT:

Tabla 9-3 Referencia cruzada de la macro de ACSINT

Nombre

Longitud

Valor de desplazamiento

ACSIACC1

N/D

02

ACSIACC2

N/D

01

ACSIACS

000001

4A

ACSIACT1

000008

1A

ACSIACT2

000008

22

ACSIALC

000004

4A

ACSICAP

000004

4A

ACSICNT

000002

38

ACSICOL

000001

50

ACSIDPOL

N/D

40

ACSIDRIV

000002

54

ACSIDSCR

N/D

3F

ACSIDSM

N/D

2A

ACSIDSN

000044

9D

ACSIEJCT

N/D

2B

ACSIEXPD

000003

C9

ACSIFDSN

N/D

10

ACSIFEXP

N/D

08

ACSIFJOB

N/D

80

ACSIFLG1

000001

0A

ACSIFLG2

000001

0B

ACSIFLG3

000001

0C

ACSIFLG4

000001

0D

ACSIFLG5

000001

0E

ACSIFLG6

000001

0F

ACSIFLG7

000001

10

ACSIFLG8

000001

84

ACSIFLG9

000001

CF

ACSIFMED

N/D

40

ACSIFMED

N/D

40

ACSIFREC

N/D

80

ACSIMED

000008

D8

ACSIMNT

N/D

28

ACSIMOVE

N/D

29

ACSIMPOL

N/D

FA

ACSIMTOK

N/D

1F4

ACSIFRET

N/D

04

ACSIFSTP

N/D

40

ACSIFVOL

N/D

02

ACSIF180

N/D

80

ACSIF308

N/D

08

ACSIF410

N/D

10

ACSIF420

N/D

20

ACSIF601

N/D

01

ACSIF602

N/D

02

ACSIHDR

000004

00

ACSIHLN

N/D

1E0

ACSIHOST

000008

42

ACSID

N/D

’CVAL’

ACSIJOBN

000008

85

ACSILABT

000001

11

ACSILAL

N/D

02

ACSILCAP

N/D

04

ACSILDRL

N/D

02

ACSILIST

000001

1E0

ACSILLDT

N/D

00

ACSILNL

N/D

03

ACSILNS

N/D

04

ACSILOFF

000002

3A

ACSILPOL

N/D

0C

ACSILSL

N/D

01

ACSILSMI

000002

4A

ACSILTOK

N/D

04

ACSILVSL

N/D

06

ACSIMANO

N/D

20

ACSIMCAP

N/D

1F4

ACSIMDRL

N/D

5DC

ACSIVTPN

N/D

40

ACSIVTXT

N/D

04

ACSIVUSR

N/D

40

ACSIVVOL

N/D

04

ACSIWTOR

N/D

10

ACSIMVSL

N/D

1F4

ACSINDEL

N/D

08

ACSINNDL

N/D

04

ACSINOOP

N/D

00

ACSIPAN

000001

4E

ACSIPGMN

000008

95

ACSIPOOL

000001

56

ACSIPROT

N/D

80

ACSIQCAP

N/D

1A

ACSIQCNF

N/D

14

ACSIQDRL

N/D

16

ACSIQDRV

N/D

15

ACSIQDSN

N/D

1D

ACSIQEJT

N/D

19

ACSIQRQS

N/D

1C

ACSIVDRV

N/D

01

ACSIVER

000001

08

ACSIVHST

N/D

80

ACSIVLSM

N/D

20

ACSIVLST

N/D

02

ACSIVN

N/D

07

ACSIVOLS

000006

3C

ACSIVOLT

000001

CE

ACSIVPAN

N/D

08

ACSIVROW

N/D

04

ACSIVSCP

N/D

20

ACSIVTKN

N/D

08

ACSIVTLM

N/D

80

ACSIROW

000001

4F

ACSIRS01

N/D

01

ACSIRS02

N/D

02

ACSIRS03

N/D

03

ACSIRT

000001

09

ACSISCR

N/D

40

ACSISCRA

N/D

3D

ACSISOPR

N/D

05

ACSISSCR

N/D

3C

ACSISTEP

000008

8D

ACSISTOP

N/D

04

ACSISUBN

N/D

10

ACSISUBP

000013

77

ACSITEXT

000032

57

ACSITKNO

000004

30

ACSITLSM

000002

52

ACSITPAN

000001

51

ACSITRI

N/D

85

ACSITRIL

N/D

4A

ACSIUNSC

N/D

3E

ACSIUSER

000008

12

ACSIVACS

N/D

40

ACSIVCAP

N/D

10

ACSIVCNT

N/D

01

ACSIVCOL

N/D

02

Formato de registro de IUB

IUB: bloque de solicitud de IUCV

El IUB describe una solicitud de IUCV pendiente generada por una operación del IUCV. La solicitud y el estado final están contenidos en la estructura de datos del IUB. El IUB es una contraparte del IUCV para la estructura de ’IOBLOK’ usada por la gestión de dispositivos.

En la siguiente tabla, se proporciona una referencia cruzada para el bloque de solicitud de IUB del IUCV:

Tabla 9-4 Referencia del bloque de solicitud del IUB

Nombre

Longitud

Valor de desplazamiento

ACSIACC1

N/D

02

ACSIACC2

N/D

01

ACSIACS

000001

4A

ACSIACT1

000008

1A

ACSIACT2

000008

22

ACSIALC

000004

4A

ACSICAP

000004

4A

ACSICNT

000002

38

ACSICOL

000001

50

ACSIDPOL

N/D

40

ACSIDRIV

000002

54

ACSIDSCR

N/D

3F

ACSIDSM

N/D

2A

ACSIDSN

000044

9D

ACSIEJCT

N/D

2B

ACSIEXPD

000003

C9

ACSIFDSN

N/D

10

ACSIFEXP

N/D

08

ACSIFJOB

N/D

80

ACSIFLG1

000001

0A

ACSIFLG2

000001

0B

ACSIFLG3

000001

0C

ACSIFLG4

000001

0D

ACSIFLG5

000001

0E

ACSIFLG6

000001

0F

ACSIFLG7

000001

10

ACSIFLG8

000001

84

ACSIFLG9

000001

CF

ACSIFMED

N/D

40

ACSIFPGM

N/D

20

ACSIFRET

N/D

04

ACSIFSTP

N/D

40

ACSIFVOL

N/D

02

ACSIF180

N/D

80

ACSIF308

N/D

08

ACSIF410

N/D

10

ACSIF420

N/D

20

ACSIF601

N/D

01

ACSIF602

N/D

02

ACSIHDR

000004

00

ACSIHLN

N/D

1E0

ACSIHOST

000008

42

ACSIID

N/D

’CVAL’

ACSIJOBN

000008

85

ACSILABT

000001

11

ACSILAL

N/D

02

ACSILCAP

N/D

04

ACSILDRL

N/D

02

ACSILIST

000001

1E0

ACSILLDT

N/D

00

ACSILNL

N/D

03

ACSILNS

N/D

04

ACSILOFF

000002

3A

ACSILPOL

N/D

0C

ACSILSL

N/D

01

ACSILSMI

000002

4A

ACSILTOK

N/D

04

ACSILVSL

N/D

06

ACSIMANO

N/D

20

ACSIMCAP

N/D

1F4

ACSIFREC

N/D

80

ACSIMED

000008

D8

ACSIMNT

N/D

28

ACSIMOVE

N/D

29

ACSIMPOL

N/D

FA

ACSIMTOK

N/D

1F4

ACSIMVSL

N/D

1F4

ACSINDEL

N/D

08

ACSINNDL

N/D

04

ACSINOOP

N/D

00

ACSIPAN

000001

4E

ACSIPGMN

000008

95

ACSIPOOL

000001

56

ACSIPROT

N/D

80

ACSIQCAP

N/D

1A

ACSIQCNF

N/D

14

ACSIQDRL

N/D

16

ACSIQDRV

N/D

15

ACSIQDSN

N/D

1D

ACSIQEJT

N/D

19

ACSIQRQS

N/D

1C

ACSIVDRV

N/D

01

ACSIVER

000001

08

ACSIVHST

N/D

80

ACSIVLSM

N/D

20

ACSIVLST

N/D

02

ACSIVN

N/D

07

ACSIVOLS

000006

3C

ACSIVOLT

000001

CE

ACSIVPAN

N/D

08

ACSIVROW

N/D

04

ACSIVSCP

N/D

20

ACSIVTKN

N/D

08

ACSIVTLM

N/D

80

ACSIMDRL

N/D

5DC

ACSIVTPN

N/D

40

ACSIVTXT

N/D

04

ACSIVUSR

N/D

40

ACSIVVOL

N/D

04

ACSIWTOR

N/D

10

ACSIROW

000001

4F

ACSIRS01

N/D

01

ACSIRS02

N/D

02

ACSIRS03

N/D

03

ACSIRT

000001

09

ACSISCR

N/D

40

ACSISCRA

N/D

3D

ACSISOPR

N/D

05

ACSISSCR

N/D

3C

ACSISTEP

000008

8D

ACSISTOP

N/D

04

ACSISUBN

N/D

10

ACSISUBP

000013

77

ACSITEXT

000032

57

ACSITKNO

000004

30

ACSITLSM

000002

52

ACSITPAN

000001

51

ACSITRI

N/D

85

ACSITRIL

N/D

4A

ACSIUNSC

N/D

3E

ACSIUSER

000008

12

ACSIVACS

N/D

40

ACSIVCAP

N/D

10

ACSIVCNT

N/D

01

ACSIVCOL

N/D

02

Referencia cruzada

En la siguiente tabla, se proporciona una referencia cruzada para el IUB:

Tabla 9-5 Referencia cruzada del IUB

Nombre

Longitud

Valor de desplazamiento

IUBCC

000001

31

IUBCONN

N/D

10

IUBDABQ

000016

10

IUBDAVL

000001

20

IUBDCBPT

000004

44

IUBECBKY

000001

21

IUBBECBT

000004

34

IUBEXT

000040

78

IUBEXT1

000008

78

IUBEXT2

000008

80

IUBEXT3

000008

88

IUBEXT4

000008

90

IUBEXT5

000008

98

IUBEYE

000004

0C

IUBFLG1

000001

30

IUBFLG2

000001

32

IUBHCOMM

N/D

20

IUBIRT

000004

2C

IUBIUBPT

N/D

24

IUBLEN

N/D

A0

IUBLOK

N/D

08

IUBNPOST

N/D

40

IUBORGID

000004

3C

IUBPARML

000040

50

IUBPARM1

000008

50

IUBPARM2

000008

58

IUBPARM3

000008

60

IUBPARM4

000008

68

IUBPARM5

000008

70

IUBQ

000016

00

IUBREAD

N/D

80

IUBREJCT

N/D

08

IUBREPLY

N/D

20

IUBSEND

N/D

40

IUBSENT

N/D

80

IUBTASK

000004

28

A Valores de MEDia, RECtech y MODel

En este apéndice se proporcionan los valores para los parámetros MEDia, RECtech y MODel. Estos parámetros le permiten especificar las características del transporte y de los medios. Se especifican en varios comandos del cliente de VM y en varias solicitudes de TMI.

Nota:

- La biblioteca SL8500 admite solamente los tipos de medios y las técnicas de registro T9840A/B/C/D, T9940B, LTO, SDLT y T10000A/B/C.

- La biblioteca SL3000 admite solamente los tipos de medios y las técnicas de registro T9840C/D, LTO, SDLT y T10000A/B/C.

- Las unidades LTO y SDLT no se admiten en un entorno de MVS. Estas unidades son reconocidas por el HSC pero solamente pueden acceder a ellas los clientes de sistemas abiertos mediante LibraryStation.

Tipo de medio (MEDia)

El tipo de medio o MEDia permite especificar el tipo de medio deseado que se usará para un juego de datos. Se especifica en los siguientes comandos del cliente de VM y en las siguientes solicitudes de TMI:

- Comando MOUNT

- Solicitud de TMI QDRLIST

- Solicitud de TMI QSCRATCH

- Solicitud de TMI SELSCR

En la siguiente tabla, se describen los tipos de medios válidos:

Tabla A-1 Tipos de medios

Tipo de medio

Descripción

LONGitud

Indica cartuchos con capacidad estándar o mejorada (ECART).

ZLONGI

Indica cartuchos con capacidad estándar, mejorada (ECART), o extendida y mejorada (ZCART).

Standard

Indica un cartucho 3480 de longitud estándar. Se puede leer en una unidad longitudinal (4480, 4490, 9490 o 9490EE). Los datos se pueden escribir en modo de 36 pistas en una unidad 4490, 9490 o 9490EE pero no se puede leer en una unidad de 18 pistas (4480). Entre los sinónimos se incluyen CST, MEDIA1, STD, 1 y 3480.

ECART

Indica un cartucho 3490E de capacidad extendida. Se puede usar solamente en una unidad de 36 pistas (4490, 9490 o 9490EE). Entre los sinónimos se incluyen E, ECCST, ETAPE, Long, MEDIA2, and 3490E.

ZCART

Indica un cartucho 3490E de capacidad extendida y mejorada. Solamente puede ser usado por una unidad 9490EE. ZCART se puede abreviar como Z

Virtual

Indica un VTV (volumen de cinta virtual) montado en una VTD (unidad de cinta virtual).

HELical

Indica un cartucho helicoidal. Se puede usar un cartucho helicoidal solamente en unidades RedWood. Los siguientes subtipos y abreviaturas especifican un cartucho helicoidal:

- DD3 indica un cartucho helicoidal DD3A, DD3B o DD3C.

- DD3A o A indica un cartucho helicoidal con una capacidad de medios de 10 GB.

- DD3B o B indica un cartucho helicoidal con una capacidad de medios de 25 GB.

- DD3C o C indica un cartucho helicoidal con una capacidad de medios de 50 GB.

La séptima posición de una etiqueta externa está cifrada con el tipo de cartucho (es decir, A, B o C).

STK1

Indica un cartucho T9840.

STK1R

Indica un cartucho de datos T9840. El indicador de medios de la etiqueta externa está cifrado con el tipo de cartucho (R). STK1R se puede abreviar como R.

Las capacidades de los medios del cartucho T9840 son 20 GB (T9840A y T9840B), 40GB (T9840C) o 75GB (T9840D).

STK1U

Indica un cartucho de limpieza T9840A, T9840B o T9840C. STK1U se puede abreviar como U.

STK1Y

Indica un cartucho de limpieza T9840D. STK1Y se puede abreviar como Y.

STK2

Indica un cartucho T9940.

STK2P

Indica un cartucho de datos T9940. STK2P se puede abreviar como P.

Las capacidades de medios del cartucho T9940 son 60 GB (T9940A) o 200 GB (T9940B).

STK2W

Indica un cartucho de limpieza T9940. STK2W se puede abreviar como W.

T10000T1

Indica un cartucho T10000A de 500 GB o un cartucho T10000B de 1 TB de capacidad completa. T10000T1 se puede abreviar como T1.

T10000TS

Indica un cartucho T10000A de 120 GB o un cartucho T10000B de 240 GB de menor capacidad. T10000TS se puede abreviar como TS.

T10000CT

Indica un cartucho de limpieza T10000A o T10000B. T10000CT se puede abreviar como CT.

T10000T2

Indica un cartucho T10000C de 5 TB de capacidad completa. T10000T2 se puede abreviar como T2.

T10000TT

Indica un cartucho T10000C de 1 TB de menor capacidad. T10000TT se puede abreviar como TT.

T10000CL

Indica un cartucho de limpieza T10000A, T10000B o T10000C. T10000CL se puede abreviar como CL.

Nota:

- Las unidades T10000C pueden leer los medios T10000T1 o T10000TS pero no pueden escribir en esos medios.

- Las unidades T10000C solamente pueden escribir en los medios T10000T2 o T10000TT.

Si no se especifica el parámetro MEDia, se elige uno por defecto según el valor del parámetro RECtech. En la siguiente tabla, se muestran los valores por defecto que se usan si se omite MEDia:

Tabla A-2 Valores de tipos medios por defecto

RECtech introducido

MEDia por defecto

18track

Standard

36track, 36Atrack, 36Btrack

LONGItud

36Ctrack

ZLONGI

LONGItud

LONGItud

DD3, Helical

DD3A

STK1R, STK1R34, STK1R35, STK1RA, STK1RA34, STK1RA35, STK1RB, STK1RB34, STK1RB35, STK1RAB, STK1RAB34, STK1RAB35, STK1RC, STK1RC34, STK1RC35, STK1RD, STK1RDE, STK1RDN, STK1RD34, STK1RD35, STK1RDE4, STK1RDE5

STK1R

STK2P, STK2P34, STK2P35, STK2PA, STK2PA34, STK2PA35, STK2PB, STK2PB34, STK2PB35

STK2P

T10K, T10KN, T10KE, T10KA, T10KAN, T1A34, T1A35, T10KAE, T1AE34, T1AE35, T10KC, T10KCN, T1C34, T1C35, T10KCE, T1CE34, T1CE35

T10000T1

Nota:

- Las unidades T10000C pueden leer los medios T10000T1 o T10000TS pero no pueden escribir en esos medios.

- Las unidades T10000C solamente pueden escribir en los medios T10000T2 o T10000TT.

Técnica de registro (RECtech)

La técnica de registro o RECtech permite especificar el método que se usará para registrar pistas de datos en la superficie de la cinta para el juego de datos deseado. Se especifica en las siguientes solicitudes de TMI del cliente de VM:

- QDRLIST

- QSCRATCH

- SELSCR

En la siguiente tabla, se describen las técnicas de registro válidas:

Tabla A-3 Técnicas de registro

Técnica de registro

Descripción

LONGItud

Indica un dispositivo que usa el registro longitudinal. Entre los dispositivos, se incluyen las unidades 4480, 4490, 9490 y 9490EE.

18track

Indica una unidad 4480.

36track

Indica una unidad 4490, 9490 o 9490EE (cualquier dispositivo que se registra en modo de 36 pistas).

36Atrack

Indica una unidad 4490 (Silverton).

36Btrack

Indica una unidad 9490 (Timberline).

36Ctrack

Indica una unidad 9490EE.

HELical

Indica un dispositivo que usa registro helicoidal.

DD3

Indica un dispositivo que usa registro helicoidal.

STK1R

Indica cualquier unidad T9840.

STK1R34

Indica una unidad T9840 de imagen 3490E.

STK1R35

Indica una unidad T9840 de imagen 3590.

STK1RA

Indica cualquier unidad T9840A.

STK1RA34

Indica una unidad T9840A de imagen 3490E.

STK1RA35

Indica una unidad T9840A de imagen 3590.

STK1RB

Indica cualquier unidad T9840B.

STK1RB34

Indica una unidad T9840B de imagen 3490E.

STK1RB35

Indica una unidad T9840B de imagen 3590.

STK1RAB

Indica cualquier unidad T9840A o T9840B.

STK1RAB4

Indica una unidad T9840A o T9840B de imagen 3490E.

STK1RAB5

Indica una unidad T9840A o T9840B de imagen 3590.

STK1RC

Indica cualquier unidad T9840C.

STK1RC34

Indica una unidad T9840C de imagen 3490E.

STK1RC35

Indica una unidad T9840C de imagen 3590.

STK1RD

Indica cualquier unidad T9840D.

STK1RDE

Indica una unidad T9840D activada para cifrado.

STK1RDN

Indica una unidad T9840D no activada para cifrado.

STK1RD34

Indica una unidad T9840D de imagen 3490E no activada para cifrado.

STK1RD35

Indica una unidad T9840D de imagen 3590 no activada para cifrado.

STK1RDE4

Indica una unidad T9840D de imagen 3490E activada para cifrado.

STK1RDE5

Indica una unidad T9840D de imagen 3590 activada para cifrado.

STK2P

Indica cualquier unidad T9940.

STK2P34

Indica una unidad T9940 de imagen 3490E.

STK2P35

Indica una unidad T9940 de imagen 3590.

STK2PA

Indica cualquier unidad T9940A.

STK2PA34

Indica una unidad T9940A de imagen 3490E.

STK2PA35

Indica una unidad T9940A de imagen 3590.

STK2PB

Indica cualquier unidad T9940B.

STK2PB34

Indica una unidad T9940B de imagen 3490E.

STK2PB35

Indica una unidad T9940B de imagen 3590.

T10K

Indica cualquier unidad T10000.

T10KN

Indica todas las unidades T10000 no cifradas.

T10KE

Indica todas las unidades T10000 cifradas.

T10KA

Indica cualquier unidad T10000A.

T10KAN

Indica una unidad T10000A de imagen 3490E o 3590 no activada para cifrado.

T1A34

Indica una unidad T10000A de imagen 3490E no activada para cifrado.

T1A35

Indica una unidad T10000A de imagen 3590 no activada para cifrado.

T10KAE

Indica una unidad T10000A de imagen 3490E o 3590 activada para cifrado.

T1AE34

Indica una unidad T10000A de imagen 3490E activada para cifrado.

T1AE35

Indica una unidad T10000A de imagen 3590 activada para cifrado.

T10KB

Indica cualquier unidad T10000B.

T10KBN

Indica una unidad T10000B de imagen 3490E o 3590 no activada para cifrado.

T1B34

Indica una unidad T10000B de imagen 3490E no activada para cifrado.

T1B35

Indica una unidad T10000B de imagen 3590 no activada para cifrado.

T10KBE

Indica una unidad T10000B de imagen 3490E o 3590 activada para cifrado.

T1BE34

Indica una unidad T10000B de imagen 3490E activada para cifrado.

T1BE35

Indica una unidad T10000B de imagen 3590 activada para cifrado.

T10KC

Indica cualquier unidad T10000C.

T10KCN

Indica una unidad T10000C de imagen 3490E o 3590 no cifrada.

T1C34

Indica una unidad T10000C de imagen 3490E no cifrada.

T1C35

Indica una unidad T10000C de imagen 3590 no cifrada.

T10KCE

Indica una unidad T10000C de imagen 3490E o 3590 no activada para cifrado.

TICE34

Indica una unidad T10000C de imagen 3490E activada para cifrado.

T1CE35

Indica una unidad T10000C de imagen 3590 activada para cifrado.

Virtual

Indica un VTV (volumen de cinta virtual) montado en una VTD (unidad de cinta virtual).

Si no se especifica el parámetro RECtech, se elige uno por defecto según el valor del parámetro MEDia. En la siguiente tabla, se muestran los valores por defecto que se usan si se omite RECtech.

Tabla A-4 Valores por defecto de la técnica de registro

MEDia introducido

RECtech por defecto

LONGItud

LONGItud

ZLONGI

LONGItud

Standard

LONGItud

ECART

36track

ZCART

36Ctrack

DD3A, DD3B, DD3C, DD3D

DD3

STKR, STK1U, STKY

STK1R

STK2P, STK2W

STK2P

T10000T1, T10000TS, T10000CL

T10K

T10000CT

T10KA y T10KB

T10000T2, T10000TT

T10KC

Virtual

Virtual

Tipo de modelo (MODel)

El tipo de modelo, o MODel, permite especificar el número de modelo de un transporte (unidad) o de una unidad. MODel proporciona el mismo tipo de información que RECtech. Sin embargo, es posible que a un usuario le resulte más sencillo especificar un modelo de transporte que una técnica de registro.

Nota:

- MODel y RECtech se excluyen mutuamente.

- La biblioteca SL8500 admite solamente tipos de modelos asociados con las unidades serie T9840, T9940 y T10000.

- Puede especificar varios valores para este parámetro; separe los valores con una coma.

En la siguiente tabla, se describen los tipos de modelos válidos:

Tabla A-5 Tipos de modelos

Tipo de modelo

Descripción

4480

Indica una unidad 4480 (18 pistas).

4490

Indica una unidad 4490 (36 pistas Silverton).

9490

Indica una unidad 9490 (36 pistas Timberline).

9490EE

Indica una unidad 9490EE (36 pistas Timberline EE).

SD3

Indica una unidad SD-3 (RedWood).

9840

Indica una unidad T9840A de imagen 3490E.

984035

Indica una unidad T9840A de imagen 3590.

T9840B

Indica una unidad T9840B de imagen 3490E.

T9840B35

Indica una unidad T9840B de imagen 3590.

T9840C

Indica una unidad T9840C de imagen 3490E.

T9840C35

Indica una unidad T9840C de imagen 3590.

T9840D

Indica una unidad T9840D de imagen 3490E no activada para cifrado.

T9840D35

Indica una unidad T9840D de imagen 3590E no activada para cifrado.

T9840DE

Indica una unidad T9840D de imagen 3490E activada para cifrado.

T9840DE5

Indica una unidad T9840D de imagen 3590E activada para cifrado.

T9940A

Indica una unidad T9940A de imagen 3490E.

T9940A35

Indica una unidad T9940A de imagen 3590.

T9940B

Indica una unidad T9940B de imagen 3490E.

T9940B35

Indica una unidad T9940B de imagen 3590.

T1A34

Indica una unidad T10000A de imagen 3490E no activada para cifrado.

T1A35

Indica una unidad T10000A de imagen 3590 no activada para cifrado.

T1AE34

Indica una unidad T10000A de imagen 3490E activada para cifrado.

T1AE35

Indica una unidad T10000A de imagen 3590 activada para cifrado.

T1B34

Indica una unidad T10000B de imagen 3490E no activada para cifrado.

T1B35

Indica una unidad T10000B de imagen 3590E no activada para cifrado.

T1BE34

Indica una unidad T10000B de imagen 3490E activada para cifrado.

T1BE35

Indica una unidad T10000B de imagen 3590 activada para cifrado.

T1C34

Indica una unidad T10000C de imagen 3490E no activada para cifrado.

T1C35

Indica una unidad T10000C de imagen 3590 no activada para cifrado.

T1CE34

Indica una unidad T10000C de imagen 3490E activada para cifrado.

T1CE35

Indica una unidad T10000C de imagen 3590 activada para cifrado.

Virtual

Indica un VTV (volumen de cinta virtual) montado en una VTD (unidad de cinta virtual).

B Diagnóstico

En este apéndice, se describe la información de diagnóstico que posiblemente se le solicite cuando se comunique con Oracle en relación con el soporte al cliente de VM.

Esta información incluye lo siguiente:

- Archivos de juegos de datos SMCCMDS y SMCPARMS

- Log de consola del cliente de VM

- Archivos de TRACE

- Juego MSGDEF LVL=28

- Volcados del sistema

- Visualización de mantenimiento del cliente de VM (VMFINFO)

- Nivel de VM (Q CPLEVEL)

- Nivel del CMS (Q CMSLEVEL)

- Nivel de mantenimiento de TMS de VM

Consulte Prólogo para obtener información sobre cómo ponerse en contacto con Oracle para obtener soporte.

Índice
A  C  D  E  F  I  M  P  R  S  T  V

A

ACSINT DSECT, 9.10.1.3

ACSLS, interfaz del cliente XAPI, 1.3

archivo de comando SMCCMDS , 5.2.2

archivo de comando SMCPARMS, 5.2.1

archivo de sustitución PPF, creación, 3.3.1

archivos de comando, 5.2

áreas de datos de interfaz, 9.10

C

clases de gestión de VTCS, 7.3

comando AUTHorize, 6.2.1

comando COMMtest, 6.2.3

comando CP, 6.2.4

comando de TAPEPlex, 6.2.24

comando del CMS, 6.2.2

comando DISMount, 6.2.5

comando Display DRive, 6.2.6

comando Display RC, 6.2.7

comando DRIVemap , 6.2.9

comando DUMP, 6.2.10

comando DUMPOpts, 6.2.11

comando EXIT, 6.2.12

comando Help, 6.2.13

comando LIst, 6.2.14

comando LOGdisk, 6.2.15

comando MOunt, 6.2.16

comando MSGDef, 6.2.17

Comando OPERator, 6.2.18

Comando POOLmap, 6.2.19

comando READ, 6.2.20

Comando RESYNChronize, 6.2.21

Comando Route, 6.2.22

comando SERVer, 6.2.23

comando TCPip, 6.2.25

comando TRace, 6.2.26

comandos

AUTHorize, 6.2.1

CMS, 6.2.2

COMMtest, 6.2.3

CP, 6.2.4

DISMount, 6.2.5

Display DRive, 6.2.6

Display RC, 6.2.7

DRIVemap, 6.2.9

DUMP, 6.2.10

DUMPOpts, 6.2.11

ejecución, 6.1

EXIT, 6.2.12

Help, 6.2.13

LIst, 6.2.14

LOGdisk, 6.2.15

MOunt, 6.2.16

MSGDef, 6.2.17

OPERator, 6.2.18

POOLmap, 6.2.19

READ, 6.2.20

RESYNChronize, 6.2.21

Route, 6.2.22

SERVer, 6.2.23

TAPEPlex, 6.2.24

TCPip, 6.2.25

TRace, 6.2.26

Consideraciones del IUCV , 9.4 consideraciones del servidor, 7 contenido de archivos ZIP, 2.2.1 contenido de instalación, 2.2.1 contenido del CD-ROM, 2.2.1

D

determinación de los requisitos de recursos del cliente de VM, 3.3

diagnóstico, B

E

ejecución de comandos, 6.1

ELS, 2.3.3

F

flujo de datos, cliente de VM, 1.2

formato de registro de IUB, 9.10.1.5

funciones, cliente de VM, 1.1

I

inicio del cliente de VM, 5

instalación

asignación de recursos del cliente de VM, 3.4

colocación del cliente de VM en producción, 3.10

creación de archivo de sustitución PPF, 3.3.1

creación de una máquina de servicio del cliente de VM, 3.7

generación del código ejecutable del cliente de VM, 3.6

IBM VSES/E, 2.1, 3.1, 4.1

instalación de archivos de producto del cliente de VM, 3.5

personalización de archivos de la máquina de servicio del cliente de VM, 3.8

prueba del cliente de VM, 3.9

requisitos de DASD, 2.5

requisitos de MVS, 2.3.3

requisitos de software y hardware, 2.3

resumen de pasos, 3.2

instalación, mantenimiento, 4 interfaz de gestión de cintas (TMI), 9 interfaz del cliente XAPI para el servidor ACSLS, 1.3 introducción, 1

M

macro de ACSRQ

sintaxis, 9.9.2

solicitudes

DISMOUNT, 9.9.3

EJECT, 9.9.4

MOUNT, 9.9.5

MOVE, 9.9.6

QCAP, 9.9.7

QCONFIG, 9.9.8

QDRIVES, 9.9.9

QSCRATCH, 9.9.11

QVOLUME, 9.9.12

QVOLUSE, 9.9.13

SCRATCH, 9.9.14

SELSCR, 9.9.15

UNSCRATCH, 9.9.16

visión general, 9.9 macro de SLX, 9.10.1 máquina de servicio, creación, 3.7 mensajes, 8

P

par de palabra clave y valor de MAXRC, 5.1.3

par de palabra clave y valor de OPERATOR, 5.1.2

par de palabra clave y valor de TRACE, 5.1.1

parámetros del módulo SMCBINT, 5.1

prueba del cliente de VM, 3.9

R

requisitos de DASD, 2.5

requisitos de hardware, 2.3

requisitos de MVS, 2.3.3

requisitos de software, 2.3

S

servidor HTTP, 7.1

servidor HTTP del SMC, 7.1

sintaxis

comando AUTHorize, 6.2.1.1

comando COMMtest, 6.2.3.1

comando CP, 6.2.4.1

comando de TAPEPlex, 6.2.24.1

comando del CMS, 6.2.2.1

comando DISMount, 6.2.5.1

comando Display DRive, 6.2.6.1

comando Display RC, 6.2.7.1, 6.2.8

comando Display Volume, 6.2.8.1

comando DRIVemap, 6.2.9.1

comando DUMP, 6.2.10.1

comando DUMPOpts, 6.2.11.1

comando EXIT, 6.2.12.1

comando Help, 6.2.13.1

comando LIst, 6.2.14.1

comando LOGdisk, 6.2.15.1

comando MOunt, 6.2.16.1

comando MSGDef, 6.2.17.1

Comando OPERator, 6.2.18.1

Comando POOLmap, 6.2.19.1

comando READ, 6.2.20.1

Comando RESYNChronize, 6.2.21.1

Comando Route, 6.2.22.1

Comando SERVer, 6.2.23.1

comando TCPip, 6.2.25.1

comando TRace, 6.2.26.1

macro de ACSRQ, 9.9.2

Solicitud de DISMOUNT, 9.9.3.2, 9.9.3.2

solicitud de EJECT, 9.9.4.2

Solicitud de MOUNT, 9.9.5.2

Solicitud de MOVE , 9.9.6.2

solicitud de QCAP, 9.9.7.2

solicitud de QCONFIG, 9.9.8.2, 9.9.8.2

solicitud de QDRIVES, 9.9.9.2

Solicitud de QDRLIST, 9.9.10.2

Solicitud de QSCRATCH, 9.9.11.2

Solicitud de QVOLUME, 9.9.12.2

Solicitud de QVOLUSE, 9.9.13.2

solicitud de SCRATCH, 9.9.14.2

solicitud de SELSCR , 9.9.15.2

solicitud de UNSCRATCH, 9.9.16.2

solicitud de DISMOUNT, 9.9.3 solicitud de EJECT, 9.9.4 solicitud de MOUNT, 9.9.5 solicitud de MOVE , 9.9.6 solicitud de QCAP, 9.9.7 solicitud de QCONFIG, 9.9.8 solicitud de QDRIVES, 9.9.9 solicitud de QSCRATCH, 9.9.11 solicitud de QVOLUME, 9.9.12 solicitud de QVOLUSE, 9.9.13 solicitud de SCRATCH, 9.9.14 solicitud de SELSCR , 9.9.15 solicitud de UNSCRATCH, 9.9.16 soporte de DETACH del CP, 5.4 subagrupaciones reutilizables, 7.2

T

TMS

interacción con el cliente de VM, 9.5

puntos de decisión, 9.2

visión general, 9.1

V

Valores de técnica de registro (RECtech), A.2

valores de tipo de MODel (MODel), A.3

Valores de tipos de medios (MEDIA), A.1

visión general, 1

Visión general del cliente de VM, 1

VMSES/E, 2.1, 3.1, 4.1

Disposiciones legales de Oracle

Disposición de Copyright

Copyright © 1994-2016, Oracle y/o sus filiales. Todos los derechos reservados.

Garantía de restricciones de licencia/Exención de responsabilidad de daños consecuenciales

Este software y la documentación relacionada están sujetos a un contrato de licencia que incluye restricciones de uso y revelación, y se encuentran protegidos por la legislación sobre la propiedad intelectual. A menos que figure explícitamente en el contrato de licencia o esté permitido por la ley, no se podrá utilizar, copiar, reproducir, traducir, emitir, modificar, conceder licencias, transmitir, distribuir, exhibir, representar, publicar ni mostrar ninguna parte, de ninguna forma, por ningún medio. Queda prohibida la ingeniería inversa, desensamblaje o descompilación de este software, excepto en la medida en que sean necesarios para conseguir interoperabilidad según lo especificado por la legislación aplicable.

Exención de responsabilidad de la garantía

La información contenida en este documento puede someterse a modificaciones sin previo aviso y no se garantiza que se encuentre exenta de errores. Si detecta algún error, le agradeceremos que nos lo comunique por escrito.

Disposición de derechos restringidos

Si este software o la documentación relacionada se entrega al Gobierno de EE.UU. o a cualquier entidad que adquiera las licencias en nombre del Gobierno de EE.UU. entonces aplicará la siguiente disposición:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Disposición de aplicaciones peligrosas

Este software o hardware se ha desarrollado para uso general en diversas aplicaciones de gestión de la información. No se ha diseñado ni está destinado para utilizarse en aplicaciones de riesgo inherente, incluidas las aplicaciones que pueden causar daños personales. Si utiliza este software o hardware en aplicaciones de riesgo, usted será responsable de tomar todas las medidas apropiadas de prevención de fallos, copia de seguridad, redundancia o de cualquier otro tipo para garantizar la seguridad en el uso de este software o hardware. Oracle Corporation y sus filiales declinan toda responsabilidad derivada de los daños causados por el uso de este software o hardware en aplicaciones de riesgo.

Disposición de marca registrada

Oracle y Java son marcas registradas de Oracle y/o sus filiales. Todos los demás nombres pueden ser marcas comerciales de sus respectivos propietarios.

Intel e Intel Xeon son marcas comerciales o marcas comerciales registradas de Intel Corporation. Todas las marcas comerciales de SPARC se utilizan con licencia y son marcas comerciales o marcas comerciales registradas de SPARC International, Inc. AMD, Opteron, el logotipo de AMD y el logotipo de AMD Opteron son marcas comerciales o marcas comerciales registradas de Advanced Micro Devices. UNIX es una marca comercial registrada de The Open Group.

Exención de responsabilidad sobre el contenido, los productos y los servicios de terceros

Este software o hardware y la documentación pueden proporcionar acceso a, o información sobre contenidos, productos o servicios de terceros. Oracle Corporation o sus filiales no son responsables y por ende desconocen cualquier tipo de garantía sobre el contenido, los productos o los servicios de terceros a menos que se indique otra cosa en un acuerdo en vigor formalizado entre Ud. y Oracle. Oracle Corporation y sus filiales no serán responsables frente a cualesquiera pérdidas, costos o daños en los que se incurra como consecuencia de su acceso o su uso de contenidos, productos o servicios de terceros a menos que se indique otra cosa en un acuerdo en vigor formalizado entre Ud. y Oracle.

Disposición de la documentación en borradores Alfa y Beta

Si este documento se encuentra en estado previo a la publicación:

Esta documentación se encuentra en estado previo a producción y tiene una finalidad exclusivamente demostrativa y preliminar. Puede que no sea específica del hardware en el que se esté utilizando el software. Ni Oracle Corporation ni sus filiales son responsables de ofrecer cualquier tipo de garantía sobre esta documentación y renuncian explícitamente a ello; además no se harán responsables de las pérdidas, los costos o los daños en los que se incurra como consecuencia del uso de esta documentación.

Disposición privada de la documentación en borradores Alfa y Beta

Si este documento se encuentra en estado privado previo a la publicación:

La información incluida en este documento se proporciona a efectos únicamente informativos y debería tenerla en cuenta tan solo en calidad de miembro del comité asesor del cliente o conforme al acuerdo firmado sobre prueba de versiones beta. No supone compromiso alguno de entrega de ningún material, código o funcionalidad, ni debe constituir base alguna para la adopción de decisiones de compra. El desarrollo, lanzamiento y plazo de puesta a disposición de cualesquiera funciones o funcionalidades descritas en este documento quedará a la sola discreción de Oracle.

Este documento, en cualquier formato, software o impreso, contiene información protegida que es propiedad exclusiva de Oracle. Su acceso y uso de este material confidencial está sujeto a los términos y condiciones de su Acuerdo Marco Oracle, Acuerdo de Licencia y Servicios Oracle, Acuerdo Oracle PartnerNetwork, Acuerdo de Distribución Oracle u otro acuerdo de licencia formalizado entre Ud. y Oracle y que usted se obliga a cumplir. Este documento y la información que contiene no podrán ser revelados, copiados, reproducidos ni distribuidos a ninguna persona ajena a Oracle sin el consentimiento previo por escrito de Oracle. Este documento no forma parte de su acuerdo de licencia ni se puede incorporar a ningún acuerdo contractual con Oracle ni sus subsidiarias o filiales.

Accesibilidad a la documentación

Para obtener información acerca del compromiso de Oracle con la accesibilidad, visite el sitio web del Programa de Accesibilidad de Oracle en http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Acceso a Oracle Support

Los clientes de Oracle que hayan adquirido servicios de soporte disponen de acceso a soporte electrónico a través de My Oracle Support. Para obtener información, visite http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info o http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs si tiene problemas de audición.