3 Comandos de configuración y administración de XAPI de XCMD

En este capítulo, se describen los comandos de configuración y administración de XAPI admitidos por XCMD. Estos comandos activan las funciones de agrupación de volúmenes compatibles con ELS en ACSLS versión 8.4. Los comandos admitidos incluyen:

• DEFINE POOL_Name

• DEFINE POOL_Access

• DELETE POOL_Name

• DELETE POOL_Access

• SET POOL_Name

• QUERY POOL_Name

• QUERY POOL_Access

Ejecute estos comandos desde user_proc de ACSLS utilizando el comando XCMD. Consulte el Capítulo 2, Convenciones de comandos XCMD para obtener más información.

Consulte Convenciones de sintaxis para obtener información sobre las convenciones utilizadas en los diagramas de flujo de sintaxis incluidos en las secciones de comandos a continuación.

DEFINE POOL_Name

En la siguiente sección, se describe el comando DEFINE POOL_Name.

Descripción

El comando DEFINE POOL_NAME asocia un tipo y un nombre de agrupación con un ID de agrupación de ACSLS.

Sintaxis

En la siguiente figura, se muestra la sintaxis del comando DEFINE POOL_Name:

Figura 3-1 Sintaxis del comando DEFINE POOL_Name

Parámetros

Como se muestra en la Figura 3-1, el comando DEFINE POOL_Name incluye los siguientes parámetros:

pool_name

Un nombre de agrupación de hasta 13 caracteres. El nombre de agrupación puede incluir cualquier carácter a excepción del signo de porcentaje ("%"), el guion bajo ("_") y el asterisco ("*").

POOLTYpe

El tipo de agrupación: Scratch (el valor por defecto) o Mvc.

POOLId (nnnnn)

De manera opcional, especifica el ID de la agrupación (nnnnn).

• Si decide especificar este parámetro, debe indicar un ID de agrupación que no exista actualmente.

• Si no se especifica este parámetro, el sistema asigna automáticamente un ID de agrupación igual al primer valor sin usar a partir de 10000.

Ejemplo

En el siguiente ejemplo, el usuario ejecuta el comando DEFINE POOL_Name para definir la agrupación reutilizable SCRPOOL1:

XCMD DEFINE POOL_NAME SCRPOOL1 POOLTYPE SCRATCH

DEFINE POOL_Access

En la siguiente sección, se describe el comando DEFINE POOL_Access.

Descripción

El comando DEFINE POOL_Access define el acceso permitido para un pool_name mediante un host especificado. Si no se define ningún acceso de agrupación para un pool_name específico, se permite el acceso total.

Sintaxis

En la siguiente figura, se muestra la sintaxis del comando DEFINE POOL_Access:

Figura 3-2 Sintaxis del comando DEFINE POOL_Access

Parámetros

Como se muestra en Figura 3-2, el comando DEFINE POOL_Access incluye los siguientes parámetros:

pool_name

Un nombre de agrupación de hasta 13 caracteres. El nombre de agrupación puede incluir cualquier carácter a excepción del signo de porcentaje ("%"), el guion bajo ("_") y el asterisco ("*"). El pool_name especificado debe haberse definido previamente utilizando el comando DEFINE POOL_Name con el tipo de agrupación SCRATCH (no se define el acceso para las agrupaciones MVC). Consulte DEFINE POOL_Name para obtener más información.

HOSTid host_name

Especifica un nombre de host de hasta 31 caracteres. Este parámetro es obligatorio.

El HOSTid especificado es la parte del nombre de dominio completo de Internet que hace referencia al nombre de host. Por ejemplo, si el nombre de dominio completo es myhost.plus.domain.name, el HOSTid especificado es myhost.

ALLOWMount

De manera opcional, especifica el acceso de montaje. Puede especificar True (Verdadero) o False (Falso). Este parámetro solo es válido para una agrupación definida como POOLTYPE MVC.

ALLOWSELscratch

De manera opcional, especifica el acceso para los comandos de XAPI query_scr_mnt_info, sel_scratch y mount para un volumen reutilizable. Puede especificar True (Verdadero) o False (Falso). Si no especifica este parámetro, se establece en True (Verdadero) por defecto.

Este parámetro solo es válido para una agrupación definida como POOLTYPE SCRATCH. Si se especifica este parámetro para una agrupación definida como MVC, el parámetro recibe automáticamente el valor por defecto False (Falso).

