Referencia de comando > Cómo trabajar con archivos de pmrep > Cómo utilizar el archivo de control de implementación
  

Cómo utilizar el archivo de control de implementación

Un archivo de control de implementación es un archivo XML que se utiliza con los comandos DeployFolder y DeployDeploymentGroup pmrep para implementar una carpeta o el grupo de implementación. Puede crear un archivo de control de implementación manualmente para ofrecer parámetros de implementación, o bien puede crear un archivo de control de implementación mediante el asistente de copia.
Si crea el archivo de control de implementación manualmente, éste debe adaptarse al archivo depcntl.dtd que está instalado con el cliente de PowerCenter. Puede incluir la ubicación del archivo depcntl.dtd en el archivo de control de implementación.
Puede especificar un tiempo de espera de implementación en el archivo de control de implementación. El tiempo de espera de implementación es el período de tiempo que pmrep espera para adquirir bloqueos de objeto en el repositorio de destino. De forma predeterminada, pmrep espera de forma indefinida hasta que adquiere bloqueos o hasta que cancele la implementación. Para cancelar una implementación mientras pmrep está esperando para adquirir bloqueos, pulse Ctrl+C.
A continuación, se facilita una muestra del archivo depcntl.dtd:
<!ELEMENT DEPLOYPARAMS (DEPLOYFOLDER?, DEPLOYGROUP?)>
<!ATTLIST DEPLOYPARAMS
        DEFAULTSERVERNAME    CDATA      #IMPLIED
        COPYPROGRAMINFO      (YES | NO) "YES"
        COPYMAPVARPERVALS    (YES | NO) "NO"
        RETAINMAPVARPERVALS (YES | NO) "NO"
COPYWFLOWVARPERVALS  (YES | NO) "NO"
        COPYWFLOWSESSLOGS    (YES | NO) "NO"
        COPYDEPENDENCY       (YES | NO) "YES"
        LATESTVERSIONONLY    (YES | NO) "NO"
        CHECKIN_COMMENTS     CDATA      #IMPLIED
        DEPLOYTIMEOUT        CDATA      "-1"
        RETAINGENERATEDVAL   (YES | NO) "YES"
        RETAINSERVERNETVALS  (YES | NO) "YES">
        COPYDEPLOYMENTGROUP  (YES | NO) "NO">

<!--criteria specific to deploying folder-->
<!ELEMENT DEPLOYFOLDER (REPLACEFOLDER?, DEPLOYEDFOLDEROWNER?, OVERRIDEFOLDER*)>
<!ATTLIST DEPLOYFOLDER
        NEWFOLDERNAME         CDATA      #IMPLIED>

<!--folder to replace-->
<!ELEMENT REPLACEFOLDER EMPTY>
<!ATTLIST REPLACEFOLDER
        FOLDERNAME            CDATA      #REQUIRED
        RETAINMAPVARPERVALS   (YES | NO) "NO"
        RETAINWFLOWVARPERVALS (YES | NO) "YES"
        RETAINWFLOWSESSLOGS   (YES | NO) "NO"
        MODIFIEDMANUALLY      (YES | NO) "NO"
        RETAINORIGFOLDEROWNER (YES | NO) "NO">

<!--shared folder to override-->
<!ELEMENT OVERRIDEFOLDER EMPTY>
<!ATTLIST OVERRIDEFOLDER
        SOURCEFOLDERNAME    CDATA            #REQUIRED
        SOURCEFOLDERTYPE    (LOCAL | GLOBAL) "LOCAL"
        TARGETFOLDERNAME    CDATA            #REQUIRED
        TARGETFOLDERTYPE    (LOCAL | GLOBAL) "LOCAL"
        MODIFIEDMANUALLY    (YES | NO)     "NO"

<!--criteria specific to deploy deployment group-->
<!ELEMENT DEPLOYGROUP (REPLACEDG?, TARGETDGOWNER?, OVERRIDEFOLDER*, APPLYLABEL?)>
<!ATTLIST DEPLOYGROUP
        CLEARSRCDEPLOYGROUP (YES | NO) "NO">
        NEWDEPLOYGROUPNAME   CDATA  #IMPLIED

