Uso básico del SDSF (Parte 6: Panel ST)

  El Sistema de Visualización y Facilitación de Búsqueda ["System Display and Search Facility" ("SDSF") , en inglés] del sistema operativo z/OS, visto en entradas anteriores, es una herramienta, desarrollada por la empresa IBM, que permite monitorizar ordenadores centrales, y gestionar algunos de sus aspectos.
  Mediante esta herramienta es posible precisar la monitorización tanto de las operaciones que se ejecutan en el z/OS, como de los recursos del sistema. Para realizar correctamente su función, el SDSF posee diferentes pantallas, o paneles, que son tan altamente configurables como el resto del sistema operativo al que pertenecen.
  Por otra parte, esta herramienta está provista de numerosos filtros para delimitar las monitorizaciones y las consultas en sus numerosos paneles, además de un conjunto de comandos con los que el usuario puede administrar algunas de las operaciones observadas mediante este programa.
  Mientras que algunos de los comandos y filtros funcionan en todas las pantallas, otros únicamente se pueden ejecutar en algunas de las mismas; en ambos casos, si el usuario tiene los permisos adecuados, obviamente.

  En la presente entrada de esta bitácora, se hablará de la pantalla de estado ("Status Panel", en  inglés) desde la que se puede ver información acerca de las operaciones, las tareas iniciadas, y usuarios del TSO en las colas JES.
  Se puede acceder a esta pantalla, o panel, del SDSF introduciendo, en la línea de "COMMAND INPUT", el comando ST.

COLUMNAS DEL PANEL

  A excepción de la columna "NP" (donde se escriben los comandos que permiten al usuario manipular las operaciones), las columnas (de izquierda a derecha) más relevantes del panel "ST" son:

Nombre columna	Título mostrado	Descripción
JNAME	JOBNAME	Nombre de la operación. Es un campo fijo. Es ignorado si está codificado en un estado FLD o en una macro ISFFLD.
JTYPE	Type	Tipo de espacio de dirección.
JNUM	JNum1	Número de operación JES.
JOBID	JobID	Identificador de operación JES.
OWNERID	Owner	Identificador de usuario del propietario de la operación (o valores predeterminados de "++++++++" o "????????" si el usuario no está definido en el RACF).
JPRIO	Prty	Prioridad de la operación en la cola de JES.
QUEUE	Queue	Nombre de cola JES por operación.
JCLASS	C	Clase de entrada JES.
POS	Pos	Posición en la cola JES.
SYSAFF	SAff	Afinidad de la ejecución JES con el sistema (si hay alguna).
ACTSYS	Asys	Identificador JES activo del sistema.
STATUS	Status	Estado de la operación.
PRTDEST	PrtDest	Nombre de destino impreso de JES.
SECLABEL	SecLabel	Etiqueta de seguridad de la operación
TGNUM	TGNum	Grupos de pista usados por una operación.
TGPCT	TGPct	Porcentaje del uso total de grupo de pista.
ORIGNODE	OrigNode	Nombre del nodo de origen.
EXECNODE	ExecNode	Nombre del nodo en ejecución.
DEVID	Device	Nombre de dispositivo JES.
RETCODE	Max-RC	Información del código de retorno de la operación.
SRVCLS	SrvClass	Clase del servicio.
WLMPOS	WPos	Posición en la cola WLM.
SCHENV	Scheduling-Env	Entorno de planificación de la operación.
DELAY	Dly	Indicador de que una operación se retrasa.
SSMODE	Mode	Subsistema que administra la operación (JES o WLM).
ROOMN	RNum	Número de lugar de la operación JES.
PNAME	Programmer-Name	Nombre del programador JES.
ACCTN	Acct	Número de la cuenta JES.
NOTIFY	Notify	Identificador del usuario TSO del parámetro "NOTIFY" de la carta de la operación.
ISYSID	ISys	Identificador de entrada JES del sistema.
TIMER	Rd-Time	Hora en la que se lee la operación (en la tarea SDSF del z/OSMF es reemplazada por la columna "Rd-DateTime").
DATER	RD-Date	Fecha en la que se lee la operación (en la tarea SDSF del z/OSMF es reemplazada por la columna "Rd-DateTime").
ESYID	ESys	Identificador de ejecución del sistema JES.
TIMEE	St-Time	Hora en la que comienza la ejecución (en la tarea SDSF del z/OSMF es reemplazada por la columna "St-DateTime").
DATEE	St-Date	Fecha en la que comienza la ejecución (en la tarea SDSF del z/OSMF es reemplazada por la columna "St-DateTime").
TIMEN	End-Time	Hora en la que finaliza la ejecución (en la tarea SDSF del z/OSMF es reemplazada por la columna "End-DateTime").
DATEN	End-Date	Fecha en la que termina la ejecución (en la tarea SDSF del z/OSMF es reemplazada por la columna "End-DateTime").
ICARDS	Cards	Nº de cartas leídas por acción.
MCLASS	MC	Clase de mensaje de operación.
TSREC	Tot-Lines	Nº total de registros almacenados por operación.
OFFDEVS	Offs	Lista de dispositivos desconectados para una operación
SPIN	Spin	Indicador de si una operación es elegible para ser girada.
SUBGROUP	SubGroup	Grupo submitidor.
PHASENAME	PhaseName	Nombre de la fase en la que está la operación.
PHASE	Phase	Número de la fase en la que está la operación.
JOBACCT1-5	JobAcct1-51	Campo de contabilización de operación (puede haber hasta 5 de estas columnas, cada una con su número correspondiente).
JOBCORR	JobCorrelator	Porción del usuario del correlador de la operación (sólo en JES2).
ASID	ASID	Identificador AS de la operación activa.
ASIDX	ASIDX	Identificador AS de la operación activa (hexadecimal).
SYSNAME	SysName	Nombre del sistema MVS donde se ejecuta la operación.
DATETIMER	Rd-DateTime	Fecha y hora en las que se lee la operación (sólo en la tarea SDSF del z/OSMF; combina la información de las columnas "Rd-Date" y "Rd-Time").
DATETIMEE	St-DateTime	Fecha y hora en las que se ejecuta la operación (sólo en la tarea SDSF del z/OSMF; combina la información de las columnas "St-Date" y "St-Time").
DATETIMEN	End-DateTime	Fecha y hora en las que finaliza la operación (sólo en la tarea SDSF del z/OSMF; combina la información de las columnas "End-Date" y "End-Time").
JOBGROUP	JobGroup	Nombre del grupo operacional asociado a la operación (sólo en JES2).
JOBGRPID	JobGrpId	Identificador del grupo operacional JES2 de la operación.
JOBSET	JobSet	Equipo operacional dentro del grupo operacional al que pertenece la operación (sólo en JES2).
JGSTATUS	JGStatus	Estado de la operación dentro de la red de dependencia (sólo en JES2).
FLUSHACT	FlushAct	Indicador de acción de purga (sólo en JES2).
HOLDUNTIL	HoldUntil	Fecha y hora de "HOLDUNTIL".
STARTBY	StartBy	Fecha y hora de "STARTBY".
WITH	With	Nombre de la operación o tarea iniciada con la que la operación debe ejecutarse (en el mismo sistema; sólo JES2).
1 No incluida en la lista de campos predeterminados.

PARÁMETROS

   Del mismo modo que en los otros paneles del SDSF, los parámetros que se emplean en la pantalla de estado dan una mayor precisión al filtrado de los datos que muestra. Si a I no se le pone ningún parámetro, mostrará todas las operaciones. Las operaciones mostradas dependen de los permisos del usuario que realiza la consulta y pueden variar si se utilizan los parámetros PREFIX o FILTER.

  La sintaxis del comando es:

ST<clase> <parámetro>

  Este comando posee los siguientes parámetros:

•   Clase: Limita la clase de la operación. En JES2 existen hasta 6 clases diferentes de un solo caracter; para operaciones en ejecución se utiliza A-Z o 0-9. En JES3 existe una sola clase de hasta 6 caracteres. Los caracteres especiales para emplear en lugar de una clase son: "*" (cola conversora), "#" (tareas iniciadas en ejecución), "+" (cola de salida), "?" (cola de purga), "=" (cola de giro), "@" (operaciones esperando a ser transmitidas a otra cola), "$" (usuarios de TSO en ejecución), y "!" (cola impresa), "-" (cola de entrada), ")" (cola de recepción), "/" (cola de preparación).
•   Cadena: Una cadena de caracteres que limita el panel a operaciones con nombres que coincidan con la misma. La cadena puede ser de 8 o más caracteres, incluyendo "*" (cualquier cadena de caracteres) y "%" (cualquier caracter simple).