ALLOWSCRatch

De manera opcional, especifica el acceso reutilizable. Puede especificar True (Verdadero) o False (Falso). Si no especifica este parámetro, se establece en True (Verdadero) por defecto.

Este parámetro solo es válido para una agrupación definida como POOLTYPE SCRATCH. Si se especifica este parámetro para una agrupación definida como MVC, el parámetro recibe automáticamente el valor por defecto False (Falso).

Ejemplo

En el siguiente ejemplo, el usuario ejecuta el comando DEFINE POOL_Access para definir el acceso para el nombre de agrupación reutilizable SCRPOOL1, donde el host es PRODMVS, y ALLOWMOUNT y ALLOWSCRATCH son True (Verdadero):

XCMD DEFINE POOL_ACCESS SCRPOOL1 HOSTID PRODMVS ALLOWMOUNT TRUE ALLOWSCRATCH TRUE

DELETE POOL_Name

En la siguiente sección, se describe el comando DELETE POOL_Name.

Descripción

El comando DELETE POOL_Name suprime una agrupación. Este comando es similar al comando delete pool de ACSLS, con las siguientes excepciones:

• La entrada especifica un nombre de agrupación en lugar de un ID de agrupación.

• El usuario puede elegir que los volúmenes asignados a la agrupación se reasignen a la agrupación 0.

Consulte la Guía del administrador de StorageTek Automated Cartridge System Library Software (ACSLS) para obtener más información sobre el comando delete pool de ACSLS.

Sintaxis

En la siguiente figura, se muestra la sintaxis del comando DELETE POOL_Name:

Figura 3-3 Sintaxis del comando DELETE POOL_Name

Parámetros

Como se muestra en la Figura 3-3, el comando DELETE POOL_Name incluye los siguientes parámetros:

pool_name

Un nombre de agrupación de hasta 13 caracteres. El nombre de agrupación puede incluir cualquier carácter a excepción del signo de porcentaje ("%"), el guion bajo ("_") y el asterisco ("*"). El pool_name especificado debe haberse definido previamente utilizando el comando DEFINE POOL_Name. Consulte DEFINE POOL_Name para obtener más información.

RESETvols

Indica que los volúmenes actualmente asignados a la agrupación que se suprime deben reasignarse a la agrupación 0. Si no se especifica este parámetro y existen volúmenes actualmente dentro de esta agrupación, el comando delete pool-name genera un error.

Ejemplo

En el siguiente ejemplo, el usuario ejecuta el comando DELETE POOL_Name para suprimir la agrupación SCRPOOL1 y reasignar sus volúmenes a la agrupación 0 (la agrupación por defecto):

XCMD DELETE POOL_NAME SCRPOOL_TEST1 RESETVOLS

DELETE POOL_Access

En la siguiente sección, se describe el comando DELETE POOL_Access.

Descripción

El comando DELETE POOL_Access suprime las reglas de acceso a agrupación asociadas con un solo nombre de host (host_id) o suprime todas las reglas de acceso a agrupación de todos los hosts.

• Si se especifica un nombre de host (host_id), se suprimen solo las reglas de acceso del host especificado en la agrupación indicada.

• Si se especifica ALLhost, se suprimen todas las reglas de acceso a la agrupación.

Sintaxis

En la siguiente figura, se muestra la sintaxis del comando DELETE POOL_Access:

Figura 3-4 sintaxis del comando DELETE POOL_Access

Parámetros

Como se muestra en sintaxis del comando DELETE POOL_Access, el comando DELETE POOL_Access incluye los siguientes parámetros:

pool_name

Un nombre de agrupación de hasta 13 caracteres. El nombre de agrupación puede incluir cualquier carácter a excepción del signo de porcentaje ("%"), el guion bajo ("_") y el asterisco ("*"). El pool_name especificado debe haberse definido previamente utilizando el comando DEFINE POOL_Name. Consulte DEFINE POOL_Name para obtener más información.

HOSTid host_name

De manera opcional, especifica un nombre de host de hasta 31 caracteres e indica que se deben eliminar las restricciones de acceso para este ID de host (sin cambios en las reglas de acceso del resto de los ID de host). Este parámetro y ALLhost se excluyen mutuamente.

ALLhost

Opcionalmente, especifica que se eliminen todas las restricciones de acceso para el pool_name específico de todos los ID de host. Este parámetro y HOSTid se excluyen mutuamente.

