Cómo utilizar pmrep
pmrep es un programa de línea de comandos que se utiliza para actualizar información sobre el repositorio, así como para aplicar funciones del repositorio. pmrep está instalado en los directorios bin de los servicios y el cliente de PowerCenter.
Utilice pmrep para realizar tareas de administración del repositorio, tales como enumerar objetos de repositorio, crear y editar grupos, restablecer y eliminar repositorios y actualizar parámetros relacionados con la sesión e información de seguridad del repositorio de PowerCenter.
Al utilizar pmrep, puede introducir comandos en los siguientes modos:
- •Modo de línea de comandos. Puede emitir comandos pmrep directamente desde la línea de comandos del sistema. Utilice el modo de línea de comandos para escribir comandos pmrep.
- •Modo interactivo. Puede emitir comandos pmrep a partir de una solicitud interactiva. pmrep no se cierra tras completar un comando.
Puede utilizar las variables de entorno para definir los nombres de usuario y las contraseñas para pmrep. Antes de utilizar pmrep, configure estas variables. Las variables de entorno se aplican a los comandos pmrep que se ejecutan en el nodo.
Todos los comandos pmrep requieren de una conexión con el repositorio, excepto los comandos siguientes:
Utilice el comando pmrep Connect para conectarse con el repositorio antes de utilizar otros comandos pmrep.
Ejecución de comandos en modo de línea de comandos
El modo de línea de comandos llama y sale de pmrep cada vez que emite un comando. El modo de línea de comandos es útil si desea ejecutar comandos de pmrep mediante archivos por lote, scripts u otros programas.
Para ejecutar comandos de pmrep en el modo de línea de comandos:
1. En la línea de comando, cambie al directorio en el que está ubicado el ejecutable de pmrep.
2. Escriba pmrep seguido por el nombre del comando y sus opciones y argumentos:
pmrep command_name [-option1] argument_1 [-option2] argument_2...
Ejecución de comandos en modo interactivo
El modo interactivo llama a pmrep. Puede emitir una serie de comandos desde una línea de comando pmrep sin salir después de cada comando.
Para ejecutar los comandos de pmrep en modo interactivo:
1. En la línea de comando, escriba pmreppara llamar al modo interactivo.
Esto inicia pmrep en modo interactivo y muestra la línea de comando pmrep>. En el modo interactivo, no es necesario escribir pmrep delante de cada comando.
2. Escriba un comando y sus opciones y argumentos.
En la línea de comando, escriba:
command_name [-option1] argument_1 [-option2] argument_2...
pmrep ejecuta el comando y muestra la línea de comando otra vez.
3. Escriba exit para finalizar una sesión interactiva.
Ejecución de comandos en modo normal y modo exclusivo
El servicio de repositorio se ejecuta en modo normal o exclusivo. Ejecute el servicio de repositorio en modo exclusivo para realizar tareas que permiten la conexión de un solo usuario al repositorio.
Ejecute el servicio de repositorio en modo exclusivo para usar los comandos de pmrep siguientes:
- •Create
- •Delete
- •Register
- •RegisterPlugin
- •Unregister
- •UnregisterPlugin
Puede usar Administrator Tool o infacmd para ejecutar el servicio de repositorio en modo exclusivo.
Códigos de retorno pmrep
pmrep indica si un comando se ha ejecutado correcta o incorrectamente con un código de retorno. El código de retorno “0” indica que el comando se ha ejecutado correctamente. El código de retorno “1” indica que el comando ha fallado. Algunos comandos realizan varias operaciones. Por ejemplo, AddToDeploymentgroup añade varios objetos a un grupo de implementación. En estos casos, un código de retorno “0” indica que el comando se ha ejecutado correctamente, incluso si solo se han implementado correctamente algunos de los objetos.
Introduzca uno de los siguientes comandos echo de DOS o UNIX justo después de ejecutar el comando pmrep:
- •En un shell de DOS, escriba echo %ERRORLEVEL%
- •En un shell de UNIX Bourne o Korn, escriba echo $?
- •En un shell de UNIX C, escriba echo $status
Utilización de cadenas de conexión nativas
Algunos comandos pmrep, tales como CreateConnection y Restore, requieren de una cadena de conexión nativa.
La tabla siguiente describe la sintaxis de la cadena de conexión nativa para cada una de las bases de datos de repositorio compatibles:
Base de datos | Sintaxis de cadena de conexión | Ejemplo |
|---|
IBM DB2 | dbname | mydatabase |
Microsoft SQL Server | servername@dbname | sqlserver@mydatabase |
Oracle | dbname.world (el mismo que aparece en la entrada TNSNAMES) | oracle.world |
Sybase ASE | servername@dbname | sambrown@mydatabase |
Scripts de comandos pmrep
Cuando use pmrep, podría usar algunos comandos con opciones y argumentos específicos de forma periódica. Por ejemplo, puede usar pmrep para realizar una copia de seguridad diaria de un repositorio de producción. En este caso, puede crear un archivo de script para llamar a uno o más comandos de pmrep, incluidos sus opciones y argumentos.
Por ejemplo, el siguiente archivo por lotes de Windows, backupproduction.bat, conecta y hace una copia de seguridad de un repositorio llamado Production:
backupproduction.bat
REM This batch file uses pmrep to connect to and back up the repository Production on the server ServerName
@echo off
echo Connecting to repository Production...
c:\PowerCenter\pmrep\pmrep connect -r Production -n Administrator -x Adminpwd -d MyDomain -h Machine -o 8080
echo Backing up repository Production...
c:\PowerCenter\pmrep\pmrep backup -o c:\backup\Production_backup.rep
Puede ejecutar archivos de script en la interfaz de comandos. No puede ejecutar archivos por lotes de pmrep en modo interactivo.
Sugerencias sobre scripts de comandos pmrep
Utilice las siguientes sugerencias cuando cree y ejecute scripts de pmrep:
- •Incluya un comando Connect como el primer comando al que llama el archivo de script. Esto ayuda a garantizar que las tareas se realizan en el repositorio correcto.
- •Para ejecutar scripts de pmrep que conectan a distintos repositorios al mismo tiempo, establezca la variable de entorno INFA_REPCNX_INFO en cada entorno para almacenar el nombre y la ruta de archivo para el archivo de conexión del repositorio. Esto impide que un script pueda sobrescribir la información de conexión utilizada por otro script.