LOAD - IBM Mainframe

The LOAD command execution will fetch an application program, a table, or a map, when no copy currently exists in storage, from the CICS DFHRPL concatenation library where it resides and loads it into main storage. Using this command reduces system overhead by incrementing a counter by 1 each time the command is executed. When the counter is greater than zero, no load takes place because the program already exist in storage. When the program definition specifies RELOAD=NO, then the program is only fetched from the library when no copy currently exists in main storage (usage counter = zero). If the program definition specifies RELOAD=YES, a new copy will always be fetched from the DFHRPL concatenation library.

  • ENTRY (ptr_ref) - Contains the pointer reference which is set to the address of the entry point in the program, table, or map that has been loaded.
  • FLENGTH (data_area) - Fullword binary field (PIC S9 (8) COMP) containing the length value of the loaded program, table, or map. Use this option if the length of the loaded program is likely to be greater than 32KB.
  • HOLD - This option when specified on the command indicates to CICS that the loaded program, table, or map is not to be deleted (if still resident) upon completion of the issuing task. Program deletion from storage will only occur in response to the RELEASE command from any task. Omitting this option will cause the program, table, or map to remain main storage only until the task that issued the load terminates or- issues a RELEASE command. With program definition RELOAD=YES, RELEASE does notyvprk, and a FREEMAIN must be issued to get rid of the program.
  • LENGTH (data_area) - Halfword binary field (PIC S9(4) COMP) containing the length value of the loaded program, table, or map. To avoid raising the LENGERR condition, use FLENGTH if the length of the loaded program is likely to be greater than 32KB.
  • PROGRAM (name) - Character field (1-8 bytes) specifying the name of a program, table, or map to be loaded. The name must have been defined in the processing program table (PPT).
  • SET (ptr_ref) - Set the pointer reference value to the address of where a program, table, or map is loaded. An example of the LOAD command is given below:

The commonly occurring Handle Conditions are LENGERR, NOTAUTH and PGMIDERR.

  • LENGERR - The LENGTH option is used and the program loaded length is greater than 32kb. The default action is the abnormal task termination.
  • NOTAUTH - Resource security check failure has occurred on PROGRAM (name). The default action of the NOAUTH handle condition is the abnormal task termination.
  • PGMIDERR - This handle condition can occur for any of the following reasons:
    1. Program specified is not contained in the CICS PPT
    2. The program is disabled
    3. The program cannot be loaded
    4. The installed program definition is for a remote program

The default action when this error occurs is the abnormal task termination.


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM Mainframe Topics