H-Series Application Migration Guide (H06.03+)

H-Series Application Migration Guide—429855-006

9-1

Guardian API Migration Tasks

This section describes changes in the H-series Guardian and OSS application program

interface (API) calls. The calls described in this section have slightly different behavior,

have different or additional return values, or have been superseded by a new

procedure in the H-series RVUs. This section also lists procedures that are new in the

H-series RVUs. See the Guardian Procedure Calls Reference Manual manual for

detailed descriptions of the procedures mentioned in this section. Topics covered in

this section are:

•

Procedures and Functions Having Different Behavior

•

Procedures Having New Return Values on page 9-2

•

Superseded Procedures on page 9-3

•

New Procedures on page 9-3

Procedures and Functions Having Different

Behavior

The following procedures have different behavior in the H-series RVUs.

Different Buffer Alignment for GETPOOL and

POOL_GETSPACE_ Procedures

For TNS/R native callers, the GETPOOL and POOL_GETSPACE_ procedures return

pointers to 32-bit aligned buffers. For TNS/E native callers, these procedures return

pointers to 128-bit aligned buffers by default. See the Guardian Procedure Calls

Reference Manual for details on how to change the default alignment.

As a result of these differences in buffer alignment, a TNS/E native buffer pool might

not be able to allocate as many data blocks as can be allocated from the same size

pool on a TNS/R platform. Most processes will not be affected by this change, unless

the pool was already near capacity.

DEBUG and PROCESS_DEBUG_ Procedures Invoke H-Series

Debuggers

The DEBUG and PROCESS_DEBUG_ procedures are changed to invoke one of the

new debugging tools on H-series systems. The H-series debugging tools are Visual

Inspect and Native Inspect for TNS/E native processes, and Visual Inspect and Inspect

for TNS processes. The debugging tool invoked depends on the execution mode (TNS