Comandos de administración de rutas de búsqueda

En esta sección:

El servidor tiene una ruta de búsqueda por defecto para los componentes de las aplicaciones y del sistema. Puede suplir esta ruta con uno o varios de los siguientes comandos:

Por lo general, estos comandos añaden aplicaciones al principio de la ruta de búsqueda predeterminada. La única excepción son los comandos temporales creados en la sesión actual. Primero se buscan estos componentes temporales; antes que la ruta definida por el usuario.

Puede emitir el comando APP PATH manualmente o establecer la ruta de búsqueda de aplicaciones desde la Consola Web o la Consola de administración de datos. Al configurar la ruta de aplicaciones desde la Consola Web o la Consola de administración de datos, el comando APP PATH queda almacenado en un perfil seleccionable (global, de grupo o de usuario). El perfil global, edasprof, es el predeterminado.


Principio de página

x
APP PATH

Cómo:

El comando APP PATH establece la ruta de búsqueda en una lista designada de nombres de aplicaciones que hacer referencia a las aplicaciones situadas bajo el valor de approot. Puede especificar varios nombres de aplicaciones para ampliar la ruta de búsqueda.



x
Sintaxis: Cómo Añadir una aplicación a la ruta de búsqueda manualmente
APP PATH app1[/] [app2[/] ...]    [-
  appn[/]]

donde:

app1...appn

Son nombres de aplicaciones. Si añade una barra diagonal (/) al final del nombre de una aplicación, no aparecerán en la ruta de búsqueda las aplicaciones anidadas (el subárbol de aplicaciones situado bajo dicha aplicación). Si no añade una barra diagonal al final del nombre de una aplicación, el parámetro nested_app del archivo edaserve.cfg determina si se examinarán las aplicaciones anidadas en busca de archivos citados en un procedimiento y, en caso afirmativo, hasta que nivel. Si el número de aplicaciones excede una línea, añada el carácter de continuación (-) al final de la primera y codifique más nombres de aplicaciones en la próxima línea.

Nota:


Principio de página

x
APP PREPENDPATH

Cómo:

El comando APP PREPENDPATH permite añadir nombres de aplicaciones al principio de una ruta de búsqueda APP PATH existente, de forma temporal.

Si quiere usar este comando para modificar la ruta de búsqueda, codifíquelo en su aplicación de forma manual.



x
Sintaxis: Cómo Añadir nombres de aplicaciones al principio de una ruta de búsqueda
APP PREPENDPATH app1[/] [app2[/]] ...     [-
  appn[/]]

donde:

app1...appn

Son nombres de aplicaciones. Si añade una barra diagonal (/) al final del nombre de una aplicación, no aparecerán en la ruta de búsqueda las aplicaciones anidadas (el subárbol de aplicaciones situado bajo dicha aplicación). Si no añade una barra diagonal al final del nombre de una aplicación, el parámetro nested_app determina si se examinarán las aplicaciones anidadas en busca de archivos citados en un procedimiento y, en caso afirmativo, hasta que nivel. Si el número de aplicaciones excede una línea, añada el carácter de continuación (-) al final de la primera y codifique más nombres de aplicaciones en la próxima línea.


Principio de página

x
APP APPENDPATH

Cómo:

El comando APP APPENDPATH permite añadir nombres de aplicaciones al final de una ruta de búsqueda APP PATH existente, de forma temporal.

Si quiere usar este comando para modificar la ruta de búsqueda, codifíquelo en su aplicación de forma manual.



x
Sintaxis: Cómo Añadir nombres de aplicaciones al final de una ruta de búsqueda
APP APPENDPATH app1[/] [app2[/]] ...            [-
  appn[/]]

donde:

app1...appn

Son nombres de aplicaciones. Si añade una barra diagonal (/) al final del nombre de una aplicación, no aparecerán en la ruta de búsqueda las aplicaciones anidadas (el subárbol de aplicaciones situado bajo dicha aplicación). Si no añade una barra diagonal al final del nombre de una aplicación, el parámetro nested_app determina si se examinarán las aplicaciones anidadas en busca de archivos citados en un procedimiento y, en caso afirmativo, hasta que nivel. Si el número de aplicaciones excede una línea, añada el carácter de continuación (-) al final de la primera y codifique más nombres de aplicaciones en la próxima línea.


Principio de página

x
APP MAP

Cómo:

Referencia:

El comando APP MAP permite asignar el nombre de una aplicación a un elemento que no sea una aplicación, en cualquier lugar del sistema. Este nombre de aplicación se convierte en una aplicación virtual bajo approot y puede hacer referencia a él en un comando APP PATH, o en cualquier otro comando que interprete el nombre de aplicación como si tratara de un comando.

Observe cómo las asignaciones no añaden automáticamente un directorio a la ruta de búsqueda, sino que simplemente ofrecen esa posibilidad.