<!--labels used to apply on the src objects and deployed objects-->
<!ELEMENT APPLYLABEL EMPTY>
<!ATTLIST APPLYLABEL
        SOURCELABELNAME     CDATA            #IMPLIED
        SOURCEMOVELABEL    (YES | NO)          "NO"
        TARGETLABELNAME     CDATA            #IMPLIED
        TARGETMOVELABEL     (YES | NO)          "NO">

<!-- new owners of deployed folders -->
<!ELEMENT DEPLOYEDFOLDEROWNER EMPTY>
<!ATTLIST DEPLOYEDFOLDEROWNER
        USERNAME         CDATA        #IMPLIED
       SECURITYDOMAIN   CDATA     #IMPLIED
        GROUPNAME        CDATA #IMPLIED>

<!-- to indicate that a deployment group should be replaced-->
<!ELEMENT REPLACEDG EMPTY>
<!ATTLIST REPLACEDG
        DGNAME          CDATA        #REQUIRED
       SECURITYDOMAIN   CDATA     #IMPLIED

<!-- new owner of copied deployment group-->
<!ELEMENT TARGETDGOWNER EMPTY>
<!ATTLIST TARGETDGOWNER
        USERNAME         CDATA        #IMPLIED
       SECURITYDOMAIN   CDATA     #IMPLIED

Parámetros del archivo de control de implementación

La tabla siguiente describe los parámetros del archivo de control de implementación pmrep:
Elemento
Nombre de atributo
Descripción de atributo
DEPLOYPARAMS
(Utilizar con DeployFolder y DeployDeploymentGroup)
DEFAULTSERVERNAME
Opcional. Servicio de integración registrado en el repositorio de destino para ejecutar flujos de trabajo. Para cualquier implementación, puede especificar un nombre de servidor predeterminado.
-
COPYPROGRAMINFO
Opcional. Copia el programa ABAP instalado por SAP.
-
COPYMAPVARPERVALS
Opcional. Copia los valores persistentes de variable de asignación.
-
RETAINMAPVARPERVALS
Opcional. Conserva los valores persistentes de variable de asignación en el destino.
-
COPYWFLOWVARPERVALS
Opcional. Copia los valores persistentes de variable de flujo de trabajo.
-
COPYWFLOWSESSLOGS
Opcional. Copia los registros de flujo de trabajo.
-
COPYDEPENDENCY
Opcional. Copia la información de dependencia para objetos de asignaciones.
-
COPYDEPLOYMENTGROUP
Opcional. Copia el grupo de implementación junto con los objetos del grupo de implementación en el repositorio de destino.
-
VALIDATETARGETREPOSITORY
Opcional. Valida los objetos en el repositorio de destino.
-
LATESTVERSIONONLY
Opcional. Copia la última versión.
-
CHECKIN_COMMENTS
Opcional. Reemplaza el comentario predeterminado y añade un comentario en el repositorio de destino cuando se copia o implementa un objeto. Debe establecer LATESTVERSIONONLY en true para utilizar este atributo.
-
DEPLOYTIMEOUT
Opcional. Período de tiempo (en segundos) durante el cual pmrep intenta adquirir bloqueos en objetos del repositorio de destino. Un valor igual a 0 provoca inmediatamente un error en la operación de copia si pmrep no puede obtener un bloqueo. Un valor de -1 ordena a pmrep que espere indefinidamente hasta que adquiera bloqueos o el usuario cancele la operación. El valor predeterminado es -1.
-
RETAINGENERATEDVAL
Opcional. Mantiene el valor actual para el generador de secuencia o las transformaciones del normalizador.
-
RETAINSERVERNETVALS
Opcional. Conserva los valores relacionados con el servidor y la red en las tareas.
DEPLOYFOLDER
(Utilícelo con DeployFolder)
NEWFOLDERNAME
Opcional. Crea una carpeta con ese nombre.
REPLACEFOLDER
(Utilícelo con DeployFolder)
FOLDERNAME
Obligatorio. Establece un nombre para la carpeta después de reemplazarla.
-
RETAINMAPVARPERVALS
Opcional. Conserva los valores persistentes de variable de asignación en el destino.
-
RETAINWFLOWVARPERVALS
Opcional. Conserva los valores persistentes de variable de flujo de trabajo.
-
RETAINWFLOWSESSLOGS
Opcional. Conserva los registros de la sesión de flujo de trabajo en el destino.
-
MODIFIEDMANUALLY
Opcional. Compara carpetas si se han creado o modificado objetos en la carpeta de destino desde la implementación anterior.
-
RETAINORIGFOLDEROWNER
Opcional. Conserva el propietario de carpeta existente. pmrep omite toda información proporcionada en el elemento DEPLOYEDFOLDEROWNER.
OVERRIDEFOLDER
(Utilizar con DeployFolder y DeployDeploymentGroup)
SOURCEFOLDERNAME
Obligatorio. Si se está implementando una carpeta, especifica la carpeta actual a la que apuntan los accesos directos.
Si se está implementando un grupo de implementación, especifica las carpetas siguientes:
  • - Carpeta o carpetas a las que apuntan los accesos directos
  • - Carpeta o carpetas donde se encuentran los objetos del grupo de implementación
