CICS LOAD

CICS DELETE TDQ CICS Release Statement

Advertisements


Load is used to load application program from disk memory to main memory.

Load can load map set also from disk to main memory.

An application program can’t load another application program by issuing LOAD command.

The Request will be ignored even if the application program triggered a LOAD command.

Programs can’t be loaded by using LOAD command in Multi region environments.

If the copy of the program is not there in main memory, LOAD fetches the application table or map set from disk storage and loads it to the main directory.

If SET option coded with LOAD command, then it will return the pointer of the load.


Syntax:

EXEC CICS 

     LOAD PROGRAM(program-name) 
     SET(ptr-ref)
     LENGTH(data-area)
     ENTRY(ptr-ref)
     HOLD
     FLENGTH(data-area)  
  
END-EXEC. 

PROGRAM(program-name):

Program name is mandatory entry in LOAD command.

Program name is of 8 characters length which includes alphanumeric characters.

Program id and program name should be same in each case.

When the LOAD is executed, the CICS will check the program definition to load from disk memory to main memory.

Program-name can be either the application table or map set.

The application table or map set should be defined in program definition table.


SET(ptr-ref):

SET is an optional entry in LOAD command.

SET operator is used to load the starting address of the application table or map set that has been loaded.


LENGTH(data-area):

LENGTH is an optional entry in LOAD command.

LENGTH is used to receive the length of the loaded application program or mapset

LENGTH is a 2 byte field.

LENGTH can load the application programs or map set up to 32767 bytes size.

Otherwise, FLENGTH will be used.


ENTRY(ptr-ref):

ENTRY is an optional entry in LOAD command.

ENTRY operator is used to load the starting address of the entry point of application table or map set that has been loaded.

In Multiplatform environment if we use ENTRY option, then LOAD will return a NULL pointer.


HOLD:

HOLD is an optional entry in LOAD command.

HOLD specifies that the application program or map set should not get deleted until the RELEASE command issued.

HOLD will be used for the repetitively executing programs or map sets which will reduce the loading time before execution.


FLENGTH(data-area):

FLENGTH is an optional entry in LOAD command.

FLENGTH is same as LENGTH option but used for larger programs.

FLENGTH is used to receive the length of the loaded application program or map set

FLENGTH is a 4 byte field.

FLENGTH can load the application programs or map set more than 32767 bytes size.


Error Conditions:


PGMIDERR:

PGMIDERR occurs in the following conditions.

• The application program or map set has no entry in program definitions.

• Program entry disabled.

• Application program or map set loading fails.


NOTAUTH:

Resource security check fails on the program name.


LENGERROR:

Occurs if LENGTH parameter is specified in LOAD command and load exceeds 32K.


CICS DELETE TDQ CICS Release Statement

Advertisements