| Nota |
|---|
|
Antes de utilizar esta información y el producto al que da soporte, no olvide leer la información general que encontrará en el apartado "Avisos". |
© Copyright International Business Machines Corporation 2020. Reservados todos los derechos.
Nota para los usuarios del Gobierno de EE. UU.: el uso, la duplicación o la
divulgación están sujetos a las restricciones establecidas en el documento GSA ADP Schedule contract con IBM Corp.
Información del nivel de programa y del nivel de servicio
Requisitos y consideraciones para la instalación
Instrucciones para la instalación
Este directorio de programas va dirigido a los programadores de sistemas responsables de la instalación y mantenimiento de programas. Contiene información acerca del material y los procedimientos asociados a la instalación de la API IBM Remote System Explorer (API RSE). En esta publicación hace referencia a la API IBM Remote System Explorer (API RSE) como API RSE.
El directorio de programa contiene las secciones siguientes:
El resto de esta sección solo se aplica cuando la API RSE se solicita a través de
Shopz. No se aplica cuando se descarga de la web.
Seleccione este enlace para ir a la siguiente sección:
"Descripción de API RSE"
Antes de instalar la API RSE, lea CBPDO Memo To Users y CBPDO Memo To Users Extension que se suministran con este programa en formato de copia software y este directorio de programa; después de ello, guarde los documentos para su referencia. La sección "Planificación de servicio preventivo" le indica cómo buscar las actualizaciones de la información y los procedimientos en este directorio del programa.
La API RSE se suministra en una oferta de entrega de productos personalizada (CBPDO, 5751-CS3). El directorio del programa que se proporciona en formato de copia software en CBPDO es idéntico al formato de copia impresa si se ha incluido uno con el pedido. Todos los servicios y HOLDDATA para la API RSE se incluyen en la CBPDO.
No utilice este directorio de programas si instala la API RSE con un SystemPac o ServerPac. Cuando utilice una de estas ofertas, utilice los trabajos y la documentación suministrados con la oferta. La oferta le indicará las secciones específicas de este directorio del programa según sea necesario.
La API IBM Remote System Explorer (API RSE) es una colección de API REST que permiten a un cliente trabajar con distintos componentes en el sistema host z/OS, incluidos conjuntos de datos MVS, archivos y mandatos de z/OS UNIX, trabajos JES y más.
La API RSE consta de los siguientes FMID:
Un programa IBM se identifica mediante un número de programa. El número de programa para la API RSE es 5655-EX1.
El material básico legible por máquina es material que se proporciona bajo la licencia básica, y es necesario para utilizar el producto.
El material de anuncio de programa describe las características soportadas por la API RSE. Solicite esta información al representante de IBM si todavía no ha recibido una copia.
El soporte de distribución de este programa es un soporte físico o archivos descargables. Este programa está en formato SMP/E RELFILE y se instala mediante SMP/E. Consulte "Instrucciones para la instalación" para obtener más información sobre cómo instalar el programa.
El resto de esta sección solo se aplica cuando la API RSE se solicita a través de
Shopz. No se aplica cuando se descarga de la web.
Seleccione este enlace para ir a la siguiente sección:
"Publicaciones del programa"
Puede encontrar información sobre el soporte físico para los materiales básicos legibles por máquina para la API RSE en la sección CBPDO Memo To Users Extension.
La Tabla 1 describe el contenido del archivo de programa para la API RSE. Puede consultar la sección CBPDO Memo To Users Extension para ver dónde residen los archivos en la imagen.
Notas:
Tabla 1. Contenido de archivo de programa
| Nombre | O
R G | R
E C F M | L
R E C L | BLK
SIZE |
|---|---|---|---|---|
| IBM.HAMA100.SMPMCS | SEQ | FB | 80 | 8800 |
| IBM.HAMA100.F1 | PDSE | FB | 80 | 8800 |
| IBM.HAMA100.F2 | PDSE | FB | 80 | 8800 |
| IBM.HAMA100.F3 | PDSE | VB | 8796 | 8800 |
Las siguientes secciones identifican las publicaciones básicas para la API RSE.
La Tabla 2 identifica las publicaciones básicas del programa sin licencia para la API RSE.
Las que están en publicaciones de formato de copia software pueden obtenerse en el sitio web de IBM Publications Center en
https://www.ibm.com/shop/publications/order.
Tabla 2. Material básico: Sin licencia
| Título de la publicación | Número de publicación | Formato de soporte |
|---|---|---|
| IBM Remote System Explorer API (RSE API) Host Configuration Guide | SC27-9905-00 | Consulte la nota 1 |
Nota:
| ||
La información necesaria se puede obtener creando un informe para la API RSE en https://www.ibm.com/software/reports/compatibility/clarity/index.html.
No se proporcionan publicaciones opcionales para la API RSE.
No se proporcionan materiales de origen de programa ni listados de programas visualizables para la API RSE.
Es posible que desee utilizar las publicaciones listadas en la
Tabla 3 durante la instalación de la API RSE.
Tabla 3. Publicaciones útiles durante la instalación
| Título de la publicación | Número de publicación |
|---|---|
| IBM SMP/E for z/OS User's Guide | SA23-2277 |
| IBM SMP/E for z/OS Commands | SA23-2275 |
| IBM SMP/E for z/OS Reference | SA23-2276 |
| IBM SMP/E for z/OS Messages, Codes, and Diagnosis | GA32-0883 |
Nota:
Esta sección describe el soporte de IBM disponible para la API RSE. El número de servicio para la API RSE es 0500520.
Póngase en contacto con el representante de IBM si desea información específica sobre los servicios del programa disponibles.
Antes de instalar la API RSE, asegúrese de haber revisado la información actual de PSP (Preventive Service Planning). Revise las secciones General Information, Installation Documentation y Cross Product Dependencies del depósito PSP (PSP Bucket). Para la sección Servicio recomendado, en lugar de revisar el depósito PSP, se recomienda utilizar la categoría de arreglo IBM.PRODUCTINSTALL-REQUIREDSERVICE en SMP/E para asegurarse de que tiene instalado todo el servicio recomendado. Utilice el operando FIXCAT (IBM.PRODUCTINSTALL-REQUIREDSERVICE) en el mandato APPLY CHECK. Consulte "Llevar a cabo la acción APPLY de SMP/E" para ver un mandato APPLY de ejemplo.
Si ha obtenido la API RSE como parte de una CBPDO, se incluye HOLDDATA.
Si la CBPDO para la API RSE tiene más de dos semanas en el momento de instalar los materiales del producto, puede obtener la información más reciente del depósito PSP yendo al siguiente sitio web:
http://www14.software.ibm.com/webapp/set2/psearch/search?domain=psp
También puede utilizar S/390 SoftwareXcel o ponerse en contacto con el centro de soporte de IBM para obtener la información de depósito PSP más reciente.
Para obtener soporte de programa, acceda al sitio web de soporte de software en http://www.ibm.com/software/support/.
Los depósitos de PSP se identifican mediante las palabras UPGRADE (actualización), que especifica los niveles de producto; y SUBSET (subconjunto), que especifica los FMID para un nivel de producto. Los valores UPGRADE y SUBSET para la API RSE se incluyen en la Tabla 4.
Tabla 4. Actualización de PSP e ID de subconjunto
| ACTUALIZACIÓN | SUBCONJUNTO | Descripción |
|---|---|---|
| ZEXPL320 | HAMA100 | API RSE |
Informe a su Centro de soporte de IBM de los problemas que crea que puedan ser un error en los materiales del producto. Es posible que se le solicite reunir y entregar diagnósticos adicionales como ayuda para el análisis en el Centro de soporte de IBM.
La Tabla 5 identifica los ID de componentes (COMPID) para la API RSE.
| FMID | COMPID | Nombre del componente | RETAIN
Release |
|---|---|---|---|
| HAMA100 | 5655EXP33 | API RSE | 320 |
Esta sección identifica el programa y los niveles de servicio relevantes de la API RSE. El nivel de programa hace referencia a las correcciones de APAR que se han incorporado en el programa. El nivel de servicio hace referencia a los PTF que se han incorporado en el programa.
No se han incorporado APAR en la API RSE.
Todos los APAR resueltos de releases anteriores de la API RSE se han incorporado a la API RSE.
No se ha incorporado ningún PTF contra este release de la API RSE en el paquete del producto.
Compruebe con frecuencia el depósito PTF de PSP de la API RSE para los PTF de atención HIPER y SPECIAL en todos los FMID que debe instalar. También puede recibir el HOLDDATA más reciente y añadir el operando FIXCAT(IBM.PRODUCTINSTALL-REQUIREDSERVICE) al mandato APPLY CHECK. Esto permitirá revisar el servicio recomendado y crítico que se debe instalar con los FMIDs.
Las secciones siguientes identifican los requisitos del sistema para instalar y activar la API RSE. Se utiliza la terminología siguiente:
Puede que el programa tenga requisitos específicos del sistema operativo o nivel de producto para utilizar procesos, como por ejemplo programas de utilidad enlazadores o de ensamblaje durante la instalación.
El programa podría tener requisitos específicos a nivel de producto, tales como necesidad de acceso a la biblioteca de otro producto para ediciones de enlace. Estos requisitos, ya sean obligatorios u opcionales, podrían afectar directamente al elemento durante la instalación o en operación básica o ampliada.
En muchos casos puede utilizar un sistema como sistema vehículo y como sistema de destino. No obstante, puede crear un clon aparte con capacidad de IPL del sistema en ejecución para utilizarlo como sistema de destino. El clon debe incluir copias de todas las bibliotecas del sistema que SMP/E actualiza, así como copias de los conjuntos de datos CSI de SMP/E que describan las bibliotecas del sistema y de PARMLIB y PROCLIB.
Utilice sistemas vehículo y de destino separados en las siguientes situaciones:
Esta sección describe el entorno del sistema vehículo necesario para instalar la API RSE.
El sistema vehículo se puede ejecutar en cualquier entorno de hardware que dé soporte al software necesario.
Tabla 6. Requisitos de software del sistema vehículo
| Número
de programa | Producto
Nombre | VRM
mínimo | Nivel de servicio
mínimo satisfará estos APAR | ¿Se incluye
en el producto enviado? |
|---|---|---|---|---|
| 5650-ZOS | z/OS | V02.02.00 o el nivel z/OS soportado más bajo, lo que sea más reciente | N/A | No |
Nota: SMP/E es un requisito para la instalación y es un elemento de z/OS.
Nota: La instalación puede requerir la migración a nuevos releases de z/OS para que tenga soporte de servicio. Consulte https://www-01.ibm.com/software/support/lifecycle/index_z.html.
La API RSE se instala en un sistema de archivos, ya sea HFS o zFS. Antes de instalar la API RSE, debe asegurarse de que los conjuntos de datos del sistema de archivos del sistema de destino están disponibles para su proceso en el sistema vehículo. OMVS debe estar activo en el sistema vehículo y los conjuntos de datos de archivos en el sistema de destino deben haberse montado en el sistema vehículo.
Si tiene previsto instalar la API RSE en un sistema de archivos zFS, esto requiere que zFS esté activo en el sistema vehículo. En la publicación z/OS Distributed File Service zSeries File System Administration (SC24-5989) encontrará información sobre cómo activar y utilizar zFS.
Esta sección describe el entorno del sistema de destino necesario para instalar y utilizar la API RSE.
La API RSE se instala en z/OS (Z038) SREL.
El sistema de destino se puede ejecutar en cualquier entorno de hardware que dé soporte al software necesario.
Los requisitos de la instalación identifican los productos que son necesarios y que deben estar presentes en el sistema, o productos que no son necesarios pero que deberían estar presentes en el sistema para la instalación satisfactoria de este producto.
Los requisitos obligatorios de la instalación identifican productos que son necesarios en el sistema para la instalación satisfactoria de este producto. Estos productos están especificados como PRE o REQ.
La API RSE no tiene requisitos de instalación obligatorios.
Los requisitos condicionales de la instalación identifican productos que no son necesarios para la instalación satisfactoria de este productor pero que pueden resolver cosas tales como determinados mensajes de aviso en el momento de la instalación. Estos productos están especificados como IF REQ.
La API RSE no tiene requisitos de instalación condicionales.
Los requisitos operativos son productos necesarios y deben estar presentes en el sistema, o productos que no son necesarios pero que deberían estar presentes en el sistema para que este producto pueda operar todas sus funciones o parte de ellas.
Los requisitos operativos obligatorios identifican productos que son necesarios para que este producto pueda operar sus funciones básicas.
Tabla 7. Requisitos operativos obligatorios del sistema de destino
| Número de programa | Nombre de producto y
nivel de servicio/VRM mínimo |
|---|---|
| 5655-EX1 | IBM Explorer para z/OS V3.1.1 o versiones posteriores |
| Nota: Un subconjunto de los FMID de 5655-EX1 se han incluido en este envío para su comodidad. Puede que ya tenga estos FMID del número de producto listado o de otro producto que los incluya. | |
Los requisitos operativos condicionales identifican productos que no son necesarios para que este producto pueda operar sus funciones básicas pero que son necesarios en el tiempo de ejecución de este producto para operar determinadas funciones. Estos productos están especificados como IF REQ.
La API RSE no tiene requisitos operativos condicionales.
Los requisitos de tolerancia/coexistencia identifican productos que deben estar presentes en sistemas para compartir. Estos sistemas pueden ser otros sistemas de un entorno de múltiples sistemas (no necesariamente sysplex), un entorno DASD compartido (como por ejemplo un entorno de prueba y de producción) o sistemas que reutilizan el mismo entorno DASD en distintos intervalos de tiempo.
La API RSE no tiene requisitos de tolerancia/coexistencia.
Los requisitos negativos identifican productos que no deben instalarse en el mismo sistema que este producto.
La API RSE no tiene requisitos negativos.
Las bibliotecas de API RSE pueden residir en todos los tipos de DASD soportados.
La Tabla 8 lista el espacio total que es necesario para cada tipo de biblioteca.
Tabla 8. Espacio DASD total que necesita la API RSE
| Tipo de biblioteca | Espacio total necesario
en pistas 3390 | Descripción |
|---|---|---|
| Destino | 10 pistas | |
| Distribución | 895 pistas | |
| Sistema(s) de archivos | 1950 pistas | |
| Descargar de la web | 2755 pistas | Esta fila solo se aplica cuando la API RSE se descarga desde la web.
No se aplica cuando lo ha solicitado a través de Shopz.
Estos son los conjuntos de datos temporales, que se pueden eliminar después de la instalación de SMP/E. |
Notas:
| U | Conjunto de datos exclusivo, asignado por este producto y utilizado solamente por este producto. Esta tabla proporciona toda la información necesaria para determinar el almacenamiento correcto para este conjunto de datos. No es necesario consultar otras tablas o directorios de programas para el tamaño del conjunto de datos. |
| S | Conjunto de datos compartido, asignado por este producto y utilizado por este producto y otros productos. Para determinar el almacenamiento correcto necesario para este conjunto de datos, añada el tamaño de almacenamiento indicado en esta tabla a los indicados en otras tablas (tal vez en otros directorios de programas). Si ya existe el conjunto de datos, debe disponer de espacio de disco suficiente para acomodar el tamaño de almacenamiento indicado en esta tabla. |
| E | Conjunto de datos compartido existente, utilizado por este producto y otros productos. Este conjunto de datos no ha sido asignado por este producto. Para determinar el almacenamiento correcto para este conjunto de datos, añada el tamaño de almacenamiento indicado en esta tabla a los indicados en otras tablas (tal vez en otros directorios de programas). Si ya existe el conjunto de datos, debe disponer de espacio de disco suficiente para acomodar el tamaño de almacenamiento indicado en esta tabla. |
Si actualmente tiene instalado un release anterior de este producto en estas bibliotecas, la instalación de este release suprimirá el anterior y reclamará el espacio utilizado por el release anterior y cualquier servicio que estuviera instalado. Puede determinar si estas bibliotecas disponen de espacio suficiente suprimiendo el release anterior con una función ficticia, comprimiendo las bibliotecas y comparando los requisitos de espacio con el espacio libre en las bibliotecas.
Para obtener más información sobre los nombres y tamaños de los conjuntos de datos necesarios, consulte "Asignar las bibliotecas de distribución y de destino de SMP/E".
| N | Vía de acceso nueva, creada por este producto. |
| X | Vía de acceso creada por este producto, pero puede que ya exista de un release anterior. |
| P | Vía de acceso que ya existía anteriormente, creada por otro producto. |
Las siguientes figuras describen las bibliotecas de destino y de distribución y las vías de acceso del sistema de archivos necesarias para instalar la API RSE. Los requisitos de almacenamiento de la API RSE deben añadirse al almacenamiento necesario para otros programas que tengan datos en la misma biblioteca o vía de acceso.
Nota: utilice los datos de esas tablas para determinar qué bibliotecas se pueden fusionar el conjuntos de datos comunes. Además, puesto que es posible que algunos nombres ALIAS no sean exclusivos, asegúrese de que no haya conflictos de denominación antes de fusionar las bibliotecas.
Tabla 9. Requisitos de almacenamiento para las bibliotecas de destino de la API RSE
| Biblioteca
DDNAME | Miembro
Tipo | Destino
Volumen | T
Y P E | O
R G | R
E C F M | L
R E C L | Núm.
de pistas 3390 | Núm.
de bloques DIR |
|---|---|---|---|---|---|---|---|---|
| SHUHSAMP | Ejemplos | ANY | U | PDSE | FB | 80 | 10 | 5 |
Tabla 10. Vías de acceso del sistema de API RSE
| DDNAME | T
Y P E | Nombre de vía de acceso |
|---|---|---|
| SHUHZFS | X | /usr/lpp/IBM/rseapi/IBM |
Tabla 11. Requisitos de almacenamiento para las bibliotecas de distribución de API RSE
| Biblioteca
DDNAME | T
Y P E | O
R G | R
E C F M | L
R E C L | Núm.
de pistas 3390 | Núm.
de bloques DIR |
|---|---|---|---|---|---|---|
| AHUHSAMP | U | PDSE | FB | 80 | 10 | 5 |
| AHUHZFS | U | PDSE | VB | 8796 | 885 | 5 |
El resto de esta sección solo se aplica cuando la API RSE se descarga desde la web. No se aplica cuando lo ha solicitado a través de Shopz.
Seleccione este enlace para ir a la siguiente sección:
"FMID suprimidos"
Las siguientes figuras listan los conjuntos de datos que no son utilizados por la API RSE, pero que son necesarios como entrada para SMP/E.
Tabla 12. Requisitos de almacenamiento para los conjuntos de datos de descarga web de API RSE
| Conjunto de datos
Nombre | T
Y P E | O
R G | R
E C F M | L
R E C L | Núm.
de pistas 3390 | Núm.
de bloques DIR |
|---|---|---|---|---|---|---|
| hlq.IBM.HAMA100.F1 | U | PDSE | FB | 80 | 7 | N/A |
| hlq.IBM.HAMA100.F2 | U | PDSE | FB | 80 | 7 | N/A |
| hlq.IBM.HAMA100.F3 | U | PDSE | VB | 8796 | 727 | N/A |
| hlq.IBM.HAMA100.SMPMCS | U | SEQ | FB | 80 | 19 | N/A |
| Sistema de archivos z/OS UNIX | U | zFS | N/A | N/A | 1995 | N/A |
| Nota: estos son conjuntos de datos temporales, que se pueden eliminar después de la instalación de SMP/E. | ||||||
La instalación de la API RSE puede dar como resultado la supresión de otros FMID. Para ver los FMID que se van a suprimir, examine la sentencia ++VER en el SMPMCS del producto.
Si no desea suprimir estos FMID en este momento, instale la API de en zonas de distribución y de destino SMP/E separadas.
Nota: Estos FMID no se suprimen automáticamente de la zona global. Si desea suprimir estos FMIDs de la zona global, utilice el mandato SMP/E REJECT NOFMID DELETEFMID. Consulte el documento SMP/E Commands para conocer los detalles.
La API RSE no tiene consideraciones especiales para el sistema de destino.
Este capítulo describe el método de instalación y los procedimientos paso a paso para instalar y activar las funciones de la API RSE.
Tenga en cuenta lo siguiente:
Utilice los mandatos SMP/E RECEIVE, APPLY y ACCEPT para instalar este release de la API RSE.
Los valores recomendados para determinadas subentradas CSI de SMP/E aparecen en la Tabla
13. Utilizar valores inferiores a los valores recomendados puede dar como resultado errores en la instalación.
DSSPACE es una subentrada de la entrada de opciones GLOBAL. PEMAX es una subentrada de la entrada GENERAL en la entrada de opciones
GLOBAL. Consulte los manuales de SMP/E si desea instrucciones sobre cómo actualizar la zona global.
Tabla 13. Valores de subentrada de opciones de SMP/E
| Subentrada | Valor | Comentario |
|---|---|---|
| DSSPACE | (1200,1200,1400) | Asignación de espacio |
| PEMAX | Valor predeterminado de SMP/E | IBM recomienda utilizar el valor predeterminado de SMP/E para PEMAX. |
Los pasos siguientes son necesarios para instalar la API RSE (IBM Remote System Explorer):
Seleccione este enlace para omitir los pasos específicos de descarga web: "Trabajos de ejemplo"
Esta sección solo se aplica cuando la API RSE se descarga desde la web. No se aplica cuando se solicita a través de Shopz.
Seleccione este enlace para omitir los pasos específicos de descarga web:
"Trabajos de ejemplo"
Los conjuntos de datos de entrada de SMP/E para instalar IBM Remote System Explorer API (API RSE) se proporcionan como archivos comprimidos en HAMA100.pax.Z, que deben cargarse en z/OS como un archivo z/OS UNIX. Puede crear un nuevo sistema de archivos z/OS UNIX (zFS) o crear un directorio nuevo en un sistema de archivos existente para colocar HAMA100.pax.Z.
Puede utilizar el siguiente JCL de ejemplo para crear un nuevo sistema de archivos y directorio para el paquete de descarga.
//FILESYS JOB <información de trabajo>
//*
//* - Proporcionar información de tarjeta de trabajo válida
//* - Cambiar:
//* @zfs_path@
//* ----+----1----+----2----+----3----+----4----+----5
//* - Por la vía de acceso z/OS UNIX absoluta para el
//* paquete de descarga (empezando por /)
//* - La longitud máxima es de 50 caracteres
//* - No incluya una / al final
//* @zfs_dsn@
//* - Por el nombre de conjunto de datos del sistema de archivos
//*
//* El ID de usuario debe definirse como SUPERUSUARIO para
//* ejecutar correctamente este trabajo
//*
//CREATE EXEC PGM=IDCAMS,REGION=0M,COND=(0,LT)
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEFINE CLUSTER ( -
NAME(@zfs_dsn@) -
TRK(1995 10) -
LINEAR -
SHAREOPTIONS(3) -
)
//*
// SET ZFSDSN='@zfs_dsn@'
//FORMAT EXEC PGM=IOEAGFMT,REGION=0M,COND=(0,LT),
// PARM='-aggregate &ZFSDSN -compat'
//*STEPLIB DD DISP=SHR,DSN=IOE.SIOELMOD before z/OS 1.13
//*STEPLIB DD DISP=SHR,DSN=SYS1.SIEALNKE from z/OS 1.13
//SYSPRINT DD SYSOUT=*
//*
//MOUNT EXEC PGM=IKJEFT01,REGION=0M,COND=(0,LT)
//SYSEXEC DD DISP=SHR,DSN=SYS1.SBPXEXEC
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
PROFILE MSGID WTPMSG
oshell umask 0022; +
mkdir -p @zfs_path@
MOUNT +
FILESYSTEM('@zfs_dsn@') +
MOUNTPOINT('@zfs_path@') +
MODE(RDWR) TYPE(ZFS) PARM('AGGRGROW')
//*
Códigos de retorno y mensajes esperados: recibirá un código de retorno 0 si este trabajo se ejecuta correctamente.
Esta sección solo se aplica cuando la API RSE se descarga desde la web. No se aplica cuando se solicita a través de Shopz.
Seleccione este enlace para omitir los pasos específicos de descarga web:
"Trabajos de ejemplo"
Cargue el archivo HAMA100.readme.txt en formato de texto y el archivo HAMA100.pax.Z en formato binario desde la estación de trabajo al sistema de archivos z/OS UNIX.
En el diálogo de ejemplo siguiente, utilizamos FTP desde una línea de mandatos de Microsoft Windows para realizar la transferencia. Los mandatos y otra información indicada por el usuario aparecen en negrita y se dan por supuestos los valores siguientes:
Tabla 14. Valores indicados por el usuario
| Indicaciones del usuario: | Valores |
|---|---|
| mvsaddr | Dirección TCP/IP o nombre de host del sistema z/OS |
| tsouid | Su ID de usuario de TSO |
| tsopw | Su contraseña de TSO |
| d: | Ubicación de los archivos descargados |
| @zfs_path@ | Vía de acceso de z/OS UNIX donde almacenar los archivos. Esta coincide con la variable @zfs_path@ que ha especificado en el paso anterior. |
C:\>ftp mvsaddr Connected to mvsaddr. 220-FTPD1 IBM FTP CS %version% at mvsaddr, %time% on %date%. 220 Connection will close if idle for more than 5 minutes. User (mvsaddr:(none)): tsouid 331 Send password please. Password: tsopw 230 tsouid is logged on. Working directory is "tsouid.". ftp> cd @zfs_path@ 250 HFS directory @zfs_path@ is the current working directory ftp> ascii 200 Representation type is Ascii NonPrint ftp> put d:\HAMA100.readme.txt 200 Port request OK. 125 Storing data set @zfs_path@/HAMA100.readme.txt 250 Transfer completed successfully. ftp: 9316 bytes sent in 0.01 sec. (1366.67 Kb/s) ftp> binary 200 Representation type is Image ftp> put d:\HAMA100.pax.Z 200 Port request OK. 125 Storing data set @zfs_path@/HAMA100.pax.Z 250 Transfer completed successfully. ftp: 35739648 bytes sent in 1.26 sec. (1040.52 Kb/s) ftp> quit 221 Quit command received. Goodbye.
Esta sección solo se aplica cuando la API RSE se descarga desde la web. No se aplica cuando se solicita a través de Shopz.
Seleccione este enlace para omitir los pasos específicos de descarga web:
"Trabajos de ejemplo"
El archivo HAMA100.readme.txt cargado en el paso anterior contiene un JCL de ejemplo para expandir los SMPMCS y RELFILE comprimidos del archivo HAMA100.pax.Z cargado en los conjuntos de datos para su uso por el trabajo SMP/E RECEIVE. El JCL se repite aquí para su comodidad.
//EXTRACT JOB <información de trabajo>
//*
//* - Proporcionar información de tarjeta de trabajo válida
//* - Cambiar:
//* @PREFIX@
//* ----+----1----+----2----+
//* - Por el prefijo de nombre de conjunto de datos deseado
//* - La longitud máxima es de 25 caracteres
//* - Este valor se utiliza para los nombres de los
//* conjuntos de datos extraídos del paquete de descarga
//* @zfs_path@
//* ----+----1----+----2----+----3----+----4----+----5
//* - Por la vía de acceso z/OS UNIX absoluta para
//* el paquete de descarga (empezando por /)
//* - La longitud máxima es de 50 caracteres
//* - No incluya una / al final
//*
//UNPAX EXEC PGM=IKJEFT01,REGION=0M,COND=(0,LT)
//SYSEXEC DD DISP=SHR,DSN=SYS1.SBPXEXEC
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
oshell cd @zfs_path@/ ; +
pax -rvf HAMA100.pax.Z
//*
//GIMUNZIP EXEC PGM=GIMUNZIP,REGION=0M,COND=(0,LT)
//*STEPLIB DD DISP=SHR,DSN=SYS1.MIGLIB
//SYSUT3 DD UNIT=SYSALLDA,SPACE=(CYL,(50,10))
//SYSUT4 DD UNIT=SYSALLDA,SPACE=(CYL,(25,5))
//SMPOUT DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SMPDIR DD PATHDISP=KEEP,
// PATH='@zfs_path@/'
//SYSIN DD *
<GIMUNZIP>
<ARCHDEF archid="IBM.HAMA100.SMPMCS"
newname="@PREFIX@.IBM.HAMA100.SMPMCS"/>
<ARCHDEF archid="IBM.HAMA100.F1"
newname="@PREFIX@.IBM.HAMA100.F1"/>
<ARCHDEF archid="IBM.HAMA100.F2"
newname="@PREFIX@.IBM.HAMA100.F2"/>
<ARCHDEF archid="IBM.HAMA100.F3"
newname="@PREFIX@.IBM.HAMA100.F3"/>
</GIMUNZIP>
//*
Los siguientes trabajos de instalación de ejemplo se proporcionan como parte del producto para ayudarle a instalar la API RSE:
Tabla 15. Trabajos de instalación de ejemplo
| Nombre de trabajo | Tipo de trabajo | Descripción | Conjunto de datos SMPTLIB |
|---|---|---|---|
| HUH1SMPE | SMP/E | Trabajo de ejemplo para crear un entorno SMP/E (opcional) | IBM.HAMA100.F1 |
| HUH2RCVE | RECEIVE | Trabajo de ejemplo RECEIVE de SMP/E | IBM.HAMA100.F1 |
| HUH3ALOC | ALLOCATE | Trabajo de ejemplo para asignar bibliotecas de distribución y de destino | IBM.HAMA100.F1 |
| HUH4ZFS | ALLOMZFS | Trabajo de ejemplo para asignar, crear punto de montaje y montar conjuntos de datos zFS | IBM.HAMA100.F1 |
| HUH5MKD | MKDIR | Trabajo de ejemplo para invocar el HUHMKDIR EXEC proporcionado para asignar vías de acceso del sistema de archivos | IBM.HAMA100.F1 |
| HUH6DDEF | DDDEF | Trabajo de ejemplo para definir DDDEF de SMP/E | IBM.HAMA100.F1 |
| HUH7APLY | APPLY | Trabajo de ejemplo APPLY de SMP/E | IBM.HAMA100.F1 |
| HUH8ACPT | ACCEPT | Trabajo de ejemplo ACCEPT de SMP/E | IBM.HAMA100.F1 |
| Nota: Cuando la API RSE se descarga de la web, el nombre del conjunto de datos SMPTLIB irá precedido por el calificador de alto nivel elegido, tal como se describe en la sección "Extraer y expandir SMPMCS y RELFILE comprimidos". | |||
El resto de esta sección solo se aplica cuando la API RSE se solicita a través de
Shopz. No se aplica cuando se descarga de la web.
Seleccione este enlace para ir a la siguiente sección:
"Crear un entorno de SMP/E (opcional)"
Puede acceder a los trabajos de instalación de ejemplo realizando una acción RECEIVE de SMP/E (consulte la sección "Llevar a cabo la acción RECEIVE de SMP/E) y, a continuación, copiando los trabajos del conjunto de datos SMPTLIB en un conjunto de datos de trabajo para su edición y envío. Consulte la Tabla 15 para buscar el archivo de datos adecuado.
También puede copiar los trabajos de instalación de ejemplo de los archivos de cintas o productos sometiendo el siguiente trabajo. Antes de someter el trabajo, añada una tarjeta de trabajo y cambie los parámetros en minúsculas a valores en mayúsculas para satisfacer los requisitos de su sitio.
//STEP1 EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=* //IN DD DISP=SHR,UNIT=SYSALLDA, //* VOL=SER=filevol, // DSN=IBM.HAMA100.F1 //OUT DD DISP=(NEW,CATLG,DELETE),UNIT=SYSALLDA, // SPACE=(TRK,(5,5,5)), //* VOL=SER=dasdvol, // DSNAME=jcl-library-name //SYSUT3 DD UNIT=SYSALLDA,SPACE=(CYL,(1,1)) //SYSIN DD * COPY INDD=IN,OUTDD=OUT SELECT MEMBER=(HUHMKDIR,HUHMOUNT,HUH1SMPE,HUH2RCVE,HUH3ALOC) SELECT MEMBER=(HUH4ZFS,HUH5MKD,HUH6DDEF,HUH7APLY,HUH8ACPT) //*Consulte la información siguiente para actualizar las sentencias del ejemplo anterior:
Si está utilizando un CSI existente, no ejecute el trabajo de ejemplo HUH1SMPE.
Si decide crear un entorno de SMP/E nuevo para esta instalación, se proporciona un trabajo de ejemplo pero también puede elegir su propio JCL. Si elige utilizar el trabajo de ejemplo proporcionado, edite y someta HUH1SMPE. Consulte las instrucciones del trabajo de ejemplo para obtener más información.
Códigos de retorno y mensajes esperados: recibirá un código de retorno 0 si este trabajo se ejecuta correctamente.
Si ha obtenido la API RSE como parte de una CBPDO, utilice el trabajo RCVPDO en el conjunto de datos RIMLIB de CBPDO para recibir los FMID, los servicios y HOLDDATA de la API RSE que se incluyen en el paquete CBPDO. Para obtener más información, consulte la documentación que se incluye en CBPDO.
También puede elegir editar y someter un trabajo de ejemplo HUH2RCVE para realizar una acción RECEIVE de SMP/E para la API RSE. Consulte las instrucciones del trabajo de ejemplo para obtener más información.
Códigos de retorno y mensajes esperados: recibirá un código de retorno 0 si este trabajo se ejecuta correctamente.
Edite y someta el trabajo de ejemplo HUH3ALOC para asignar las bibliotecas de distribución y destino de SMP/E para la API RSE. Consulte las instrucciones del trabajo de ejemplo para obtener más información.
Códigos de retorno y mensajes esperados: recibirá un código de retorno 0 si este trabajo se ejecuta correctamente.
Este trabajo asigna, crea un punto de montaje y monta conjuntos de datos zFS.
Si tiene previsto instalar la API RSE en un nuevo sistema de archivos z/OS UNIX, puede editar y someter el trabajo HUH4ZFS opcional para realizar las siguientes tareas:
El tipo del sistema de archivos z/OS UNIX es zFS. El punto de montaje recomendado es /usr/lpp/IBM/rseapi.
Antes de ejecutar el trabajo de ejemplo para crear el sistema de archivos z/OS UNIX, debe asegurarse de que OMVS está activo en el sistema vehículo. zFS debe estar activo en el sistema vehículo si va a instalar la API RSE en un sistema de archivos que sea zFS.
Si crea un sistema de archivos nuevo para este producto, considere la posibilidad de actualizar el miembro BPXPRMxx PARMLIB para montar el sistema de archivos nuevo en tiempo de IPL. Esta acción puede ser útil si se realiza una IPL antes de haber completado la instalación.
MOUNT FILESYSTEM('#dsn')
MOUNTPOINT('/usr/lpp/IBM/rseapi')
MODE(RDWR) /* can be MODE(READ) */
TYPE(ZFS) PARM('AGGRGROW') /* zFS, con extensiones */
Consulte la información siguiente para actualizar las sentencias del ejemplo anterior:
Códigos de retorno y mensajes esperados: recibirá un código de retorno 0 si este trabajo se ejecuta correctamente.
El conjunto de datos HFS o zFS del sistema de destino debe montarse en el sistema vehículo al ejecutar el trabajo HUH5MKD de ejemplo puesto que el trabajo creará vías de acceso en HFS o zFS.
Antes de ejecutar el trabajo de ejemplo para crear las vías de acceso en el sistema de archivos, debe asegurarse de que OMVS está activo en el sistema vehículo y de que el sistema de archivos HFS o zFS del sistema de destino está montado en el sistema vehículo. zFS debe estar activo en el sistema vehículo si va a instalar la API RSE en un sistema de archivos que sea zFS.
Si tiene previsto instalar la API RSE en un sistema de archivos HFS o zFS nuevo, debe crear el punto de montaje y montar el nuevo sistema de archivos en el sistema vehículo para la API RSE.
El punto de montaje recomendado es /usr/lpp/IBM/rseapi.
Edite y someta el trabajo de ejemplo HUH5MKD para asignar las vías de acceso HFS o zFS para la API RSE. Consulte las instrucciones del trabajo de ejemplo para obtener más información.
Si crea un sistema de archivos nuevo para este producto, considere la posibilidad de actualizar el miembro BPXPRMxx PARMLIB para montar el sistema de archivos nuevo en tiempo de IPL. Esta acción puede ser útil si se realiza una IPL antes de haber completado la instalación.
Códigos de retorno y mensajes esperados: recibirá un código de retorno 0 si este trabajo se ejecuta correctamente.
Edite y someta el trabajo de ejemplo HUH6DDEF para crear entradas DDDEF para las bibliotecas de distribución y destino de SMP/E para la API RSE. Consulte las instrucciones del trabajo de ejemplo para obtener más información.
Códigos de retorno y mensajes esperados: recibirá un código de retorno 0 si este trabajo se ejecuta correctamente.
El último HOLDDATA está disponible a través de varios portales distintos, incluido http://service.software.ibm.com/holdata/390holddata.html. El último HOLDDATA puede identificar los APARs HIPER y FIXCAT para los FMIDs que instalará. APPLY CHECK ayudará a determinar si hay APARs HIPER o FIXCAT aplicables a los FMIDs que se instalan. Si hay APARs HIPER o FIXCAT aplicables, APPLY CHECK también identificará los PTFs de arreglo que resolverán los APARs, si es que hay un PTF de arreglo disponible.
Debe instalar los FMIDs independientemente del estado de los APARs HIPER o FIXCAT no resueltos. Sin embargo, no despliegue el software hasta que los APARs HIPER y FIXCAT no resueltos se hayan analizado para determinar su aplicabilidad. Es decir, antes de desplegar el software, asegúrese de que los PTFs de arreglo se aplican para resolver todos los APARs HIPER o FIXCAT o de que los problemas reportados por todos los APARs HIPER o FIXCAT no son aplicables a su entorno.
Para sacar el máximo partido del informe de resumen de SYSMOD de Causer SMP/E, no omita PRE, ID, REQ, e IFREQ en APPLY CHECK. El análisis de causas raíz de SMP/E solo identifica la causa de los errores y no de los avisos (SMP/E trata las condiciones PRE, ID, REQ y IFREQ omitidas como avisos en lugar de como errores).
A continuación se proporcionan algunos mandatos APPLY de ejemplo:
APPLY S(fmid,fmid,...) CHECK FORFMID(fmid,fmid,...) SOURCEID(RSU*) FIXCAT(IBM.PRODUCTINSTALL-REQUIREDSERVICE) GROUPEXTEND .
Es posible que algunos APARs HIPER no tenga todavía PTFs de arreglo disponibles. Debe analizar los distintivos de síntoma de los APARs HIPER no resueltos para determinar si el problema reportado es aplicable a su entorno y si debe omitir los ERROR HOLDs específicos para continuar con la instalación de los FMIDs.
Este método requiere más investigación inicial pero puede proporcionar una resolución para todos los HIPER que tengan PTFs de arreglo disponibles y que no se encuentren en la cadena de un PE. Es posible que queden PEs o HIPERs no resueltos que requieran el uso de BYPASS.
APPLY S(fmid,fmid,...) CHECK FORFMID(fmid,fmid,...) SOURCEID(RSU*) FIXCAT(IBM.PRODUCTINSTALL-REQUIREDSERVICE) GROUPEXTEND BYPASS(HOLDCLASS(HIPER)) . ..cualquier otro parámetro documentado en el directorio de programas
Este método es más rápido, pero requiere la revisión posterior del informe SYSMOD de excepciones generado por el mandato REPORT ERRSYSMODS para investigar los HIPERs no resueltos. Si ha recibido el último HOLDDATA, también puede optar por utilizar el mandato REPORT MISSINGFIX y especificar la categoría de arreglo IBM.PRODUCTINSTALL-REQUIREDSERVICE para investigar el servicio recomendado que falta.
Si omite HOLDs durante la instalación de los FMIDs porque los PTFs de arreglo todavía no están disponibles, puede recibir aviso de la disponibilidad de los PTF de arreglo mediante la función de seguimiento de estado (AST) de APAR de ServiceLink o la función de seguimiento de APAR de ResourceLink.
Nota: el operando GROUPEXTEND indica que SMP/E aplica todos los SYSMOD de requisito. Los SYSMOD de requisito podrían aplicarse también a otras funciones.
Códigos de retorno y mensajes esperados de APPLY CHECK: recibirá un código de retorno 0 si este trabajo se ejecuta correctamente.
Códigos de retorno y mensajes esperados de APPLY: recibirá un código de retorno 0 si este trabajo se ejecuta correctamente.
Edite y someta el trabajo de ejemplo HUH8ACPT para realizar una comprobación ACCEPT de SMP/E para la API RSE. Consulte las instrucciones del trabajo de ejemplo para obtener más información.
Para sacar el máximo partido del informe de resumen de SYSMOD de Causer SMP/E, no omita PRE, ID, REQ, e IFREQ en ACCEPT CHECK. El análisis de causas raíz de SMP/E solo identifica la causa de los errores pero no de los avisos (SMP/E trata las condiciones PRE, ID, REQ y IFREQ omitidas como avisos en lugar de como errores).
Antes de utilizar SMP/E para cargar las bibliotecas de distribución nuevas, se recomienda establecer el indicador ACCJCLIN en la zona de distribución. De esta forma, puede guardar las entradas generadas por JCLIN en la zona de distribución siempre que se acepte un SYSMOD que contenga JCLIN en línea. Para obtener más información sobre el indicador ACCJCLIN, consulte la descripción del JCLIN en línea en el documento SMP/E Commands.
Una vez realizadas las acciones oportunas indicadas por ACCEPT CHECK, elimine el operando CHECK y ejecute nuevamente el trabajo para ejecutar la acción ACCEPT.
Nota: el operando GROUPEXTEND indica que SMP/E acepta todos los SYSMOD de requisito. Los SYSMOD de requisito podrían aplicarse también a otras funciones.
Códigos de retorno y mensajes esperados de ACCEPT CHECK: recibirá un código de retorno 0 si este trabajo se ejecuta correctamente.
Si se aceptan los PTF que contienen módulos de sustitución, el proceso ACCEPT de SMP/E editará enlaces o enlazará los módulos en las bibliotecas de distribución. Durante este proceso, el editor de enlaces o enlazadores pueden emitir mensajes que documenten referencias externas no resueltas, provocadas por un código de retorno 4 durante la fase ACCEPT. Puede hacer caso omiso de estos mensajes, puesto que las bibliotecas de distribución no se pueden ejecutar y las referencias externas no resueltas no afectan a las bibliotecas del sistema ejecutable.
Códigos de retorno y mensajes esperados de ACCEPT: recibirá un código de retorno 0 si este trabajo se ejecuta correctamente.
El mandato REPORT CROSSZONE de SMP/E identifica los requisitos para productos que se hayan instalado en zonas independientes. Este mandato también crea mandatos APPLY y ACCEPT en el conjunto de datos SMPPUNCH. Puede utilizar los mandatos APPLY y ACCEPT para instalar esos requisitos entre zonas a los que identifica el mandato REPORT CROSSZONE de SMP/E.
Después de instalar la API de RSE, se recomienda ejecutar REPORT CROSSZONE en las zonas de destino y de distribución nuevas o actualizadas. REPORT CROSSZONE necesita una zona global con entradas ZONEINDEX que describan todas las bibliotecas de distribución y de destino sobre las que se debe informar.
Para obtener más información sobre REPORT CROSSZONE, consulte las publicaciones de SMP/E.
Los conjuntos de datos de descarga web listados en la Tabla 12 (sección "Requisitos de almacenamiento DASD") son conjuntos de datos temporales. Puede suprimir estos conjuntos de datos después de completar la instalación de SMP/E.
Si monta el sistema de archivos en el que ha instalado la API RSE en modalidad de solo lectura durante la ejecución, no tendrá que realizar más acciones para activar la API RSE.
La publicación IBM Remote System Explorer API (RSE API) Host Configuration Guide (SC27-9905-00) contiene la información necesaria para personalizar y utilizar la API RSE.
Esta información se ha desarrollado para productos y servicios ofrecidos en los Estados Unidos de América. Es posible que IBM no ofrezca los productos, servicios o funciones que se tratan en esta publicación en otros países. Consulte al representante local de IBM para obtener información sobre los productos y servicios disponibles actualmente en su área. Cualquier referencia a un producto, programa o servicio de IBM no pretende implicar que únicamente se pueda utilizar el producto, programa o servicio de IBM. En su lugar, se puede utilizar cualquier producto, programa o servicio funcionalmente equivalente que no infrinja ninguno de los derechos de propiedad intelectual de IBM. No obstante, es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM.
Los números de APAR se proporcionan en este documento como ayuda para localizar los PTF que pueden ser necesarios. Pueden derivarse informes de problemas en curso de los APAR que se estén creando. Por tanto, la lista de APAR de este documento podría no ser completa. Para conseguir las recomendaciones de servicio actuales e identificar los requisitos de servicio del producto actual, póngase en contacto siempre con el centro de soporte al cliente de IBM o utilice S/390 SoftwareXcel para obtener los grupos de PSP ("PSP Bucket") actuales.
IBM puede tener patentes o solicitudes de patente pendientes de aprobación que cubran alguno de los temas tratados en este documento. La posesión de este documento no le otorga ninguna licencia sobre dichas patentes. Puede enviar consultas sobre licencias por escrito a:
IBM Director of LicensingPara consultas sobre licencias relativas a la información de doble byte (DBCS), póngase en contacto con el departamento de propiedad intelectual de IBM en su país o envíe las consultas, por escrito, a:
Intellectual Property LicensingIBM, el logotipo de IBM e ibm.com son marcas comerciales o marcas registradas de International Business Machines Corp., en muchos países del mundo. Otros nombres de productos y servicios pueden ser marcas registradas de IBM o de otras empresas. Encontrará la lista actual de las marcas comerciales de IBM en el sitio web "Copyright and trademark information" en la dirección www.ibm.com/legal/copytrade.shtml.
Directorio de programas para la API IBM Remote System Explorer (API RSE), junio de 2020
Agradecemos sus comentarios sobre esta publicación. No dude en comentar la claridad, exactitud e integridad de la información o realizar cualesquiera otros comentarios que desee.
Envíe sus comentarios por correo electrónico a ibmkc@us.ibm.com e incluya la siguiente información:
Cuando envía información a IBM, otorga a IBM un derecho no exclusivo a utilizar o distribuir la información del modo que IBM considere oportuno sin incurrir por ello en ninguna obligación para con usted.
IBM o cualesquiera otras organizaciones solo utilizarán la información que proporcione para ponerse en contacto con usted sobre los problemas que envíe.
Gracias por su participación.