x
Sintaxis: Cómo Asignar la ubicación de un archivo físico fuera de APPROOT de forma manual
APP MAP virtualname real_location

donde:

virtualname

Es el nombre de hasta 64 caracteres de una aplicación que se puede usar más adelante en un comando APP PATH.

real_location

Es el nombre real y completo de una ruta o DDNAME, en el estilo nativo del sistema operativo.

Tenga en cuenta que si la ubicación real contiene espacios, debe estar entre comillas dobles.

Nota: En IBM i, el comando APP MAP sólo puede emplearse para asignar un directorio IFS, no una librería QSYS.



Ejemplo: Comandos APP MAP de ejemplo

Ejemplo básico en Windows:

APP MAP test c:\temptest\

Tenga en cuenta que si el nombre de una aplicación contiene espacios, debe estar entre comillas dobles. Por ejemplo:

APP MAP test "c:\temp test\"


x
Sintaxis: Cómo Asignar asignaciones de DDNAME

En el Servidor unificado (implementaciones de HFS o PDS), la sintaxis de este tipo de asignación es

APP MAP appname file_extension=//dd:ddname;file_extension=//dd:ddname;...

donde:

appname

Es el nombre de la aplicación utilizada para hacer referencia a esta asignación en un comando APP PATH, APP APPENDPATH o APP PREPENDPATH.

file_extension

Es una de las siguientes extensiones válidas de archivos de servidor:

.mas
.fex
.acx
.htm
.sty
.gif
.psb
ddname

Es el ddname de la asignación que desea asignar o mapear. Puede llevar a cabo la asignación utilizando código JCL o un comando DYNAM.



Ejemplo: Cómo asignar (mapear) asignaciones de DDNAME
DYNAM ALLOC FILE MYMAS DA EDAARH.MASTER.DATA SHR REU
APP MAP APP1 MAS=//DD:MYMAS;
APP APPENDPATH APP1

El servidor incluye por defecto un comando APP MAP en el archivo edasprof.prf para asignar o mapear la aplicación MVSAPP a las asignaciones FOCEXEC, MASTER, ACCESS, HTML, FOCSTYLE, GIF, FOCPSB. Aunque las asignaciones de estos ddnames no son obligatorias para que el comando APP MAP sea válido, una vez asignados por los comandos JCL o DYNAM, quedan disponibles para su uso.



x
Referencia: APP MAP con la Convención de nomenclatura universal (UNC)

Debe usar la Convención de nomenclatura universal (UNC, en sus siglas inglesas) para designar el acceso de una unidad de red a los directorios APP, en las plataformas compatibles con esta convención. La UNC:


Principio de página

x
APP SET METALOCATION_SAME

Cómo:

El comando APP SET METALOCATION_SAME indica si los archivos máster, y sus archivos de acceso correspondientes, deben estar en la misma ubicación.



x
Sintaxis: Cómo Controlar la ubicación de archivos de sinónimos
APP SET METALOCATION_SAME {ON|OFF}

donde:

ON

Especifica que los archivos máster, y sus archivos de acceso correspondientes, deben residir en el mismo directorio de aplicaciones. ON es el valor predeterminado.

Inactivo

Especifica que, una vez localizado el archivo máster de una solicitud, el servidor utilizará la ruta de búsqueda activa para buscar el archivo de acceso correspondiente.


Principio de página

x
APP ? METALOCATION_SAME

Cómo:

El comando ? APP SET METALOCATION_SAME realiza una consulta para averiguar si los archivos máster, y sus archivos de acceso correspondientes, deben estar en la misma ubicación.



x
Sintaxis: Cómo Consultar si los archivos de sinónimos deben residir en la misma ubicación
APP ? METALOCATION_SAME

Si el resultado de este comando de consulta es Activo, el servidor espera encontrar los archivos máster y de acceso correspondientes, en el mismo directorio de aplicaciones. Si el resultado es Inactivo, el servidor emplea la ruta de búsqueda activa para localizar el archivo de acceso correspondiente a un archivo máster determinado.


Principio de página

x
APP SHOWPATH

Cómo:

El comando APP SHOWPATH lista todas las aplicaciones activas en ese momento, en la ruta de búsqueda, incluida baseapp, que siempre es la última. Esta lista imita la lista de aplicaciones mostrada en el árbol de aplicaciones del panel de navegación.



x
Sintaxis: Cómo Listar aplicaciones activas
APP SHOWPATH


Ejemplo: Cómo listar las aplicaciones activas en la ruta de búsqueda

Generalmente, el servidor se instala con dos aplicaciones predefinidas: ibisamp (contiene archivos de ejemplo) y baseapp (puede contener cualquier archivo que haya creado).

El comando APP SHOWPATH genera la siguiente salida:

ibisamp
baseapp

WebFOCUS