LOAD. IBM iSeries

TERMERR

RESP2 values:

17

There is an unrecoverable error during the conversation with the mirror (for example, if the session fails, or if the server system fails).

Default action: Terminate the task abnormally.

Examples

The following example shows how to request a link to an application program called PROG1:

LOAD

(

Provide addressability to resources defined in the PPT.

name

)

SET (

ptr-ref

) HOLD

Conditions:

NOTAUTH, PGMIDERR

Description

Provide addressability to resources defined in the PPT. When issued with the SET option, the LOAD command provides pointer addressability to OS/400 *USRSPC objects defined as tables or map sets.

On other CICS platforms, the LOAD command can be used to reduce system overhead by fetching an application program, table, or map set from the library where it resides and loading it into main storage. CICS/400 program management is provided by OS/400 and, therefore, CICS/400 does not require the use of the

LOAD command for this purpose.

Each time a LOAD command is issued for the same resource, a use count is incremented by 1.

Refer to Chapter 20, “Program control,” on page 199 for more information.

Options

HOLD

specifies, on other CICS platforms, that the loaded program, table, or map set is not to be removed from main storage when the task issuing the LOAD command terminates, but is to be removed only in response to a RELEASE command issued by this task or another task. CICS/400 supports use of the

HOLD option and insists on correct usage of the HOLD option and the

RELEASE command.

PROGRAM(

name

)

specifies the identifier of the table or map set to be loaded. The name must be alphanumeric and up to 8 characters long.

Chapter 32. Application programming commands - reference

385