Ejemplo

En el siguiente ejemplo, el usuario ejecuta el comando DELETE POOL_Access para suprimir el acceso a la agrupación del host PRODMVS a SCRPOOL1:

XCMD DELETE POOL_ACCESS SCRPOOL1 HOSTID PRODMVS

SET POOL_Name

En la siguiente sección, se describe el comando SET POOL_Name.

Descripción

El comando SET POOL_Name asigna volúmenes a un nombre de agrupación o establece el límite inferior de un nombre de agrupación.

Nota:

Si la sintaxis del comando es válida, se agregan los rangos de volumen especificados a la base de datos aunque algunos volúmenes dentro del rango no se puedan agregar a la agrupación. Los volúmenes no se pueden agregar a la agrupación si alguna de las siguientes condiciones es verdadera:

• El volumen tiene el valor LOCKed (Bloqueado).

• El volumen ya está en una agrupación diferente, a menos que se especifique FORCE.

• El volumen está en una biblioteca lógica.

• El volumen tiene un propietario de ACSLS y el control de acceso está en vigor.

Sintaxis

En la siguiente figura, se muestra la sintaxis del comando SET POOL_Name:

Figura 3-5 Sintaxis del comando SET POOL_Name

Parámetros

Como se muestra en la Figura 3-5, el comando SET POOL_Name incluye los siguientes parámetros:

pool_name

Un nombre de agrupación de hasta 13 caracteres. El nombre de agrupación puede incluir cualquier carácter a excepción del signo de porcentaje ("%"), el guion bajo ("_") y el asterisco ("*"). El pool_name especificado debe haberse definido previamente utilizando el comando DEFINE POOL_Name. Consulte DELETE POOL_Name para obtener más información.

LOWwater nnnnnnn

De manera opcional, define el número mínimo de volúmenes disponibles que debe contener la agrupación. Si el número de volúmenes disponibles cae por debajo del límite inferior, el sistema ACSLS genera una advertencia.

VOLumes o VOLSer (volser-list, volser-range, range-list)

De manera opcional, especifica una lista de volsers, un rango de volsers o una lista de rangos de volsers. Puede especificar un máximo de 16 volúmenes simples o rangos.

Los rangos de volúmenes se evalúan según los rangos de volsers con formato ACSLS (secuencia de ordenación ACSII), y no es necesario que cumplan con los rangos de patrones de volumen HSC; sin embargo, ambos números de serie de volumen en un solo rango deben contener el mismo número de caracteres, y solo se consideran dentro del rango los números de serie de volumen con la misma cantidad de caracteres. Por ejemplo, el rango 1234-12356 no es válido. En el rango 1234-2345, un número de serie 123567 no se considera dentro del rango. Si los rangos especificados son válidos, se agregan a la base de datos aunque algunos volúmenes dentro del rango no se puedan asignar a la agrupación. Los rangos de volúmenes especificados no deben superponerse entre ellos ni con ninguno de los rangos de volúmenes existentes.

Los rangos de volúmenes se evalúan según los rangos de volsers con formato ACSLS:

• Ambos volsers especificados en el rango deben contener el mismo número de caracteres.

• El primer elemento de volser en el rango debe ser estrictamente menor que el segundo elemento de volser.

• Si los volsers especificados tienen menos de 6 caracteres de longitud, los volsers se evalúan como si fueran campos de 6 caracteres en blanco y alineados a la izquierda.

• En el rango solo hay volsers estrictamente mayores o iguales que el primer elemento de volser y estrictamente menores o iguales que el segundo elemento de volser cuando se evalúan utilizando la secuencia de ordenación ASCII. Por ejemplo, el rango de volsers 123456-234567 contiene el volser 12345A.

Si los rangos especificados son válidos, se agregan a la base de datos de pool_name aunque algunos volúmenes dentro del rango no se puedan asignar a la agrupación. Los rangos de volúmenes especificados no deben superponerse entre ellos ni con ninguno de los rangos de volúmenes existentes.

ADD

Indica que los rangos de volúmenes especificados se agregarán a los rangos existentes en la agrupación. Este es el valor por defecto. Si se especifica, también se debe especificar VOLumes. ADD y REPLace se excluyen mutuamente.

REPlace

