Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
Begin_Transaction (ATRBEG, ATR4BEG) z/OS MVS Programming: Resource Recovery SA23-1395-00 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
A work manager calls the Begin_Transaction service to begin a transaction
and set the transaction mode. Begin_Transaction allows an application
to clearly mark the beginning boundary of a transaction. The transaction
mode, which affects resource managers within the boundaries of this
transaction, can be local or global, as follows:
EnvironmentThe requirements for the caller are:
Programming requirementsEither link edit your object code with the linkable stub routine ATRRCSS (31 bit) or ATRR4CSS (64 bit) from SYS1.CSSLIB, or LOAD and CALL the callable service. The high level language (HLL) definitions for the callable service are:
RestrictionsThe current UR state must be in-reset. The current default environment setting for transaction mode must not be hybrid-global. Input register informationBefore issuing the call, the caller does not have to place any information into any register unless using it in register notation for the parameters, or using it as a base register. Output register informationWhen control
returns to the caller, the GPRs contain:
When control returns to the caller, the ARs
contain:
Some callers depend on register contents remaining the same before and after issuing a call. If the system changes the contents of registers on which the caller depends, the caller must save them before calling the service, and restore them after the system returns control. Performance implicationsNone. SyntaxWrite the call as shown in the syntax diagram. You must code the parameters in the CALL statement as shown.
ParametersThe parameters are explained
as follows:
ABEND codesThe call might result in an abend X'5C4' with a reason code of either X'00023000' or X'00023001'. See z/OS MVS System Codes for the explanations and actions. Return codesWhen the service returns control to the resource manager, GPR 15 and return_code contain a hexadecimal return code.
ExampleIn the pseudocode example, the
work manager issues a call to begin a local transaction.
|
Copyright IBM Corporation 1990, 2014
|