IBM Workload Automation, Versión 9.3

modify

Modifica o añade objetos de planificación. Si se modifican objetos, el mandato modify sólo extrae los objetos que el usuario actual puede bloquear.

Autorización

Debe tener acceso add si añade un objeto de planificación nuevo. Si el objeto ya existe en la base de datos, debe tener acceso modify al objeto, de lo contrario, composer no puede encontrar los objetos.

Sintaxis

{modify | m}
{[calendars | calendar | cal=nombre_calendario] |
[eventrule | erule | er=nombre_regla_sucesos] |
[parms | parm | vb=[nombretabla.]nombrevariable] |
[vartable | vt=nombretabla] |
[prompts | prom=nombre_solicitud] |
[resources | resource | res=[nombre_estación_trabajo#]
nombre_recurso] |
[runcyclegroup | rcg=nombre_grupo_ciclos_ejecución] |
[cpu={nombre_estación_trabajo | nombre_clase_estación_trabajo
| nombre_dominio}]
[workstation | ws=nombre_estación_trabajo] |
[workstationclass | wscl=nombre_clase_estación_trabajo] |
[domain | dom=nombre_dominio] |
[jobs | jobdefinition | jd=[nombre_estación_trabajo#]
nombre_trabajo] |
[sched|jobstream|js= [nombre_estación_trabajo#]
nombre_secuencia_trabajos
[valid from fecha|valid to fecha |valid in fecha fecha]
[;full]] |
[users | user=[nombre_estación_trabajo#]nombre_usuario]}

Argumentos

calendars | calendar | cal

Si no le sigue ningún argumento, modifica todas las definiciones de calendario.

Si le sigue el argumento calname, modifica el calendario nombre_calendario. Se permiten caracteres comodín.

eventrule | erule | er

Si no le sigue ningún argumento, modifica todas las definiciones de reglas de sucesos.

Si le sigue el argumento nombre_regla_sucesos, modifica la regla de sucesos nombre_regla_sucesos. Se permiten caracteres comodín.

parms|parm|vb

Si no le sigue ningún argumento, modifica todas las definiciones de variables globales de la tabla de variables predeterminadas.

Si le sigue el argumento nombretabla.nombrevariable, modifica la variable especificada de la tabla nombretabla. Si se omite nombretabla, composer busca la definición de la variable nombrevariable en la tabla de variables predeterminada. Se pueden utilizar caracteres comodín en nombretabla y en nombrevariable. Por ejemplo:

modify parms=@.@

Modifica todas las variables de todas las tablas.

modify parms=@

Modifica todas las variables de la tabla predeterminada.

modify parms=@.acct@

Modifica todas las variables cuyo nombre comienza por acct de todas las tablas existentes.

Recuerde: La acción de modificar o añadir una variable bloquea la tabla de variables que la contiene. Esto implica que, mientras la tabla está bloqueada, ningún otro usuario puede ejecutar ningún otro mandato de bloqueo en la misma o en las variables que contiene.

vartable | vt

Si no le sigue ningún argumento, modifica todas las definiciones de la tabla de variables.

Si le sigue el argumento de la tabla de variables nombretabla, modifica la tabla de variables nombretabla. Se permiten caracteres comodín.

prompts | prom

Si no le sigue ningún argumento, modifica todas las definiciones de solicitudes.

Si le sigue el argumento nombre_solicitud, modifica la solicitud nombre_solicitud. Se permiten caracteres comodín.

resources | resource | res

Si no le sigue ningún argumento, modifica todas las definiciones de recursos.

Si le sigue el argumento nombre_estación_trabajo#nombre_recurso, modifica el recurso nombre_recurso de la estación de trabajo nombre_estación_trabajo en la que se ha definido el recurso. Si se omite nombre_estación_trabajo, el valor predeterminado es la estación de trabajo en la que se ejecuta composer. Se permiten caracteres comodín para nombre_estación_trabajo y nombre_recurso.

runcyclegroup | rcg

Si no le sigue ningún argumento, modifica todas las definiciones del grupo de ciclos de ejecución.

Si le sigue el argumento nombre_grupo_ciclos_ejecución, modifica el grupo de ciclos de ejecución nombre_grupo_ciclos_ejecución. Se permiten caracteres comodín.

cpu

Modifica estaciones de trabajo, clases de estación de trabajo o dominios.

estación_trabajo: Nombre de la estación de trabajo. Se permiten caracteres comodín.
workstationclass: Nombre de la clase de estación de trabajo. Se permiten caracteres comodín.
dominio: El nombre del dominio. Se permiten caracteres comodín.

workstation | ws

Si no le sigue ningún argumento, modifica todas las definiciones de estaciones de trabajo.

Si le sigue el argumento nombre_estación_trabajo, modifica la estación de trabajo nombre_estación_trabajo. Se permiten caracteres comodín.

domain | dom

Si no le sigue ningún argumento, modifica todas las definiciones de dominios.

Si le sigue el argumento nombre_dominio, modifica el dominio nombre_dominio. Se permiten caracteres comodín.

workstationclass | wscl

Si no le sigue ningún argumento, modifica todas las definiciones de clases de estaciones de trabajo.

Si le sigue el argumento nombre_clase_estación_trabajo, modifica la clase de estación de trabajo nombre_clase_estación_trabajo. Se permiten caracteres comodín.

jobs | jobdefinition | jd

Si no le sigue ningún argumento, modifica todas las definiciones de trabajos.

Si le sigue el argumento nombre_estación_trabajo#nombre_trabajo, modifica el trabajo nombre_trabajo de la estación de trabajo nombre_estación_trabajo en la que se ejecuta el trabajo. Si se omite nombre_estación_trabajo, el valor predeterminado es la estación de trabajo en la que se ejecuta composer. Se permiten caracteres comodín para nombre_estación_trabajo y nombre_trabajo.

sched | jobstream | js

Si no le sigue ningún argumento, modifica todas las definiciones de secuencias de trabajos.

Si le sigue el argumento nombre_estación_trabajo#nombre_secuencia_trabajos, modifica la secuencia de trabajos nombre_secuencia_trabajos de la estación de trabajo nombre_estación_trabajo en la que se ha definido la secuencia de trabajos. Si se omite nombre_estación_trabajo, el valor predeterminado es la estación de trabajo en la que se ejecuta composer. Se permiten caracteres comodín para nombre_estación_trabajo y nombre_secuencia_trabajos.

valid from: fecha Restringe la selección a las secuencias de trabajos que tienen una fecha de inicio de validez igual al valor indicado. El formato es mm⁄dd⁄aaaa.
valid to: fecha Restringe la selección a las secuencias de trabajos que tienen una fecha de fin de validez igual al valor indicado. El formato es mm⁄dd⁄aaaa.
valid in: fecha fecha El marco de tiempo durante el que se puede ejecutar la secuencia de trabajos. El formato es mm⁄dd⁄aaaa - mm⁄dd⁄aaaa. Una de las dos fechas se puede representar como @.
full: También modifica todas las definiciones de trabajo que contiene la secuencia de trabajos.

users | user

Si no le sigue ningún argumento, modifica todas las definiciones de usuarios.

Si le sigue el argumento nombre_estación_trabajo#nombre_usuario, modifica el usuario nombre_usuario de la estación de trabajo nombre_estación_trabajo en la que se ha definido el usuario. Si se omite nombre_estación_trabajo, el valor predeterminado es la estación de trabajo en la que se ejecuta composer. Se permiten caracteres comodín para nombre_estación_trabajo y nombre_usuario.

Comentarios

El mandato modify efectúa la siguiente secuencia de acciones:

Bloquea los objetos en la base de datos.
Copia la definición de los objetos en un archivo temporal.
Edita el archivo.
Sustituye la definición que contiene el archivo temporal en la base de datos.
Si el mandato modify ocurre en un subconjunto de los objetos seleccionados, composer pregunta: "¿Desea volver a editarlo?" y el archivo guardado antes se vuelve a abrir para su edición y se repiten los pasos sucesivos de la secuencia.
Desbloquea los objetos en la base de datos.

Las definiciones de las reglas de suceso se abren con un editor de XML (para obtener información sobre XML, consulte Definición de regla de suceso y El editor de Composer para obtener detalles sobre cómo configurar un editor de XML).

Si modifica con el mismo mandato modify dos o más objetos enlazados juntos por alguna relación, por ejemplo, un trabajo sucesor y su trabajo predecesor, el orden en el que se listen los objetos en el archivo temporal puede ser relevante para el resultado satisfactorio del mandato modify. Esto sucede porque el mandato modify lee secuencialmente los objetos que contiene el archivo temporal; o sea, si el objeto que referencia se muestra antes que el objeto al que se hace referencia, el mandato modify puede fallar en el objeto que referencia.

Por ejemplo, si el mandato:

modify FTA1#@PROVA

produce el siguiente archivo temporal:

SCHEDULE FTA1#PROVA VALIDFROM 08/31/2005
MATCHING SAMEDAY
:
FTA2#MY-JOB
 FOLLOWS FTA1#COPYOFPROVA.MY-JOB06
END

SCHEDULE FTA1#COPYOFPROVA VALIDFROM 08/31/2005
MATCHING SAMEDAY
:
FTA1#MY-JOBO6
END

y ha cambiado el nombre del trabajo predecesor de FTA1#MY-JOB06 a FTA1#MY-JOB05 en ambas secuencias de trabajos FTA1#PROVA y FTA1#COPYOFPROVA, entonces el mandato modify:

Primero intenta cambiar la definición de la secuencia de trabajos FTA1#PROVA y falla porque encuentra una dependencia de continuación de un trabajo FTA1#MY-JOB05 que aún es desconocido.
Luego intenta cambiar la definición de FTA1#COPYOFPROVA y lo consigue.

La próxima vez que ejecute modify para cambiar el trabajo predecesor de FTA1#MY-JOB06 a FTA1#MY-JOB05 en la secuencia de trabajos FTA1#PROVA, el mandato se ejecuta satisfactoriamente porque el trabajo predecesor FTA1#MY-JOB05 ahora existe en la base de datos.

Si la secuencia de trabajos FTA1#COPYOFPROVA se hubiese listado en el archivo temporal antes que FTA1#PROVA, el mandato modify se habría ejecutado satisfactoriamente la primera vez, ya que el nombre del trabajo se habría modificado antes de cambiar la definición de dependencia en el trabajo sucesor.

Para las definiciones de usuario, si el campo de contraseña mantiene el valor *******, al salir del editor, se retiene la contraseña anterior. Para especificar una contraseña nula utilice dos comillas dobles consecutivas comillas (").

El mandato modify comprueba si hay dependencias de bucle dentro de las secuencias de trabajos. Por ejemplo, si job1 va a continuación de job2 y job2 va a continuación de job1 hay una dependencia de bucle. Cuando se encuentra una dependencia de bucle dentro de una secuencia de trabajos, se muestra un error. El mandato modify no comprueba si hay dependencias de bucle entre secuencias de trabajos porque, según la complejidad de las actividades de planificación, esta comprobación puede costar demasiado tiempo y consumir demasiada CPU.

Ejemplos

Para modificar todos los calendarios, ejecute el mandato siguiente:

modify calendars=@

Para modificar la secuencia de trabajos sked9 que se inicia en la estación de trabajo site1, ejecute el siguiente mandato:

m sched=site1#sked9

Para modificar todas las reglas de suceso que incluyan una acción con el trabajo DPJOB10, ejecute:

mod er=@;filter job=DPJOB10

Véase también

En Dynamic Workload Console puede realizar las mismas tareas que se describe en:

Para ver, editar o suprimir estaciones de trabajo, consulte
Edición de definiciones de estación de trabajo.
Para ver, editar o suprimir reglas de suceso, consulte
Edición de reglas de suceso.
Para ver, editar o suprimir todos los demás objetos, consulte
Listar definiciones de objeto en la base de datos.