Crear una acción de menú con valores de alteración temporal predeterminados para parámetros identificados

Aprenda a utilizar el Gestor de menús para crear una acción de menú que proporcione valores para los parámetros que están identificados en el JCL.

Acerca de esta tarea

Utilice el Gestor de menús para crear acciones y especificar valores de alteración temporal predeterminados para parámetros.

Procedimiento

Para crear una acción y especificar valores de parámetros de alteración temporal:

En la ventana Preferencias, vaya a Gestor de menús > Acciones y menús.
Para crear un archivo de acción, haga clic en Nuevo.
Se abre la ventana Nuevo fichero.
Para indicar que las acciones del nuevo archivo se ejecuten contra archivos, haga clic en Archivo.
La opción Proyecto/subproyecto permite la creación de acciones que se ejecutan en proyectos y subproyectos.
Escriba un nombre de ruta de archivo para el archivo de acción, o para abrir la ubicación para almacenar el archivo, haga clic en Examinar y escriba un nombre de archivo para él.
Los archivos de acción se almacenan en formato XML, así que especifique un nombre de archivo con la extensión .xml, como c:\worklocation\myActions.xml. La vía de acceso del directorio que especifique debe existir.
Haga clic en Siguiente.
Se abre la página Crear contenido de archivo.
Haga clic en Crear una nueva acción local/remota y, a continuación, en Finalizar.
Se abre el Asistente de acción nueva del gestor de menús.
En el campo Nombre, escriba Define Program to CICS y, en el campo Comentario, escriba un comentario que describa la nueva acción.
El nombre que especifique es el nombre que aparece en el menú cuando seleccione el programa o archivo, pulse el botón derecho del ratón para ejecutar la acción.
En la lista Contexto, seleccione un contexto para la acción.
El contexto define las áreas del entorno de trabajo en las que la acción está disponible.
Al seleccionar Todos, por ejemplo, la acción está disponible en todos los contextos. Al seleccionar la opción « MVS » (Seleccionar todos los archivos) en la vista «Remote Systems» (Sistemas remotos), la acción solo estará disponible cuando seleccione un archivo « MVS » (Seleccionar todos los archivos) en la vista «Remote Systems» (Sistemas remotos) del banco de trabajo.
Haga clic en Siguiente.
Se abre la página de Asociaciones de Archivos.
Seleccione uno o varios tipos de archivo para asociarlos a esta acción y haga clic en Añadir.
Los tipos de archivo se añadirán a la lista Tipos de archivo elegidos.
Haga clic en Siguiente.
Se abrirá la página Filtros de conjunto de datos.
Haga clic en Siguiente.
Se abre la página Opciones de ejecución.
Escriba el mandato y los parámetros de la acción Submit. Separe las entradas mediante comas.
Debe escribir el mandato en una sola línea. Puede especificar los parámetros siguientes con el mandato Submit:
PROMPT | NOPROMPT
Utilice uno de estos parámetros, dependiendo de si una ventana debe solicitar alteraciones temporales para los parámetros predeterminados. PROMPT abre una ventana que permite la alteración temporal de algunos de los valores antes de que se someta JCL. Si especificó todos los valores necesarios y no necesita una solicitud, especifique NOPROMPT. Para las tareas repetitivas, donde los valores se repiten o se proporcionan en variables, puede ser preferible utilizar NOPROMPT. Para otras tareas en las que es necesaria la entrada de datos, puede ser preferible utilizar PROMPT.
El mandato siguiente solicita a los usuarios que escriban un valor.
Submit,ELISEE.TEST.JCL(PROGRDO),PROMPT,2,Variable,Value,Submit,Define program to CICS using batch RDO definition,PROGRAM,$name,USERID,$userid,GROUP,MYGROUP,LANGUAGE,COBOL
El mandato siguiente no solicita un valor a los usuarios:
```
Submit,ELISEE.TEST.JCL(PROGRDO),NOPROMPT,2, PROGRAM,$name,USERID,$userid,GROUP,MYGROUP,LANGUAGE,COBOL
```
SPECIFYCASE M | U
SPECIFYCASE se especifica después de la PROMPT | NOPROMPT palabra clave. Para cada valor de variable, especifique la opción M o U para indicar si el valor puede incluir mayúsculas y minúsculas o solo mayúsculas. El ejemplo siguiente define tres variables: websvdir, WSDLFILE, y CORRFILE. La variable websvdir se sustituye por un valor en mayúsculas. Las otras dos variables se sustituyen por valores en mayúsculas y minúsculas.
```
Submit,ELISEE.TEST.JCL(PROGRAM),PROMPT,SPECIFYCASE,2,Variable,Value,Submit,Define program,websvdir,$input(Web Service directory,testdir),U,WSDLFILE,$input(WSDL filename, wsdlfile),M,CORRFILE,$input(XML Correlator file name,Corrfile),M
```
Haga clic en Mostrar en el menú genérico.
Haga clic en Utilizar acción existente.
Haga clic en Seleccionar.
Se abre la ventana Selección de acción.
Expandir com.ibm.etools.varsubstitution.
Seleccione com.ibm.ftt.ui.menumanager.mfivarsubsaction y haga clic en Aceptar.
Para guardar la acción y cerrar el asistente, haga clic en Finalizar.
Para cerrar la ventana de Preferencias, pulse OK.

Valores de alteración temporal de parámetros

Son aplicables las consideraciones siguientes cuando especifica valores de alteración temporal de parámetros:

Si no especifica un valor para el parámetro PROGRAM, el recurso seleccionado es sobre el que se actúa como JCL a ejecutar. Por ejemplo, puede que tenga que enviar un JCL de inicio de CICS® que tenga ciertas opciones sin modificar el propio JCL. Usuarios diferentes pueden someter el mismo JCL, pero con valores de parámetros diferentes.
Si especifica un valor para el parámetro PROGRAM, es el JCL a ejecutar cuando se solicita la acción. El recurso, que se selecciona pulsando el botón derecho del ratón, se asocia entonces al JCL que se debe someter.
Si especifica un parámetro en el JCL, pero no especifica un valor de alteración temporal, el valor de ese parámetro se sustituye por una seria de caracteres vacía. Por ejemplo, considere la entrada siguiente contenida en un JCL:
```
MEMBER=!PROG!,PARM='1920'
```
Si no especifica un valor de anulación para la entrada !PROG!, entonces esa entrada se convierte en:
```
MEMBER=,PARM='1920'
```

Los siguientes valores de variables resultan de utilidad. Para ver todos los valores de variables disponibles, pulse Variables en la página Opciones de ejecución del asistente Acción nueva del Gestor de menús.

$name: Devuelve el nombre del recurso que está seleccionado cuando se muestra la opción de menú. Devuelve el nombre del miembro.
$fullname: Devuelve el nombre del recurso que está seleccionado cuando se muestra la opción de menú. Devuelve el nombre del conjunto de datos y el nombre del miembro en el formatoDATASET(MEMBER).
$datasetname: Devuelve el nombre del conjunto de datos donde reside el recurso de miembro que se selecciona pulsando sobre él con el botón derecho del ratón.