Ejemplo de salida de "ST".

COMANDOS

    Además de los vistos anteriormente, en esta pantalla existen los siguientes comandos para interactuar con las cadenas y otra información mostrada (todos ellos se escriben en la columna "NP", en la fila correspondiente a la operación sobre la que se va a actuar):

•   //: Bloquea la repetición (se escribe en la primera y en la última de las filas procesadas).
•   =: Repite el comando anterior o lo sobreescribe.
•   +(n): Expande la columna "NP" ("n" es 4-20). Se emplea RESET para restablecerla.
•   %(exec): Activa el ejecutable REXX (sólo en ISPF).
•   /: Muestra los valores de la columna para la fila (sólo en ISPF).
•   A: Libera una operación retenida.
•   C: Cancela una operación. En JES3 también procesa la salida de ficheros. Pueden añadirse los siguientes parámetros: "A" (operación definida por ARM), "D" (coge un volcado), "DA" (operación definida por ARM, y que coge un volcado), "DP" (coge un volcado, pero no elimina la salida de la operación; sólo en JES3), "P" (imprime los ficheros preparados para impresión; sólo JES3).
•   D: Muestra información de la operación en el registro. Pueden añadirse los siguientes parámetros: "E" (línea, página, registro, programas incluídos; sólo JES3), "L" (forma alargada; sólo JES2), "M" (red en la que se puede elegir una operación para que funcione), "MA" (información sobre la cola MDS asignada; sólo JES3), "ME" (información sobre la cola de error MDS; sólo JES3), "MR" (información sobre la cola MDS reiniciada; sólo JES3), "MSS" (información sobre la cola MDS del sistema selecionado; sólo JES3), "MSV" (información sobre la cola MDS de verificación del sistema; sólo JES3), "MU" (información sobre los volúmenes MDS indisponibles; sólo JES3), "P" (dependencias), "SD" (DDNAMES de la bobina de ficheros que contienen datos; sólo JES3), "SH" (DDNAMES de la bobina de ficheros en la bobina retenida que contiene datos; sólo JES3), "SP" (nombre de partición de la bobina; sólo JES3), "X" (extendido; sólo JES3).
•   E: Procesa una operación. Pueden añadirse los siguientes parámetros: "C" (cancela y retiene la operación anterior a la ejecución), "S" (completa después el paso actual), "SH" (completa, reinicia y retiene después del paso actual).
•   H: Retiene una operación.
•   I: Muestra información detallada de la operación.
•   J: Inicia una operación inmediatamente.
•   JD: Muestra el uso de los dispositivos de la operación.
•   JM: Muestra el uso de la memoria de la operación.
•   JP: Muestra las dependencias de la operación.
•   L: Lista el estado de salida de una operación en el registro. En JES3, es la salida de la operación en la cola escrita. Se pueden añadir los siguientes parámetros: "B" (salida SNA/NJE; sólo JES3), "H" (salida de la cola retenida; sólo JES3), "L" (forma larga), "T" (salida TCP/IP de la operación; sólo JES3).
•   O: Libera una salida retenida para impresión (sólo JES2).
•   P: Cancela una operación y purga su salida.
•   PO: Purga la salida (sólo JES2).
•   PP: Cancela una operación protegida y purga su salida (sólo JES2).
•   Q: Muestra descriptores  de salida para todos los ficheros en un grupo de salida.
•   S: Muestra los archivos de una operación. Se pueden añadir los siguientes parámetros: "B" (usar el buscador ISPF), "E" (usar editor ISPF), "J" (usar editor ISPF para editar el JCL), "n" (número de ficheros donde se comienza a buscar).
•  W: Crea registros de operaciones y de mensajes para girar.
•   X: Imprime la salida de los ficheros.  Se pueden añadir los siguientes parámetros: "C" (cierra el archivo de impresión después de imprimir), "D" (muestra el panel "Open Print Data Set"), "F" (muestra el panel "Open Print File"), "S" (muestra el panel "Open Print").
•   ?: Muestra una lista de ficheros de una operación.

Ejemplo de comando "JD" (entrada).

Ejemplo de comando "JD" (salida).

  Aguardo que la presente entrada haya sido de interés del lector. De ser así, espero que éste la comente y/o la comparta, por favor.