 |
Upgrading Privileged-Code Applications on OpenVMS Alpha and
OpenVMS I64 Systems
CVT_IPID_TO_PCB_KTB Macro
Converts a PID to PCB and KTB addresses. Applicable to MACRO-32 only.
Format
CVT_IPID_TO_PCB_KTB ipid ,ktbreg ,pcbreg ,fail
RETURNS
| OpenVMS usage |
cond_value |
| type |
longword (unsigned) |
| access |
write only |
| mechanism |
by value |
Status indicating the success or failure of the operation.
Arguments
ipid
This argument provides the internal PID to be converted.
ktbreg
This argument is the destination to return the KTB address. The default is
R14.
pcbreg
This argument provides the register which returns the PCB. The default is R14.
preserve
This argument is not used by this macro but is passed to CVT_IPID_TO_KTB to
indicate whether to preserve R0 and R1.
fail
This argument provides the address to transfer control if the ipid argument
is not valid. If this transfer is taken, R0 contains one of the status values
in the Return Values section.
Description
The CVT_IPID_TO_PCB_KTB macro converts a PID to PCB and KTB addresses.
This macro applies to MACRO-32 only.
Return Values
| SS$_NONEXPR |
The process does not exist. |
| SS$_NOSUCHTHREAD |
The process exists but the thread does not. |
CVT_IPID_TO_KTB Macro
Converts a PID to a KTB address. Applies to MACRO-32 only.
Format
CVT_IPID_TO_KTB ipid ,ktbreg ,pcbreg ,perserve ,fail
RETURNS
| OpenVMS usage |
cond_value |
| type |
longword (unsigned) |
| access |
write only |
| mechanism |
by value |
Status indicating the success or failure of the operation.
Arguments
ipid
This argument provides the internal PID to be converted.
ktbreg
This argument provides the register that returns the KTB. The default is R14.
pcbreg
This argument provides the register which holds the PCB. The default is R14.
preserve
This argument's default is YES to save R0 and R1.
fail
This argument provides the address to transfer control if the ipid argument
is not valid. If this transfer is taken, R0 contains one of the status values
in the Return Values section.
Description
The CVT_IPID_TO_KRB macro converts a PID to a KTB address. This macro
applies to MACRO-32 only.
Return Values
| SS$_NONEXPR |
The process does not exist. |
| SS$_NOSUCHTHREAD |
The process exists but the thread does not. |
|
