[AIX Solaris HP-UX Linux Windows][z/OS]

Intelligent Management: tareas administrativas de preferencias de usuario de las operaciones de tiempo de ejecución

Puede utilizar los lenguajes de script Jacl y Jython para clonar, establecer y obtener preferencias con la herramienta wsadmin. Utilice los mandatos y parámetros del grupo UserPreferences.

Las preferencias de usuario se almacenan en el contexto de célula o en contexto para cada tipo de recurso. La lista siguiente incluye ejemplos sobre el nivel de célula y cada nivel de recurso:
  • cells/myCell/preferences/User_1/preferenceset.xml
  • cells/myCell/applications/TestAppA.ear/preferences/User_1/preferenceset.xml
  • cells/myCell/nodes/myNode/servers/myServer/preferences/User_1/preferenceset.xml
  • cells/myCell/clusters/myCluster/preferences/User_1/preferenceset.xml
  • cells/myCell/serviceclasses/Platinum/preferences/User_1/preferenceset.xml
Utilice los mandatos siguientes para trabajar con las preferencias de las operaciones de tiempo de ejecución:

Para obtener ejemplos sobre cómo utilizar Jython para interactuar con objetos de preferencias, consulte Mandatos de objeto de preferencias Jython.

clonePreference

El mandato clonePreference copia una preferencia de un usuario o rol en otro usuario o rol.

Objeto de destino

configID del padre.

Parámetros necesarios

-name Especifica el nombre de la preferencia que se va a clonar. (String, necesario)

Parámetros opcionales

  • -scope: especifica el ámbito de la preferencia para guardar cuando se clonan las preferencias. Si no especifica un ámbito, se utiliza el ámbito del configID. (Serie, opcional) El ámbito se puede adoptar uno de los valores siguientes:
    • Applications
    • Servers
    • Clusters
    • ServiceClasses
  • -touser: especifica el usuario para el cual recuperar preferencias. Si no indica este valor, el valor por omisión utiliza el ID de usuario para la sesión en la que se ejecuta el mandato. (String, opcional)
  • -torole: especifica el rol para el cual recuperar las preferencias. Este valor se ignora si ha especificado el parámetro -touser. (String, opcional)
  • -fromuser: especifica el usuario que obtiene una copia de las preferencias. Puede indicar varios usuarios colocando los usuarios en una lista, por ejemplo: user1,user2,user3. No incluya espacios en la lista. (String, opcional)
  • -fromrole: especifica el rol que obtiene una copia de las preferencias. (String, opcional)

Ejemplo de utilización de la modalidad por lotes

  • Utilizando Jython:
    cellid= AdminConfig.getid("/Cell:myCell")
    AdminTask.clonePreference(cellid, '[-name ChartGroups -fromuser user1 -touser user2,user3,user4,user5]')
    AdminConfig.save()
  • Utilización de Jacl:
    $AdminTask clonePreference cells/dabtcCell02|cell.xml#Cell_1 {-name ChartGroups -fromuser user1 
    	-touser user2,user3,user4,user5}

Ejemplo de utilización de la modalidad interactiva

  • En Jython:
    AdminTask.clonePreference('[-interactive]')
  • Utilización de Jacl:
    $AdminTask clonePreference {-interactive}

getPreferences

El mandato getPreferences devuelve una colección de preferencias basándose en el documento de preferencias que ha especificado pasando un nombre de usuario o rol. Debe tener privilegios de administrador para obtener preferencias para un determinado usuario o rol de usuario.

Objeto de destino

configID del padre.

Parámetros necesarios

  • -name: especifica el nombre de la preferencia. (Serie, necesario)

