DEFINE STGCLASS (definir correlación de clase de almacenamiento con conjunto de páginas) en z/OS

Utilice el mandato MQSC DEFINE STGCLASS para definir una correlación de clase de almacenamiento con conjunto de páginas.

Utilización de mandatos MQSC en z/OS

Para obtener información sobre cómo utilizar los mandatos MQSC en z/OS®, consulte Orígenes desde los que puede emitir mandatos MQSC y PCF en IBM® MQ for z/OS.

Puede emitir este mandato desde los orígenes 2CR. Para obtener una explicación de los símbolos de origen, consulte Orígenes desde los que puede emitir mandatos MQSC y PCF en IBM MQ for z/OS.

Diagrama de sintaxis
Notas de uso para DEFINE STGCLASS
Descripciones de parámetros para DEFINE STGCLASS

Sinónimo: DEF STC

Los valores que se muestran encima de la línea principal en el diagrama de sintaxis son los valores predeterminados que se proporcionan con IBM MQ, pero es posible que la instalación los haya cambiado. Para obtener una explicación sobre cómo utilizar estos diagramas, consulte Cómo leer diagramas de sintaxis.

DEFINE STGCLASS

Notas:

¹ Sólo es válido en z/OS cuando el gestor de colas es miembro de un grupo de compartición de colas.

Notas de uso para DEFINE STGCLASS

Los valores resultantes de XCFGNAME y XCFMNAME deben estar en blanco o no estar en blanco.
Puede cambiar una clase de almacenamiento sólo si no está siendo utilizada por ninguna cola. Para determinar si alguna cola está utilizando la clase de almacenamiento, puede utilizar el mandato siguiente:
```
DISPLAY QUEUE(*) STGCLASS(ABC) PSID(n)
```
donde 'ABC' es el nombre de la clase de almacenamiento y n es el identificador del conjunto de páginas con el que está asociada la clase de almacenamiento.

Este mandato proporciona una lista de todas las colas que hacen referencia a la clase de almacenamiento y tienen una asociación activa con el conjunto de páginas ny, por lo tanto, identifica las colas que realmente impiden el cambio en la clase de almacenamiento. Si no especifica el PSID, sólo obtendrá una lista de colas que potencialmente detienen el cambio.

Consulte el mandato DISPLAY QUEUE PSID para obtener más información sobre la asociación activa de una cola a un conjunto de páginas.

Descripciones de parámetros para DEFINE STGCLASS

(clase-almacenamiento)

Nombre de la clase de almacenamiento.

Este nombre tiene de uno a 8 caracteres. El primer carácter está en el rango de A a Z; los caracteres subsiguientes son de A a Z o de 0 a 9.

Nota: Excepcionalmente, se permiten determinados nombres de clase de almacenamiento numéricos, pero están reservados para el uso del personal de servicio de IBM .

La clase de almacenamiento no debe ser la misma que cualquier otra clase de almacenamiento definida actualmente en este gestor de colas.

CMDSCOPE

Este parámetro especifica cómo se ejecuta el mandato cuando el gestor de colas es miembro de un grupo de compartición de colas.

CMDSCOPE debe estar en blanco o ser el gestor de colas local, si QSGDISP está establecido como GROUP.

' ': El mandato se ejecuta en el gestor de colas en el que se ha especificado.
nombre-gestcolas: El mandato se ejecuta en el gestor de colas que especifique, siempre que el gestor de colas esté activo dentro del grupo de compartición de colas.
Puede especificar un nombre de gestor de colas distinto del gestor de colas en que se haya entrado el mandato, solamente si está utilizando un entorno de colas compartidas y si el servidor de mandatos está habilitado.
*: El mandato se ejecuta en el gestor de colas local y también se pasa a cada gestor de colas activo del grupo de compartición de colas. El efecto de * es el mismo que entrar el mandato en cada gestor de colas del grupo de compartición de colas.

DESCR ( descripción )

Comentario en texto sin formato. Proporciona información descriptiva sobre el objeto cuando un operador emite el mandato DISPLAY STGCLASS.

Debe contener sólo caracteres visualizables. La longitud máxima es de 64 caracteres. En una instalación DBCS, contiene caracteres DBCS (sujetos a una longitud máxima de 64 bytes).

Nota: Si se utilizan caracteres que no están en el identificador de juego de caracteres codificados (CCSID) para este gestor de colas, es posible que se conviertan incorrectamente si la información se envía a otro gestor de colas

LIKE ( nombre-stgclass )