Indica que los rangos de volúmenes especificados deben sustituir los rangos de volúmenes especificados actualmente y que los volúmenes en los rangos anteriores se deben reasignar a la agrupación 0. Si se especifica, también se debe especificar VOLumes (o VOLSer). REPlace y ADD se excluyen mutuamente.

FORCE

De manera opcional, indica que los volúmenes ya asignados a otras agrupaciones se deben reasignar a la agrupación nueva. Si no se especifica este parámetro, no se actualiza ningún volumen actualmente asignado a una agrupación diferente. Si se especifica, también se debe especificar VOLumes (o VOLSer).

APPLY

De manera opcional, indica que los rangos de volúmenes definidos anteriormente se deben aplicar a los volúmenes de la base de datos. Este parámetro se puede usar cuando no se hayan actualizado algunos volúmenes debido a las restricciones que se detallaron anteriormente. Si se especifica, también se debe especificar VOLumes (o VOLSer).

Ejemplo

En el siguiente ejemplo, el comando agrega los volúmenes DRL001-DRL999 a SCRPOOL1:

XCMD SET POOL_NAME SCRPOOL_TEST1 VOLUMES DRL001-DRL999

QUERY POOL_Name

En la siguiente sección, se describe el comando QUERY POOL_Name.

Descripción

El comando QUERY POOL_Name muestra todas las agrupaciones, las agrupaciones que comienzan con los caracteres especificados o una sola agrupación.

Sintaxis

En la siguiente figura, se muestra la sintaxis del comando QUERY POOL_Name:

Figura 3-6 Sintaxis del comando QUERY POOL_Name

Parámetros

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

pool_name

Un nombre de agrupación existente de hasta 13 caracteres o un nombre genérico con un carácter de asterisco ("*") al final. Este parámetro es obligatorio.

El formato pool_name determina la salida que se muestra de la siguiente manera:

• Cuando pool_name no es un nombre genérico, la información de agrupación que se muestra incluye los volsers y los rangos de volsers definidos para la única agrupación coincidente.

• Cuando pool_name es un nombre genérico (incluye un "*" final), la información de agrupación que se muestra no incluye los volsers y los rangos de volsers definidos para las agrupaciones coincidentes.

Ejemplo

En el siguiente ejemplo, el usuario ejecuta el comando QUERY POOL_Name para mostrar información sobre pool1, incluidos los rangos de volúmenes asociados.

XCMD QUERY POOL_NAME POOL1

En el siguiente ejemplo, el usuario ejecuta el comando QUERY POOL_Name para mostrar información sobre todas las agrupaciones mencionadas (sin incluir los rangos de volúmenes):

XCMD QUERY POOL_NAME *

En el siguiente ejemplo, el usuario ejecuta el comando QUERY POOL_Name para mostrar información sobre todas las agrupaciones que comienzan con "A" (sin incluir los rangos de volúmenes):

XCMD QUERY POOL_NAME A*

QUERY POOL_Access

En la siguiente sección, se describe el comando QUERY POOL_Access.

Descripción

El comando QUERY POOL_Access muestra las reglas de acceso a agrupación de un solo host o de todos los hosts asociados con un nombre de agrupación.

Sintaxis

En la siguiente figura, se muestra la sintaxis del comando QUERY POOL_Access:

Figura 3-7 Sintaxis del comando QUERY POOL_Access

Parámetros

Como se muestra en la Figura 3-7, el comando QUERY POOL_Access incluye los siguientes parámetros:

pool_name

Un nombre de agrupación de hasta 13 caracteres. El nombre de agrupación puede incluir cualquier carácter a excepción del signo de porcentaje ("%"), el guion bajo ("_") y el asterisco ("*"). El pool_name especificado debe haberse definido previamente utilizando el comando DEFINE POOL_Name. Consulte DEFINE POOL_Name para obtener más información.

HOSTid host_id

De manera opcional, especifica un nombre de host de 1 a 31 caracteres. El host_id especificado debe haberse definido previamente para el pool_name utilizando el comando DEFINE_POOL_Access. Consulte DEFINE POOL_Access para obtener más información.

Si no se especifica este parámetro, se muestran las reglas de acceso de todos los hosts asociados con la agrupación.

Ejemplo

En el siguiente ejemplo, el usuario ejecuta el comando QUERY POOL_Access para consultar las reglas de acceso de todos los hosts asociados con el nombre de agrupación SCRPOOL1:

XCMD QUERY POOL_ACCESS SCRPOOL1