Parámetros opcionales

  • -scope: especifica un ámbito para las preferencias. Puede elegir uno de los siguientes valores válidos:
    • Applications
    • Servers
    • Clusters
    • ServiceClasses
    El ámbito por omisión está vacío o no se ha definido. Si el ámbito está vacío, el ámbito se obtiene de donde se está leyendo el documento. Por ejemplo, si el documento está en el ámbito de célula, el ámbito se obtiene de la célula. Si el documento está en un contexto de servidor específico, el ámbito se supone que se puede aplicar a dicho servidor. (String, opcional)
  • -user: especifica el nombre de usuario para el cual recuperar preferencias. Si no indica un usuario, la acción por omisión es utilizar el nombre de usuario que ejecuta el script. (String, opcional)
  • -role: especifica el rol de usuario para el cual recuperar preferencias. (String, opcional)

Valor de retorno

El mandato devuelve un objeto DescriptivePropertyGroup que contiene las preferencias, o null si no se encuentra ninguna preferencia.

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    cellid= AdminConfig.getid("/Cell:myCell")
    AdminTask.getPreferences(cellid, '[-name ChartGroups -user user1]')
  • Utilización de Jacl:
    $AdminTask getPreferences cells/dabtcCell02|cell.xml#Cell_1 {-name Reports -user user1}

Ejemplo de utilización de la modalidad interactiva

  • Utilizando serie de Jython:
    AdminTask.getPreferences('[-interactive]')
  • Utilización de Jacl:
    $AdminTask getPreferences {-interactive}

setPreference

El mandato setPreference establece una preferencia específica en un documento de preferencias. Debe tener privilegios de administrador para establecer preferencias para un determinado usuario o rol de usuario.

Objeto de destino

configID del padre.

Parámetros necesarios

  • -name: especifica el nombre de la preferencia. (Serie, necesario)
  • -propertyLongName: especifica la vía de acceso completa a la propiedad en el grupo de propiedades, delimitado por un carácter de barra inclinada (/). Si la propiedad está contenida directamente en el grupo de propiedades raíz, puede utilizarse el nombre abreviado de la propiedad porque será exactamente igual al nombre largo. (String, necesario)
  • -propertyValue: especifica el nuevo valor para definir para la preferencia. (String, necesario)

Parámetros opcionales

  • -scope: especifica el ámbito de la preferencia para guardar cuando se clonan las preferencias. Si no especifica un ámbito, se utiliza el ámbito del configID. (Serie, opcional) El ámbito se puede adoptar uno de los valores siguientes:
    • Applications
    • Servers
    • Clusters
    • ServiceClasses
  • -user: especifica el nombre de usuario para el cual guardar preferencias. Si no indica un usuario, la acción por omisión es utilizar el nombre de usuario que ejecuta el script. (String, opcional)
  • -role: especifica el rol de usuario para el cual guardar preferencias. (String, opcional)

Ejemplo de utilización de la modalidad por lotes

  • Utilizando serie de Jython:
    AdminTask.setPreference(cellid, '[-name myChartGroup -propertyLongName defaultChartSize -propertyValue large]')
  • Utilizando Jacl:
    $AdminTask setPreference cells/dabtcCell02|cell.xml#Cell_1 {-name Reports -user user1 -propertyLongName defaultChartSize -propertyValue large}

Ejemplo de utilización de la modalidad interactiva

  • Utilizando serie de Jython:
    AdminTask.setPreference('[-interactive]')
  • Utilización de Jacl:
    $AdminTask setPreference {-interactive}

Mandatos de objeto de preferencias Jython

Utilice los siguientes ejemplos para interactuar con el objeto de preferencias con mandatos Jython:

Para listar las preferencias por usuario.

prefSets = AdminConfig.list("PreferenceSet")
print prefSets

Para eliminar las preferencias de un usuario.

prefid = AdminConfig.getid("/PreferenceSet:User_1")
AdminConfig.remove(prefid)
AdminConfig.save()

Para listar las preferencias de todos los usuarios, agrupadas por usuario.

prefs = AdminConfig.list("Preferences")
print prefs

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwve_xadmuserprefs
File name: rwve_xadmuserprefs.html