-
SOURCEFOLDERTYPE
Opcional. Si se está implementando una carpeta, especifica el tipo de carpeta a la que apuntan los accesos directos. Utilice accesos directos locales o globales.
-
TARGETFOLDERNAME
Obligatorio. Si se está implementando una carpeta, especifica la carpeta a la que apuntan los accesos directos.
Si se está implementando un grupo de implementación, especifica las carpetas siguientes:
  • - Carpeta o carpetas a las que apuntan los accesos directos
  • - Carpeta o carpetas donde se encuentran los objetos del grupo de implementación
-
TARGETFOLDERTYPE
Opcional. Si se está implementando una carpeta, especifica el tipo de carpeta a la que apuntan los accesos directos. Utilice accesos directos locales o globales.
-
MODIFIEDMANUALLY
Opcional. Compara carpetas si se han creado o modificado objetos en la carpeta de destino desde la implementación anterior. Utilice este atributo únicamente con el comando DeployDeploymentGroup.
DEPLOYGROUP
(Utilícelo con DeployDeploymentGroup)
CLEARSRCDEPLOYGROUP
Opcional. Elimina los objetos del grupo de origen después de la implementación.
-
NEWDEPLOYGROUPNAME
Opcional. Crea un grupo de implementación con este nombre. Se omite si se ha especificado REPLACEDG. El valor predeterminado es el nombre del grupo de implementación de origen.
REPLACEDG
DGNAME
Opcional. Nombre del grupo de implementación que se reemplazará.
-
RETAINORIGINALOWNER
Opcional. Especifica si se debe conservar el propietario del grupo de implementación que se está reemplazando en el repositorio de destino.
TARGETDGOWNER
USERNAME
Opcional. Propietario del grupo de implementación copiado. El valor predeterminado es el propietario del grupo de implementación de origen.
-
SECURITYDOMAIN
Opcional. Dominio de seguridad del grupo de implementación de destino.
APPLYLABEL
(Utilícelo con DeployDeploymentGroup)
SOURCELABELNAME
Opcional. Aplica una etiqueta a todos los objetos del grupo de origen.
-
SOURCEMOVELABEL
Opcional. Mueve la etiqueta desde una versión diferente del objeto del grupo de origen a la versión del grupo de implementación del objeto. Si el agente de repositorio detecta que la etiqueta está aplicada a otra versión del mismo objeto, puede seleccionar mover la etiqueta a la versión seleccionada del objeto.
-
TARGETLABELNAME
Opcional. Aplica una etiqueta a todos los objetos implementados en el repositorio de destino.
-
TARGETMOVELABEL
Opcional. Mueve la etiqueta desde una versión diferente del objeto del grupo de destino a la versión del grupo de implementación del objeto. Si el agente de repositorio detecta que la etiqueta está aplicada a otra versión del mismo objeto, puede seleccionar mover la etiqueta a la versión más reciente del objeto.
DEPLOYEDFOLDEROWNER
(Utilizar con DeployFolder y DeployDeploymentGroup)
USERNAME
Opcional. Propietario de la carpeta o grupo de implementación implementados en el repositorio de destino.
-
SECURITYDOMAIN
Opcional. Nombre del dominio de seguridad al que pertenece el propietario de la carpeta o grupo de implementación implementado.
-
GROUPNAME
Opcional. Grupo propietario de la carpeta o grupo de implementación implementado en el repositorio de destino.