IBM SC34-6814-04 User Manual

Page 376

Advertising
background image

Table 19. Summary of attributes defining DSA eligibility (continued)

EXECUTION_KEY

option

Reentrant

Above or below

16MB line

Dynamic storage

area (DSA)

CICS

Yes

Below

RDSA

CICS

No

Above

ECDSA

CICS

Yes

Above

ERDSA

USER

No

Below

UDSA

USER

Yes

Below

RDSA

USER

No

Above

EUDSA

USER

Yes

Above

ERDSA

NEW_PROGRAM_TOKEN(name4)

returns the token supplied for the newly-defined program.

name4

The name of a location to contain the 4-byte token obtained.

PROGRAM_ATTRIBUTE(RELOAD|RESIDENT|REUSABLE|TRANSIENT)

specifies the residency status of the program.

RELOAD

Every ACQUIRE_PROGRAM request for this program is satisfied by
loading a new copy into storage. When a RELEASE request is issued
for a copy, it is removed from storage.

Note: Do not use this attribute when defining an exit program.

RESIDENT

There is a single copy of the program that is not removed from storage
unless deleted. RESIDENT programs must be at least quasireentrant.

REUSABLE

The program is at least quasireentrant; a single copy in storage can be
used by several tasks in the system. A REUSABLE program becomes
eligible for removal from storage as part of the normal dynamic program
compression scheme when its use count reaches zero.

TRANSIENT

Similar to REUSABLE, except that the program is removed from
storage immediately its use count reaches zero. This should be
specified only for less-frequently used programs, or for programs in
systems that are critically short on storage.

PROGRAM_NAME(name8 | string | "string")

specifies the name of the program to be defined.

name8

The name of a location where there is an 8-byte program name.

string A string of characters, without intervening blanks, naming the program.

"string"

A string of characters within quotation marks. The string length is set to
8 by padding with blanks or by truncation.

PROGRAM_TYPE(PRIVATE|SHARED|TYPE_ANY)

specifies where to load the program from.

354

Customization Guide

Advertising