The Acquire_Program Call - IBM SC34-6814-04 Customization Manual

RESPONSE
DISASTER
INVALID
KERNERROR
PURGED
Note: For more detail, refer to the explanation of RESPONSE and REASON in

The ACQUIRE_PROGRAM call

ACQUIRE_PROGRAM returns the entry and load point addresses, the length, and
a new program token for a usable copy of the named program, which can be
identified by either its name or a program token.
ACQUIRE_PROGRAM
DFHLDLDX [CALL,]
This command is threadsafe.
ENTRY_POINT(name4 | (Ra))
LOAD_POINT(name4 | (Ra))
NEW_PROGRAM_TOKEN(name4)
PROGRAM_ATTRIBUTE(name1 | (Rn))
356
Customization Guide
"Making an XPI call" on page 308.
[CLEAR,]
[IN,
FUNCTION(ACQUIRE_PROGRAM),
{PROGRAM_NAME(name8 | string | 'string')|
PROGRAM_TOKEN(name4)},
[SUSPEND(NO|YES),]]
[OUT,
ENTRY_POINT(name4 | (Ra)),
[LOAD_POINT(name4 | (Ra)),]
[NEW_PROGRAM_TOKEN(name4),]
[PROGRAM_ATTRIBUTE(name1 | (Rn)),]
[PROGRAM_LENGTH(name4 | (Rn)),]
RESPONSE(name1 | *),
REASON(name1 | *)]
returns the program's entry point address.
name4
The name of a 4-byte location to receive the 31-bit entry address
(Ra) A register to receive the entry address.
returns the program's load point address.
name4
The name of a 4-byte location to receive the loaded address
(Ra) A register that is to contain the load address.
returns the new program token for a usable copy of the named program.
name4
The name of a location to receive a 4-byte token that identifies this
program and instance.
returns the program attribute.
REASON
CATALOG_NOT_OPERATIONAL
None
None
None
None