 |
The ATRSRV macro allows authorized callers to: - Remove a resource manager's interest in a UR
- Resolve a UR state from In-doubt to In-Commit.
- Resolve a UR state from In-doubt to In-Backout.
- Remove a Resource Manager's identity
- Unregister a Resource Manager's involvement with
RRS
- Perform Forget processing on a UR whose In-Doubt:
condition has been resolved.
Environment The requirements for the caller
are:
| Minimum authorization: |
Supervisor state and PSW key 0-7 or RACF® authority as defined in the following paragraphs |
| Dispatchable unit mode: |
Task |
| Cross memory mode: |
Any PASN, any HASN, any SASN |
| AMODE: |
31-bit |
| ASC mode: |
Primary |
| Interrupt status: |
Enabled for I/O and external interrupts |
| Locks: |
No locks may be held. |
| Control parameters: |
Control parameters must be in the primary address space. |
If your installation uses the RACF component of SecureWay for z/OS to control
access to RRS information, ATRSRV requires ALTER access to one of
two RACF resources in the FACILITY
class.
To view URs on other systems in a sysplex, ATRSRV requires
ALTER access to the MVSADMIN.RRS.COMMANDS.gname.sysname resource
in the FACILITY class, where gname is the
target logging group name, and sysname is
the target system name. You may create a RACF profile to permit access to multiple logging
groups and systems by including RACF valid
generic characters (**, *, and %) in gname and sysname.
See the z/OS Security Server RACF Security Administrator's Guide and z/OS Security Server RACF Command Language Reference
for more information about using these RACF generic
characters and defining RACF profiles.
By permitting ALTER access through this profile, you can allow users
to alter RRS information on any number of systems in the sysplex.
If
you are running RRS on a single system, ATRSRV requires ALTER access
to either the MVSADMIN.RRS.COMMANDS.gname.sysname resource
or the MVSADMIN.RRS.COMMANDS resource in the FACILITY class. The MVSADMIN.RRS.COMMANDS
resource only allows access to RRS system management functions on
the current system. You cannot use the MVSADMIN.RRS.COMMANDS resource
to allow or disallow use of RRS on another system.
ATRSRV does
not check the SYSSTATE global variable or the SPLEVEL global variable.
Programming requirements ATRSRV callers
must include the following mapping macros: ATRFZSRV, CVT, IHAECVT
Input register information Before issuing
the ATRSRV macro, the caller does not have to place any information
into any register unless using it in register notation for a particular
parameter, or using it as a base register.
Output register information When control
returns to the caller, the GPRs contain: - Register
- Contents
- 0
- Contains the reason code
- 1-13
- Unchanged
- 14
- Used as a work register by the system.
- 15
- Contains the return code
Some callers depend on register contents remaining
the same before and after issuing a service. If the system changes
the contents of registers on which the caller depends, the caller
must save them before issuing the service, and restore them after
the system returns control.
Performance implications None.
Syntax The ATRSRV macro is written as follows:
| |
| |
| name |
name: symbol.
Begin name in column 1. |
| |
| ␢ |
One or more blanks must precede ATRSRV. |
| |
| ATRSRV |
| |
| ␢ |
One or more blanks must follow ATRSRV. |
| |
| |
| |
| REQUEST=REMOVINT |
| ,RMNAME=(xrmname |
0) |
|
| ,URID=(xurid |
0) |
|
| REQUEST=COMMIT |
| ,URID=(xurid |
0) |
|
| REQUEST=BACKOUT |
| ,URID=(xurid |
0) |
|
| REQUEST=REMOVRM |
| ,RMNAME=xrmname |
|
| REQUEST=UNREGRM |
|
| ,RMNAME=xrmname |
|
| REQUEST=FORGET |
|
| ,URID=xurid |
|
| |
| ,RMNAME=xrmname |
xrmname: RS-type
address or address in register (2) - (12). |
| |
| ,URID=xurid |
xurid: RS-type
address or address in register (2) - (12). |
| |
Note: URID is optional with REQUEST=REMOVINT.
|
| |
| ,GNAME=(xgname |
current_gname) |
xgname: RS-type
address or register (2) - (12). |
| ,SYSNAME=(xsysname |
current_sysname) |
xsysname: RS-type
address or register (2) - (12). |
| ,RCTABLE=(xrctable |
0) |
xrctable: RS-type
address or address in register (2) - (12). |
| ,RCNUM=xrcnum |
xrcnum: RS-type
address or address in register (2) - (12). |
| ,RETCODE=xretcode |
xretcode: RS-type
address or register (2) - (12). |
| |
| ,RSNCODE=xrsncode |
xrsncode: RS-type
address or register (2) - (12). |
| |
| ,PLISTVER=IMPLIED_VERSION |
| ,PLISTVER=MAX |
Default: PLISTVER=IMPLIED_VERSION |
| ,PLISTVER=1 |
| ,PLISTVER=2 |
| ,PLISTVER=3 |
| ,PLISTVER=4 |
|
| ,PLISTVER=5 |
|
| |
| ,MF=S |
Default: MF=S |
| ,MF=(L,list addr) |
list addr: RS-type
address or register (1) - (12). |
| ,MF=(L,list
addr,attr) |
| ,MF=(L,list
addr,0D) |
| ,MF=(E,list
addr) |
| ,MF=(E,list addr,COMPLETE) |
| |
| |
Parameters The parameters are explained
as follows: - name
- An optional symbol, starting in column 1, that is the name on
the ATRSRV macro invocation. The name must conform to the rules for
an ordinary assembler language symbol.
- REQUEST=REMOVINT
- REQUEST=COMMIT
- REQUEST=BACKOUT
- REQUEST=REMOVRM
- REQUEST=UNREGRM
- REQUEST=FORGET
- A required parameter that specifies the requested function:
- REQUEST=REMOVINT
- Remove a resource manager's interest in a UR.
Note: The resource
manager must not be currently active with RRS. That is, the resource
manager cannot have exits set with RRS.
You can provide:
- Only the resource manager name
In this case, the resource
manager's interests will be removed from all URs, except for in-doubt URs,
that the resource manager has expressed interest in.
- Only the UR identifier
In this case, all resource manager
interests will be removed from the specified UR, except for the
top-level in-doubt UR.
- Both the resource manager name and the UR identifier
In this
case, the resource manager's interests will be removed from the specified
UR.
To affect units of recovery on other systems in a sysplex,
you may also provide a logging group name and a system name with the
GNAME and SYSNAME keywords.
- REQUEST=COMMIT
- Resolve an In-doubt UR to In-commit.
To affect
units of recovery on other systems in a sysplex, you may also provide
a logging group name and a system name with the GNAME and SYSNAME
keywords.
- REQUEST=BACKOUT
- Resolve an In-doubt UR to In-backout.
To affect
units of recovery on other systems in a sysplex, you may also provide
a logging group name and a system name with the GNAME and SYSNAME
keywords.
- REQUEST=REMOVRM
- Remove a resource manager's identity.
Note: The resource manager
must not be currently active with RRS or have an interest in any URs.
If this request is issued after an RRS failure, it is possible that
the request will fail due to outstanding interests. RRS does not
force deletion of log records for completed transactions, so the failure
of RRS may have left completed log records that RRS would normally
return to the restarting RM. The restarting RM would respond COMPLETE
to those interests. Should this occur, a REMOVINT request
by RM name would be required to remove the completed interests before
the REMOVRM request can succeed.
You must provide: - The resource manager name
To affect units of recovery on other systems in a sysplex, you
may also provide a logging group name with the GNAME keyword. A target
system name using the SYSNAME keyword, is not required. However, if
the SYSNAME keyword is used, it is not validated and is ignored.
- REQUEST=UNREGRM
- Unregister RM - is used to clean up the resource managers involvement
with RRS. Only resource managers that have been unregistered with
Registration Services but still set with RRS can be processed. RRS
Resource Manager Unregister processing will be invoked to clean up
the resource managers involvement with RRS.
You must provide: - The resource manager name. In this case, provide
the resource manager to be unregistered with RRS.
Optionally you may provide: - The GNAME and SYSNAME keywords. To affect resource
managers on other systems in a sysplex, you may also provide a logging
group name and a system name with the GNAME and SYSNAME keywords.
- REQUEST=FORGET
- Perform Forget processing for a UR (Unit of Recovery)
whose In-Doubt condition was previously resolved to In-Commit or In-Backout.
You must provide: - The URID (Unit of Recovery Identifier). In this case, the SDSRM
(Server Distributed Syncpoint Manager) interest of the UR will be
forgotten. The URID specified must contain the SDSRM interest (top-level
UR). Specifying a URID of a child or subordinate UR is not valid for
this request and will result in a reason code of ATRSRV_URID_NOT_FOUND
(8).
Optionally you may provide: - The GNAME and SYSNAME keywords. To affect units of recovery on
other systems in a sysplex, you may also provide a logging group name
and a system name with the GNAME and SYSNAME keywords.
- ,RMNAME=rmname
-
An input parameter that contains the resource
manager name. It is optional with:
It is required with: - REQUEST=REMOVRM
- REQUEST=UNREGRM.
If REQUEST=REMOVINT is requested and the resource manager you
name is a distributed syncpoint resource manager (DSRM), you can not remove an interest from any UR with a state
of in-doubt unless you specify URID to remove all interests
from a specific UR. If REQUEST=REMOVRM is requested, the resource
manager will be deleted from RRS storage and the RRS logs.
If REQUEST=UNREGRM is requested, the resource manager will be unregistered
with RRS. To code: Specify the RS-type address, or address
in register (2)-(12), of a 32-character field.
- ,URID=urid
- An input parameter that contains the UR identifier. It
is required with REQUEST=COMMIT, REQUEST=BACKOUT, or REQUEST=FORGET. It
is optional with REQUEST=REMOVINT.
To code: Specify the
RS-type address, or address in register (2)-(12), of a 16-character
field.
- ,GNAME=gname
- An optional input parameter that contains the name of the RRS
logging group containing the specified resource manager or URID.
- If you specify GNAME, you must also specify SYSNAME. However,
if REQUEST=REMOVRM, the SYSNAME parameter is not required.
- If you do not specify GNAME, it will default to the current system's
RRS logging group name.
To code: Specify the RS-type address, or address in
register (2)-(12), of an 8-character field.
- ,SYSNAME=sysname
- An optional input parameter that contains the name of the system
containing the specified resource manager or URID.
- If you specify SYSNAME, you must also specify GNAME.
- If you do not specify SYSNAME, it will default to the current
system's system name.
- If you specify REQUEST=REMOVRM, this parameter is not required.
If specified, the value is not validated and is ignored.
To code: Specify the RS-type address, or address in
register (2)-(12), of an 8-character field.
- ,RCTABLE=rctable
- An optional 4–byte input parameter that contains the address of
a "36" area to contain the return code and reason code from
the system and logging group processing the request. The area consists
of up to 1 36–byte entry. DSECT ATRFZRCA in mapping macro ATRFZQRY
maps the storage area. The number of entries will be returned in the
RCNUM parameter. The table will only contain valid information if
the reason code returned to you is ATRSRV_REMOTE_WARNING or ATRSRV_REMOTE_ERROR. Default: RCTABLE=0
No return code table is desired.
If you specify REQUEST=REMOVRM,
this parameter contains the address of a "2304" area to contain
the return/reason code from each system in the Logging Group processing
the REMOVRM request. The area consists of up to 64 36-byte entries.
To
code: Specify the RS-type address, or address in register (2)-(12),
of a "36" area, or a "2304" if you specify REQUEST=REMOVRM.
- ,RCNUM=rcnum
- When using RCTABLE, a required output parameter that will contain
the number of entries in the RCTABLE area (either 0 if no error occurred
or 1 for one error).
To code: Specify the RS-type address
of a fullword field, or register (2)-(12).
- ,RETCODE=retcode
- An optional output parameter into which the system copies the
return code from GPR 15.
To code: Specify the RS-type address
of a fullword field, or register (2)-(12).
- ,RSNCODE=rsncode
- An optional output parameter into which the system copies the
reason code from GPR 0.
To code: Specify the RS-type address
of a fullword field, or register (2)-(12).
- ,PLISTVER=IMPLIED_VERSION
- ,PLISTVER=MAX
- ,PLISTVER=1
- ,PLISTVER=2
- ,PLISTVER=3
- ,PLISTVER=4
- ,PLISTVER=5
- An optional input parameter that specifies the version of the
macro. PLISTVER determines which parameter list the system generates.
PLISTVER is an optional input parameter on all forms of the macro,
including the list form. When using PLISTVER, specify it on all macro
forms used for a request and with the same value on all of the macro
forms. The values are:
- IMPLIED_VERSION, which is the lowest version that allows
all parameters specified on the request to be processed. If you omit
the PLISTVER parameter, IMPLIED_VERSION is the default.
- MAX, if you want the parameter list to be the largest size
currently possible. This size might grow from release to release and
affect the amount of storage that your program needs.
If you can
tolerate the size change, IBM® recommends
that you always specify PLISTVER=MAX on the list form of the macro.
Specifying MAX ensures that the list-form parameter list is always
long enough to hold all the parameters you might specify on the execute
form; in this way, MAX ensures that the parameter list does not overwrite
nearby storage.
- 1, which supports all parameters except those specifically
referenced in higher versions.
- 2, which supports all parameters in version 1 along with
the following parameters:
- GNAME
- RCNUM
- RCTABLE
- SYSNAME
- 3, which supports additional function along with the following
REQUEST parameter:
- 4, which supports additional function:
- 5, which supports additional function:
To code: Specify one of the following: - IMPLIED_VERSION
- MAX
- A decimal value of 1
- A decimal value of 2
- A decimal value of 3
- A decimal value of 4
- A decimal value of 5
- ,MF=S
- ,MF=(L,list addr)
- ,MF=(L,list addr,attr)
- ,MF=(L,list addr,0D)
- ,MF=(E,list addr)
- ,MF=(E,list addr,COMPLETE)
- An optional input parameter that specifies the macro form.
Use
MF=S to specify the standard form of the macro, which builds an inline
parameter list and generates the macro invocation to transfer control
to the service. MF=S is the default.
Use MF=L to specify the
list form of the macro. Use the list form together with the execute
form of the macro for applications that require reentrant code. The
list form defines an area of storage that the execute form uses to
store the parameters. Only the PLISTVER parameter may be coded with
the list form of the macro.
Use MF=E to specify the execute
form of the macro. Use the execute form together with the list form
of the macro for applications that require reentrant code. The execute
form of the macro stores the parameters into the storage area defined
by the list form, and generates the macro invocation to transfer control
to the service.
- ,list addr
- The name of a storage area to contain the parameters. For MF=S,
MF=E, and MF=M, this can be an RS-type address or an address in register
(1)-(12).
- ,attr
- An optional 1- to 60-character input string, which can contain
any value that is valid on an assembler DS pseudo-op. You can use
this parameter to force boundary alignment of the parameter list.
If you do not code attr, the system provides
a value of 0D, which forces the parameter list to a doubleword boundary.
- ,COMPLETE
- Specifies that the system is to check for required parameters
and supply defaults for omitted optional parameters.
Return and reason codes When the ATRSRV
macro returns control to your program: - GPR 15 (and retcode, if you coded RETCODE)
contains a return code:
- 0
- ATRSRV_SUCCESS — request completed successfully
- 4
- ATRSRV_WARNING —request completed with a warning condition
- 8
- ATRSRV_FAILURE — request failed
- When the return code is not 0, GPR 0 (and rsncode,
if you coded RSNCODE) contains a reason code. The return and reason
codes are shown in the following table. The ATRFZSRV mapping macro
provides the equate symbols for the return and reason codes.
Table 1. ATRSRV — Resolve Units
of Recovery Return and Reason Codes| Return code in: hexadecimal |
Reason code in: hexadecimal |
Meaning and action |
|---|
| 4 |
17 |
Equate symbol: ATRSRV_REMOTE_WARNING
Meaning: An error occurred while processing a remote request
that did not affect the processing of the request. If you have been
provided with an RCTABLE, it will contain detailed error information.
Action:
Fix the error noted in the RCTABLE to eliminate the warning message
for future requests.
|
| 4 |
20 |
Equate symbol: ATRSRV_DeleteRMObjectNotSupported
Meaning: The specified Resource Manager was deleted from
the Resource Manager Data log but one or more systems in the RRS logging
group do not support the Delete RM (REMOVRM) function. If the Resource
Manager is on those systems, that Resource Manager will persist.
Action:
None. The Resource Manager cannot be deleted from systems that do
not support the Delete RM (REMOVRM) process.
|
| 8 |
1 |
Equate symbol: ATRSRV_UR_NOT_IN_DOUBT
Meaning: The UR state is not In-Doubt.
Action: Specify
the correct UR and retry the request.
|
| 8 |
2 |
Equate symbol: ATRSRV_RM_IS_ACTIVE Meaning: You
specified REMOVINT or REMOVRM but named a resource manager that is
currently active with RRS.
Action: Verify that you specified
the correct resource manager. You might need to stop the resource
manager, or make it inactive with RRS/MVS. When the resource manager
is inactive, retry the request.
|
| 8 |
3 |
Equate symbol: ATRSRV_RRS_NOT_ACTIVE
Meaning: The ATRSRV service is not available. RRS/MVS is
not active on this system.
Action: Retry the request
when RRS/MVS is active.
|
| 8 |
4 |
Equate symbol: ATRSRV_UR_HAS_DSRM
Meaning: You specified REMOVINT and named a distributed
syncpoint resource manager (DSRM), but the state of the UR you specified
is In-Doubt.
Action: Before you can remove the
interest for the DSRM, the UR state must be resolved or you must remove
all resource manager interests for the In-Doubt UR.
|
| 8 |
5 |
Equate symbol: ATRSRV_BAD_REMOVINT_PARM
Meaning: You specified REMOVINT but did not specify either
RMNAME or URID.
Action: Specify one or both of the missing
keywords and retry the request.
|
| 8 |
6 |
Equate symbol: ATRSRV_URID_NOT_VALID
Meaning: You specified a UR identifier that is either not
valid or associated with a UR that no longer exists.
Action: Verify
that you specified the correct UR identifier. If you did not specify
the correct UR identifier, do so and retry the request. If you did
specify the correct UR identifier, the UR has completed. Do not retry
the request.
|
| 8 |
7 |
Equate symbol: ATRSRV_RID_NOT_SUPPORTED
Meaning: You specified the UR identifier for an in-doubt UR
that the system cannot resolve to in-commit or In-backout.
Action: You
must wait for the DSRM to resolve the In-Doubt condition.
|
| 8 |
8 |
Equate symbol: ATRSRV_URID_NOT_FOUND
Meaning: You specified a UR identifier that the system
is unable to find. The UR might still exist but the system cannot
find it. This reason code might also be issued when
the request requires a top level URID and a child or subordinate URID
is specified.
Action: Verify that you specified
the correct UR identifier. If you did not specify the correct UR identifier,
do so and retry the request. If you did specify the correct UR identifier,
retry the request later.
|
| 8 |
9 |
Equate symbol: ATRSRV_NO_UR_FOR_RM
Meaning: You specified URINFO and named a resource manager
that does not have any interests in any URs.
Action: Verify
that you provided the correct resource manager. If you did not specify
the correct resource manager, do so and retry the request. If you
expected URs to be returned, you need to determine why the named resource
manager has no interests in any URs. Otherwise, do nothing.
|
| 8 |
A |
Equate symbol: ATRSRV_NOT_AUTH
Meaning: You are not in supervisor state, with system key,
and the RACF component of SecureWay for z/OS is
not active.
Action: Either request activation of the RACF component and obtain ALTER
access to MVSADMIN.RRS.COMMANDS or recode your application to run
in supervisor state with system key.
|
| 8 |
B |
Equate symbol: ATRSRV_NOT_SAF_AUTH
Meaning: You do not have ALTER access to MVSADMIN.RRS.COMMANDS.
Action: Either
obtain ALTER access to MVSADMIN.RRS.COMMANDS or recode your application
to run in supervisor state with system key.
|
| 8 |
C |
Equate symbol: ATRSRV_RRS_DOWNLEVEL
Meaning: The unit of recovery that was specified to process
contains information that is not understood by this level of RRS.
This level of RRS is downlevel.
This reason code
may also be issued when an ATRSRV request was processed on a downlevel
version of RRS that does not understand the request.
Action: The
attempt to process this unit of recovery must be made from a version
of RRS that can process this unit of recovery.
Route
the ATRSRV request to a RRS system that does support the request.
|
| 8 |
F |
Equate symbol: ATRSRV_GNAME_INVALID
Meaning: The value specified for the GNAME parameter is
not valid.
Action: Correct the GNAME value and retry
the request.
|
| 8 |
10 |
Equate symbol: ATRSRV_SYSNAME_INVALID
Meaning: The value specified for the SYSNAME parameter
is not valid.
Action: Correct the SYSNAME value and
retry the request.
|
| 8 |
16 |
Equate symbol: ATRSRV_INSTANCE_FAILURE Meaning:
An error occurred while processing a remote request. Your RCTABLE,
if one was provided, will contain the failing service identifier,
return code, and reason code.
Service identifiers: - 1
- IXCMSGO macro interface
- 2
- IXCMSGI macro interface
Any other value is an internal error and should be
reported to the IBM Support
center. Action: Fix the errors noted in the RCTABLE
and retry the request.
|
| 8 |
18 |
Equate symbol: ATRSRV_REMOTE_ERROR
Meaning: An error occurred while processing a remote request.
The request was not performed. If you received an RCTABLE, it will
contain detailed error information.
Action: Fix the
error noted in the RCTABLE and retry the request.
|
| 8 |
19 |
Equate symbol: ATRSRV_RESP_NOT_RECEIVED Meaning:
No response was received from the remote system. No information was
returned.
Action: Retry the request.
|
| 8 |
1A |
Equate symbol: ATRSRV_REMOTE_NOT_ACTIVE Meaning:
The remote system is not active or RRS is not active on the remote
system. No information was returned.
Action: Retry
the request once the remote system is available.
|
| 8 |
1B |
Equate symbol: ATRSRV_UR_HAS_NO_INT Meaning:
The target UR for a remove interest request has no interests. The
request is rejected.
Action: Specify the correct UR
and retry the request.
|
| 8 |
1C |
Equate symbol: ATRSRV_UR_NOT_TOP Meaning:
The requested action can only be performed on a top-level UR, but
you specified a cascaded UR. The request is rejected.
Action:
Specify the top-level UR associated with the cascaded UR and retry
the request.
|
| 8 |
1D |
Equate symbol: ATRSRV_RIN_NOT_SUPPORTED Meaning:
RRS is unable to process your remove interest request because the
coordinator system cannot be found. The request is rejected.
Action:
If the URID is in the restart log, retry the remove interest request.
|
| 8 |
1E |
Equate symbol: ATRSRV_RMSTILLHASINTERESTS Meaning:
The specified Resource Manager cannot be deleted since it has outstanding
interest in one or more URs.
Action: If the Resource
Manager must be deleted, the interests in all URs must be removed
prior to deleting the Resource Manager.
|
| 8 |
1F |
Equate symbol: ATRSRV_RMISNOTKNOWNTORRS
Meaning: The specified Resource Manager could not be
found in the Resource Manager Data log or on any system in the RRS
logging group. Either the Resource Manager has already been deleted
or the name was entered incorrectly.
Action: Make sure
the Resource Manager's name is spelled correctly. Otherwise the Resource
Manager is deleted.
|
| 8 |
20 |
Equate symbol: ATRSRV_DELETERMOBJECTSNOTSUPPORTED
Meaning: The
specified Resource Manager was deleted from the Resource Manager Data
log but one or more systems in the RRS logging group do not support
the Delete RM (REMOVRM) function. If the Resource Manager is on those
systems, that Resource Manager will persist.
Action: None,
the Resource Manager cannot be deleted from systems that do not support
Delete RM (REMOVRM) process.
|
| 8 |
21 |
Equate symbol: ATRSRV_ERRORDELETINGRMLOGENTRY
Meaning: The
specified Resource Manager was not deleted due to errors deleting
the Resource Manager from the Resource Manager logs.
Action: Correct
the problem and retry the Delete RM (REMOVRM) request.
|
| 8 |
22 |
Equate symbol: ATRSRV_DELETERMNOTSUPPORTED
Meaning: The
specified Resource Manager is on a system that does not support the
Delete RM (REMOVRM) function.
Action: None,
the Resource Manager cannot be deleted.
|
| 8 |
23 |
Equate symbol: ATRSRV_RM_NOT_FOUND Meaning: The requested Resource Manager could
not be found on the specified system in the RRS logging group.
Either the Resource Manager is not currently defined on the specified
system or it was entered incorrectly.
Action: Make
sure the Resource Manager's name is spelled correctly. Otherwise,
determine where the Resource Manager is currently defined and perform
the RM Unregister request on that system.
|
| 8 |
24 |
Equate symbol: ATRSRV_RM_STILL_REGISTERED Meaning: The requested Resource Manager is still
registered with Registration Services. To unregister a Resource Manager
with RRS, it must be unregistered with Registration Services.
Action: Issue the request again after the resource
manager has become unregistered with Registration Services.
|
| 8 |
25 |
Equate symbol: ATRSRV_RM_UNREGISTERED_NOT_ALLOWED Meaning: A Resource Manager in the Reset or Unset
state is already considered unregistered with RRS so it cannot be
unregistered again.
Action: None, the Resource
Manager is already considered unregistered.
|
| 8 |
26 |
Equate symbol: ATRSRV_UR_Not_In_Forget Meaning: The UR state is not In-Forget.
Action: Specify the correct UR and retry the
request later.
|
| 8 |
27 |
Equate symbol: ATRSRV_Not_Server_DSRM Meaning: The resource manager does not have the
server distributed syncpoint resource manager role for the unit of
recovery. The system rejects this service request.
Action: Check
the calling program for a probable coding error.
|
| 8 |
38 |
Equate symbol: ATRSRV_UR_Not_In_Forget
Meaning: The ur state is not In-Forget.
Action: Specify
the correct UR and retry the request.
|
| 8 |
39 |
Equate symbol: ATRSRV_Not_Server_DSRM
Meaning: The resource manager does not have the server
distributed syncpoint resource manager role for the unit of recovery.
The system rejects this service request.
Action: Check
the calling program for a probable coding error.
|
| 8 |
FFF |
Equate symbol: ATRSRV_UNEXPECTED_ERROR Meaning:
An unexpected system error occurred.
Action: Contact
your system support.
|
Examples
Example 1 Issue the following request to
change the state of a single UR from In-doubt to In-commit:
ATRSRV REQUEST=COMMIT,URID=MYURID
*
* INPUT VALUES
*
MYURID DC XL16'123456789ABCDEF123456789ABCDEF' UR IDENTIFIER
*
* REQUIRED MAPPINGS
*
CVT DSECT=YES
IHAECVT
ATRFZSRV
Example 2 The resource manager named UTRICK
is not currently active. Issue the following request to remove its
interests from all of the URs that it had expressed interest in: ATRSRV REQUEST=REMOVINT,RMNAME=RMTWO
*
* INPUT VALUES
*
RMTWO DC CL32'UTRICK' RESOURCE MANAGER NAME
*
* REQUIRED MAPPINGS
*
CVT DSECT=YES
IHAECVT
ATRFZSRV
Example 3 Issue the following request to
remove all resource manager interests from a specific UR: ATRSRV REQUEST=REMOVINT,URID=MYURID
*
* INPUT VALUES
*
MYURID DC XL16'123456789ABCDEF123456789ABCDEF' UR IDENTIFIER
*
* REQUIRED MAPPINGS
*
CVT DSECT=YES
IHAECVT
ATRFZSRV
Example 4 Issue the following request to
remove all interests for resource manager UTRICK from a specific UR:
ATRSRV REQUEST=REMOVINT,URID=MYURID,RMNAME=MYRM
*
* INPUT VALUES
*
MYRM DC CL32'UTRICK' RESOURCE MANAGER NAME
MYURID DC XL16'123456789ABCDEF123456789ABCDEF' UR IDENTIFIER
*
* REQUIRED MAPPINGS
*
CVT DSECT=YES
IHAECVT
ATRFZSRV
Example 5 Issue the following request to
change the state of a single UR from in-doubt to in-backout on system
SY1 in logging group PLEX1: ATRSRV REQUEST=BACKOUT,URID=MYURID,SYSNAME=MYSYS, X
GNAME=MYGROUP
*
* INPUT VALUES
*
MYSYS DC CL8'SY1' SYSTEM NAME
MYGROUP DC CL8'PLEX1' LOGGING GROUP NAME
MYURID DC XL16'123456789ABCDEF123456789ABCDEF' UR IDENTIFIER
*
* REQUIRED MAPPINGS
*
CVT DSECT=YES
IHAECVT
ATRFZSRV
|
z/OS MVS Programming: Resource Recovery
Copyright IBM Corporation 1990, 2014