$GET DEFAULT TRANS

From VSI OpenVMS Wiki
Jump to: navigation, search

$GET_DEFAULT_TRANS is a system service that returns the default transaction of the calling process.

A precondition for the successful completion of $GET_DEFAULT_TRANS is that the calling process must have a default transaction. $GET_DEFAULT_TRANS may fail for various reasons, including:

  • The precondition was not met.
  • The default transaction was being changed at the time of the call.

The postcondition on successful completion of $GET_DEFAULT_TRANS is described in the following table:

Postcondition Meaning
The identifier of the default transaction of the calling process is returned. The identifier (TID) of the default transaction of the calling process is returned in the tid argument.

Format

SYS$GET_DEFAULT_TRANS tid

C Prototype: 

int sys$get_default_trans (unsigned int tid [4]);

Arguments

tid

OpenVMS usage: trans_id
Type: octaword (unsigned)
Access: write only
Mechanism: by reference

Address of an octaword in which the identifier (TID) of the default transaction of the calling process is returned.

Condition Values Returned

Value Description
SS$_NORMAL The request was successful.
SS$_INSFARGS A required argument was missing.
SS$_INSFMEM There was insufficient system dynamic memory for the operation.
SS$_NOCURTID The calling process did not have a default transaction.
SS$_WRONGSTATE The default transaction was being changed at the time of the call.

Privileges Required

None

Quota Required

None

See also

Retrieved from "https://wiki.vmssoftware.com/index.php?title=$GET_DEFAULT_TRANS&oldid=1564"