CICS Manual do Usuário - LOAD

LOAD

Loads an application table or mapset from a disk directory into shared main storage.
For TXSeries for Multiplatforms regions, programs cannot be loaded by use of the LOAD command.
If an application program issues a LOAD command for another program, the request is ignored.
If the command includes the SET option or ENTRY option, the value that is returned in each case is a null pointer.

Sintaxe

Descrição:

LOAD fetches an application table or mapset, if no copy is in storage, from the disk directory where it resides and loads it into shared main storage.
If a copy of the resource is already resident in storage, a pointer to this copy is returned if the command includes the SET option.
This facility is used to load an application table (to which control is not to be passed), or to load a mapset that is to be used in a mapping operation.

If you omit HOLD, the table or mapset remains in main storage only until the task that issued the load terminates or issues a RELEASE command.

See the TXSeries for Multiplatforms Application Programming Guide for further details about mapsets.

The following example shows how to load a user-prepared table called TB1:

     EXEC CICS LOAD 
          PROGRAM('TB1') SET(PTR)
     END-EXEC

Opções:

ENTRY(ptr-ref)

Specifies a pointer reference that is to be set to the address of the entry point in the application table or mapset that has been loaded.
If the LOAD command specifies a program, TXSeries for Multiplatforms returns a null pointer for the ENTRY option.
Note that this option is provided for portability.

FLENGTH(data-area)

Specifies a 32-bit binary field that is to receive the length of the loaded application table or mapset.
This option must be used if the length of the loaded application table or mapset is greater than 32767 bytes.

HOLD

Specifies that the loaded application table or mapset is not to be removed from main storage when the task that is issuing the LOAD command terminates; deletion is to occur only in response to a RELEASE command, from this task or from another task.

LENGTH(data-area)

Specifies a 16-bit binary field that is to receive the length of the loaded application table or mapset.
Use the FLENGTH option instead if the length of the loaded application table or mapset is likely to exceed 32767 bytes.
See LENGTH for more information about using this option.

PROGRAM(name)

Specifies the name of the application table or mapset that is to be loaded.
The name can consist of up to eight alphanumeric characters, and must be defined appropriately in the Program Definitions (PD).

SET(ptr-ref)

Specifies a pointer reference that is to be set to the address at which the application table or mapset is loaded.
See INTO and SET for more information about using this option.
If the LOAD command specifies a program, CICS returns a null pointer for the SET option.

Condições:

LENGERROR

Occurs if the LENGTH parameter exceeds 32 KB in size.
Ação pré-definida: Terminates the task abnormally.

NOTAUTH

Occurs if a resource security check has failed on PROGRAM(name).
Ação pré-definida: Terminates the task abnormally.

PGMIDERR

Occurs in any of the following conditions:
- The application table or mapset has no entry in the Program Definitions (PD) (RESP2=1).
- The application table or mapset is disabled (RESP2=2).
- A request has been made to load a program, not a table or a mapset (RESP2=3).
Ação pré-definida: Terminates the task abnormally.

Informações relacionadas: