This section contains the return codes and reason codes of the roll server requests. Unlike Natural system messages, the explanatory long texts to these messages and codes are only available in this document, not online.
The teleprocessing interfaces issuling roll server request interpret some reason codes returned by a failed roll server request and issue specific error messages. Other reason codes, however, are not interpreted. These are reported with a more general error message text.
Decimal | Explanation |
---|---|
0
|
Normal completion. |
4 |
Wait for disk I/O completion. |
8
|
Wait and resume this call. |
12
|
Error, see reason code. |
16
|
Abnormal end. |
20
|
Recursive abend. |
28
|
Roll server not active. |
32
|
GETMAIN failed for work area.
|
36
|
Request block is write protected. |
Hex | Dec | Function Type | Explanation |
---|---|---|---|
04
|
04
|
ALLOC
|
The roll file is full.
Action: Increase and reformat the roll file. Note: Please read carefully the constraints regarding reformatting the roll file described in the roll server documentation. |
08
|
08
|
All except STATS
|
An abend was intercepted and a SNAP dump was taken.
Action: Contact Software AG Support. |
0C
|
12
|
ALLOC
|
The roll file number returned by the user exit
NATRSU14 is invalid.
Action: Correct the user exit. |
10
|
16
|
FREE
|
The roll file number passed by the requestor in the request
block is invalid.
Possible reason: The request block has been overwritten since the last successfully executed roll server function. Action: Contact Software AG Support. |
14
|
20
|
FREE
|
The number of the roll file slot passed by the requestor in the
request block is invalid.
Possible reason: The request block has been overwritten since the last successfully executed roll server function. Action: Contact Software AG Support. |
18
|
24
|
FREE
|
There is no allocated roll file slot for the user with the
identification passed by the requestor in the request block.
Possible reason: The request block has been overwritten since the last successfully executed roll server function. Action: Contact Software AG Support. |
1C
|
28
|
READ
|
The size of the compressed Natural thread presented
(WRITE ) or requested
(READ ) is zero.
Possible reason: The request block has been overwritten since the last successfully executed roll server function. Action: Contact Software AG Support. |
20
|
32
|
READ
|
The size of the compressed Natural thread is greater than the
maximum roll file slot.
Possible reasons: Action: Increase the roll file. |
24
|
36
|
READ
|
An internal control block used for inter-task communication
could not be allocated.
Action: Increase the amount of available space for the roll server address space. If the problem persists, contact Software AG Support. |
28
|
40
|
READ
|
An intermediate buffer for an asynchronous
READ /WRITE request could
not be allocated.
Action: Increase the amount of available space for the roll server address space. If the problem persists, contact Software AG Support. |
2C
|
44
|
READ
|
The size of the compressed Natural thread requested is not
equal to the size used on the preceding WRITE
request.
Possible reason: The request block has been overwritten since the last successfully executed roll server function. Action: Contact Software AG Support. |
30
|
48
|
READ
|
An abend was intercepted and a SNAP dump issued in the roll
server's address space.
Action: Contact Software AG Support |
34
|
52
|
READ
|
The READ -task could not allocate the
intermediate buffer.
Action: Increase the amount of available space for the roll server address space. If the problem persists, contact Software AG Support. |
38
|
56
|
READ
|
The address of the Natural thread is not specified in the
request block.
Possible reason: The request block has been overwritten since the last successfully executed roll server function. Action: Contact Software AG Support. |
3C
|
60
|
FREE
|
The pointer to the directory entry in the request block is
invalid.
Possible reason: The request block has been overwritten since the last successfully executed roll server function. Action: Contact Software AG Support. |
40
|
64
|
READ
|
The roll server init timestamp specified in the request block
is zero.
Possible reason: The request block has been overwritten since the last successfully executed roll server function. Action: Contact Software AG Support. |
44
|
68
|
All | Sysplex Services for Data Sharing (XES) returned an unexpected
reason code. The XES reason code is returned by the roll server in the request
answer area (label RSPAXRNC ).
Action: Please refer to the documentation Sysplex Services Reference for the detailed reason and proposed actions. If the reason does not depend on system definitions, contact Software AG Support. |
48
|
72
|
All | The connection to the Coupling Facility was lost.
Possible reason: Hardware or system software problem. Action: Contact the z/OS system administration. |
4C
|
76
|
All | The Coupling Facility structure failed.
Possible Reasons: Hardware or system software problem (Contact IBM Support) Action: Stop the roll server, deallocate the coupling facility structure and reformat the roll file. |
50
|
80
|
READ
|
The previous WRITE request executed
on a different z/OS image was not successfully completed due to a Coupling
Facility problem or a roll server problem.
Action: Look at the message logs of the roll servers participating in the Sysplex for messages indicating this situation. |
54
|
84
|
FREE
|
The entry for the specific user could not be located in the
Coupling Facility structure.
Possible reason: The request block has been overwritten since the last successfully executed roll server function. Action: Contact Software AG Support. |
58
|
88
|
READ
|
A wait-queue element could not be allocated.
Action: Increase the amount of available space for the roll server address space. If the problem persists, contact Software AG Support. |
5C
|
92
|
READ
|
The information contained in the specific entry of the Coupling
Facility structure indicates that there was no previous
WRITE request.
Action: Contact Software AG Support. |
60
|
96
|
DEALLOC
|
The length of the generic user ID is smaller than 1 or greater
than 16.
Action: Contact Software AG Support. |
64
|
100
|
|
The receiving storage area provided by the caller is
write-protected.
Action: Contact Software AG Support. |
68
|
104
|
|
The ECB referenced in the request block is not aligned or is
write-protected.
Action: Contact Software AG Support. |
70 |
112 |
All |
A session requested a roll file slot with an invalid user ID.
Action: Contact Software AG Support. |
74 |
116 |
|
A session presented a Roll Server request with an invalid
timestamp.
Action: Contact Software AG Support. |
104 - 13C |
260 - 316 |
All | Internal error.
Action: Contact Software AG Support. |