El nombre de un objeto del mismo tipo, con parámetros que se utilizan para modelar esta definición.

Si este campo no se ha completado y no completa los campos de parámetro relacionados con el mandato, los valores se toman de la definición predeterminada para este objeto.

La no cumplimentación de este parámetro equivale a especificar:

LIKE(SYSTEMST)

La instalación puede modificar esta definición de clase de almacenamiento predeterminada a los valores predeterminados necesarios.

El gestor de colas busca un objeto con el nombre que especifique y una disposición de QMGR o COPY. La disposición del objeto LIKE no se copia en el objeto que está definiendo.

Nota:

No se busca en los objetos QSGDISP (GROUP).
LIKE se ignora si se especifica QSGDISP (COPY).

PASSTKTA ( nombre de aplicación )

El nombre de aplicación que se pasa a RACF® al autenticar el PassTicket especificado en la cabecera MQIIH.

PSID ( entero )

El identificador de conjunto de páginas con el que se va a asociar esta clase de almacenamiento.

Nota: No se realiza ninguna comprobación de que el conjunto de páginas se ha definido; sólo se genera un error cuando se intenta colocar un mensaje en una cola que especifica esta clase de almacenamiento (MQRC_PAGESET_ERROR).

La serie consta de dos caracteres numéricos, en el rango de 00 a 99. Consulte DEFINE PSID (definir conjunto de páginas y agrupación de almacenamiento intermedio) en z/OS.

QSGDISP

Especifica la disposición del objeto en el grupo.

Tabla 1. Disposiciones de objeto para QSGDISP opciones
QSGDISP	DEFINE
Copiar	El objeto se define en el conjunto de páginas del gestor de colas que ejecuta el mandato. Utiliza el objeto QSGDISP(GROUP) del mismo nombre que el objeto LIKE. Por ejemplo, si emite el mandato siguiente, `DEFINE STGCLASS(storage_class_name) REPLACE QSGDISP(COPY)` el gestor de colas busca en el repositorio de configuración compartida una definición de `STGCLASS` denominada `storage_class_name`. Si se encuentra una definición de `STGCLASS` coincidente, el gestor de colas crea una copia local de esta definición en el conjunto de páginas del gestor de colas. Para las colas locales, los mensajes se almacenan en los conjuntos de páginas de cada gestor de colas y sólo están disponibles a través de dicho gestor de colas.
Grupo	La definición de objeto reside en el repositorio de configuración compartido. QSGDISP(GROUP) solo está permitido si el gestor de colas está en un grupo de compartición de colas. Si el mandato DEFINE para el objeto QSGDISP(GROUP) es satisfactorio, se genera el mandato `DEFINE STGCLASS(storage_class_name) REPLACE QSGDISP(COPY)` y se envía a todos los gestores de colas activos del grupo de compartición de colas para realizar o renovar copias locales en el conjunto de páginas cero. El DEFINE para el objeto de grupo entra en vigor independientemente de si el mandato generado con QSGDISP(COPY) falla.
private	No permitido.
QMGR	El objeto se define en el conjunto de páginas del gestor de colas que ejecuta el mandato.

REPLACE y NOREPLACE

Si la definición existente, y con la misma disposición, se va a sustituir por esta. Cualquier objeto con una disposición diferente no se cambia.

REPLACE: La definición sustituye cualquier definición existente del mismo nombre. Si no existe ninguna definición, se creará una.
Si utiliza la opción REPLACE, todas las colas que utilizan esta clase de almacenamiento deben alterarse temporalmente para utilizar otra clase de almacenamiento mientras se emite el mandato.
NOREPLACE: La definición no sustituye ninguna definición existente del mismo nombre.

XCFGNAME ( nombre de grupo )

Si está utilizando el puente IMS , este nombre es el nombre del grupo XCF al que pertenece el sistema IMS . (Este nombre es el nombre de grupo especificado en la lista de parámetros IMS .)

Este nombre tiene de 1 a 8 caracteres. El primer carácter está en el rango de A a Z; los caracteres posteriores son de A a Z o de 0 a 9.

XCFMNAME ( nombre de miembro )

Si está utilizando el puente IMS , este nombre es el nombre de miembro XCF del sistema IMS dentro del grupo XCF especificado en XCFGNAME. (Este nombre es el nombre de miembro especificado en la lista de parámetros IMS .)

Este nombre tiene de 1 a 16 caracteres. El primer carácter está en el rango de A a Z; los caracteres posteriores son de A a Z o de 0 a 9.