LOAD

Descripción

La carga hace que una copia de un programa de aplicación, tabla o correlación esté disponible para la tarea de invocación. Si el programa se define con RELOAD=NO, se capta de la concatenación de bibliotecas donde reside sólo si no hay una copia ya en el almacenamiento principal. Si el programa se define con RELOAD=YES, siempre se capta una nueva copia de la concatenación LIBRARY. (Consulte Soporte de correlación básico para obtener más detalles sobre las correlaciones.) El uso de LOAD puede reducir la sobrecarga del sistema.

Opciones

ENTRY (ref-ptr)

Especifica la referencia de puntero que debe establecerse en la dirección del punto de entrada en el programa que se ha cargado. Los servicios de carga de programa CICS establecen el punto de entrada de acuerdo con la modalidad de direccionamiento del módulo de carga:

• AMODE (24): el bit 0 es 0 y el bit 31 es 0.
• AMODE (31): el bit 0 es 1 y el bit 31 es 0.
• AMODE (64): el bit 0 es 0 y el bit 31 es 1.

Para programas assembler sin un ENTRY explícito definido en las definiciones linkedit, el punto de entrada devuelto depende de si hay un apéndice CICS y de si el mandato LOAD se emite desde un programa PLT:

• Si hay un apéndice CICS , la dirección de punto de entrada se incrementa para este apéndice a menos que el mandato LOAD se emita desde un programa PLT ejecutado durante la primera fase de inicialización o la fase final de conclusión.
• Si no hay un apéndice CICS , la dirección del punto de entrada es la misma que la dirección del punto de carga.

FLENGTH (área-datos)

Especifica un área binaria de palabra completa que debe establecerse en la longitud del programa, tabla o correlación cargados. Utilice FLENGTH si la longitud del programa cargado es superior a 32 KB.

RETENER

Especifica que el programa, tabla o correlación cargado no se liberará (si sigue estando disponible) cuando termine la tarea que emite el mandato LOAD; sólo se liberará en respuesta a un mandato RELEASE de esta tarea o de otra tarea.

Si omite HOLD, el programa, tabla o correlación se libera cuando la tarea que ha emitido la carga termina o emite un mandato RELEASE.

Sin embargo, si el programa se define con RELOAD=YES, no se aplica ninguno de los anteriores. RELEASE no funciona y debe emitirse una petición FREEMAIN para eliminar el programa.

LENGTH (área-datos)

Especifica un valor binario de media palabra que debe establecerse en la longitud del programa, tabla o correlación cargados. Para evitar que se produzca la condición LENGERR, utilice FLENGTH si es probable que la longitud del programa cargado sea superior a 32 KB.

PROGRAM (nombre)

Especifica el identificador (de 1 a 8 caracteres) de un programa, tabla o correlación que se va a cargar. El nombre especificado debe haberse definido como un programa en CICS, aunque si AUTOINSTALL está activo, se instala automáticamente una definición.

SET (ref-ptr)

Especifica la referencia de puntero que se debe establecer en la dirección en la que se carga un programa, tabla o correlación.

Condiciones

16 INVREQ

Valores de RESP2:

30

El dominio del gestor de programas todavía no se ha inicializado. Esto se debe probablemente a que se ha realizado una solicitud de carga en una PLT de primera etapa.

Acción predeterminada: terminar la tarea de forma anómala.

22 LENGERR

Valores de RESP2:

19

Se utiliza LENGTH y la longitud del programa cargado es mayor que 32 KB.

Acción predeterminada: terminar la tarea de forma anómala.

70 NOTAUTH

Valores de RESP2:

101

Una comprobación de seguridad de recursos ha fallado en PROGRAM (nombre).

Acción predeterminada: terminar la tarea de forma anómala.

27 PGMIDERR

Valores de RESP2:

1

Un programa, tabla o correlación no tiene ninguna definición de recurso instalada y se ha desactivado la instalación automática del programa o el programa de control de instalación automática del programa ha indicado que el programa no debe instalarse automáticamente.

2

Un programa está inhabilitado.

3

No se ha podido cargar un programa por una de las razones siguientes:

• Esta ha sido la primera carga del programa y la carga del programa ha fallado, normalmente porque no se ha podido encontrar el módulo de carga.
• Esta era una carga posterior del programa, pero la primera carga falló.

Para restablecer el estado de carga, el módulo de carga debe estar en la concatenación DFHRPL o LIBRARY dinámica, y se necesitará SET PROGRAM NEWCOPY.

9

La definición de programa instalada es para un programa remoto.

21

El programa de control de instalación automática de programa ha fallado porque el programa de control de instalación automática de programa es incorrecto, o está definido incorrectamente, o como resultado de una terminación anómala en el programa de control de instalación automática de programa. La instalación automática de programa está inhabilitada y se graba el mensaje DFHPG0202 o DFHPG0203 en CSPL.

22

El modelo devuelto por el programa de control de instalación automática de programa no estaba definido en CICS, o no estaba habilitado.

23

El programa de control de instalación automática del programa ha devuelto datos no válidos.

24

La definición del programa ha fallado porque la instalación automática ha devuelto un nombre o definición de programa no válido.

42

Se ha realizado un intento de cargar un programa JVM. Esta acción no es válida porque los programas de código de bytes Java™ no están gestionados por el cargador CICS .

Acción predeterminada: terminar la tarea de forma anómala.