RESET-Return codes
Return codes for the TOMEXEC RESET function
Return code | Explanation |
|---|---|
0 | Command was completed successfully. |
8 | OBJECT(‘name’) or SET(‘name’) does not exist. |
16 | Syntax error occurred. |
17 | FUNCTION keyword is missing. |
36 | Unable to obtain object edit enqueue. |
40 | Object is being started, stopped, or bounced by the local system; request rejected. |
44 | Dependency loop detected. |
52 | Unable to refresh child records |
100 | No active TOMs meet your criteria. |
101 | Internal error occurred. |
102 | TOM is not active. |
103 | Internal error occurred. |
104 | Invalid command submitted for a remote sysplex. |
105 | Command is invalid because of an inactive definition base. |
113 | RESETOPT() keyword is missing. |
118 | Security violation occurred. |
122 | OBJECT('name') or SET('name') is a model, cannot reset a model. |
130 | Definition base or sysplex specified in the function does not exist. |
131 | The DEFBASE() keyword was also specified with SCOPE() keyword. |
132 | The OBJECT() or SET() keyword was specified with RESETOPT values CNTLMODE or IPLOCCUR. |
133 | The DEFBASE() keyword was specified with one of the following RESETOPT values ABENDCT, FORCED, INFLIGHT, STARTCMDCT, STATUS, RUNSTAT, OPER, or SUSPEND. |
135 | More than one of the following keywords was specified: OBJECT, SET, or DEFBASE. |
136 | None of the following keywords were specified: OBJECT, SET, or DEFBASE. |
140 | Function is invalid |
141 | Valid SCOPE value was not specified. |
142 | Internal error occurred. |
144 | TOM CAS is not active. |
145 | RTCS is not active. |
147 | NOTE('operator note') keyword is missing and MAMINIxx parameter OPER_NOTE_REQUIRED is set to YES. |
148 | Request timed out and can be re-tried. |
| 153 | RESETOPT value invalid. |
210 | The requested TOMID or TOMPLEX is not TOM version 2.x and is not compatible with this version. |
The following two tables list the effects of the SCOPE parameter when it is used with the RESET command and how it affects the current object status, the STOP-ORDER specification, and the dependency strength.
Legend of additional conditions
Legend value | Description |
|---|---|
A | Selected object or set has children objects |
B | The child object is stopped |
C | The child object is LOCKED, BLOCKED, or SUSPENDED |
D | Selected object has parent objects |
E | The parent object is stopped |
F | The parent object is LOCKED, BLOCKED, or SUSPENDED |
G (can be strong or weak) | Child-parent dependency strength |
H (can be strong or weak) | Parent strength |
I | When RESETOPT=(ALL) |
J | When SCOPE=(ALL) |
K | When SCOPE=(PARENT) |
L | When SCOPE=(CHILDREN) |
M | When STOP-ORDER=BOTTOMTOTOP |
N | When STOP-ORDER=TOPTOBOTTOM |
The following shows the status of objects under multiple conditions with the RESET command is used with the SCOPE parameter. You must usethe information in the Legend of additional conditions table in conjunction with the table Matrix showing the effects of the RESET command when used with the SCOPE parameter.
Matrix showing the effects of the RESET command when used with the SCOPE parameter
When the following is true | Plus the additional conditions (from the Legend of additional conditions table) | Resulting status |
|---|---|---|
Reset object or set is in STOPPED, LOCKED, or BLOCKED status | A, B, I, J | The selected object or set and the children objects are reset. The selected object or set and the children objects are restarted if dependency and schedule criteria are met. |
Reset object is in STOPPED, LOCKED, or BLOCKED status | D, E, I, J | The parent and the selected object are reset. The parent and the selected object are restarted if dependency and schedule criteria are met. |
Reset object is in STOPPED, LOCKED, or BLOCKED status | A, B, D, E, I, J | The parent, selected object and the children objects are reset. The parent, selected object, and the child are restarted if dependency and schedule criteria are met. |
Reset object or set is in STOPPED, LOCKED, or, BLOCKED status | A, B, I, K | The selected object or set is reset. The selected object/set and the children objects are restarted if dependency and schedule criteria are met. |
Reset object is in STOPPED, LOCKED, or BLOCKED status | D, E, I, K | The parent and the selected object are reset. The parent and the selected object are restarted if dependency and schedule criteria are met. |
Reset object is in STOPPED, LOCKED, or BLOCKED status | A, B, D, E, I, K | The parent and the selected object are reset. The parent, the selected object and the child are restarted if dependency and schedule criteria are met. |
Reset object or set is in STOPPED, LOCKED, or BLOCKED status | A, B, I, L | The selected object or set and the children objects are reset. The selected object or set and the children objects are restarted if dependency and schedule criteria are met. |
Reset object is in STOPPED, LOCKED, or BLOCKED status | D, E, I, L, | The parent and the selected object are reset. The selected object is restarted if dependency and schedule criteria are met. (the parent wont be affected) |
Reset object is in STOPPED, LOCKED, or BLOCKED status | A, B, D, E, I, L, | The selected object and the children objects are reset. The selected object and the children objects are restarted if dependency and schedule criteria are met. (the parent is not affected) |
Reset object or set is in STOPPED, LOCKED, or BLOCKED status | A, C, I, J | The selected object or set and the children objects are reset. The selected object or set and the children objects are restarted if dependency and schedule criteria are met. |
Reset object is in STOPPED, LOCKED, or BLOCKED status | D, F, I, J | The parent and the selected object are reset. The parent and the selected object are restarted if dependency and schedule criteria are met. |
Reset object is in STOPPED, LOCKED, or BLOCKED status | A, C, D, F, I, J | The parent, selected object and the children objects are reset. The parent, selected object, and the child are restarted if dependency and schedule criteria are met. |
Reset object or set is in STOPPED, LOCKED, or BLOCKED status | A, C, I, K | The selected object or set is reset. The selected object or set is restarted if dependency and schedule criteria are met. The child will not restart because it was not reset. |
Reset object is in STOPPED, LOCKED, or BLOCKED status | D, F, I, K | The parent and the selected object are reset. The parent and the selected object are restarted if dependency and schedule criteria are met. |
Reset object is in STOPPED, LOCKED, or BLOCKED status | A, C, D, F, I, K | The parent and the selected object are reset. The parent, the selected object are restarted. The child is not restarted because it was not reset. |
Reset object or set is in STOPPED, LOCKED, or BLOCKED status | A, C, I, L | The selected object or set the child object are reset. The selected object or set and the children objects are restarted if dependency and schedule criteria are met. |
Reset object is in STOPPED, LOCKED, or BLOCKED status | D, F, I, L | The selected object is reset. The selected object is restarted if dependency and schedule criteria are met. (the parent wont be affected) |
Reset object or set is in STOPPED, LOCKED, or BLOCKED status | A, B, D, F, I, J | The parent, the selected object and the children objects are reset. The parent, selected object, and the child are restarted if dependency and schedule criteria are met. |
Reset object or set is in STOPPED, LOCKED, or BLOCKED status | A. B, D, F, I, K | The parent and the selected object are reset. The parent selected object and the child are restarted if dependency and schedule criteria are met. |
Reset object or set is in STOPPED, LOCKED, or BLOCKED status | A, B, D, F, I, L | The selected object or set the child object are reset. The selected object or set and the children objects are restarted if dependency and schedule criteria are met. The parent is not affected. |
Reset object or set is in STOPPED, LOCKED, or BLOCKED status | A, C, D, E, I, J | The parent, selected object and the child are reset. The parent, selected object, and the child are restarted if dependency and schedule criteria are met. |
Reset object or set is in STOPPED, LOCKED, or BLOCKED status | A, C, D, E, I, K | The parent and the selected object are reset. The parent and the selected object are restarted if dependency and schedule criteria are met. The child is not affected. |
Reset object or set is in STOPPED, LOCKED, or BLOCKED status | A, C, D, E, I, L | The selected object or set and the children objects are reset. The selected object or set and the children objects are restarted if dependency and schedule criteria are met. The parent is not affected. |
Reset object in STOPPED, LOCKED, or BLOCKED status | A, C, D, F, I, L | The selected object and the children objects are reset. The selected object and the children objects are restarted if dependency and schedule criteria are met. (the parent is not affected) |
Issue stop command against an object or set in ACTIVE status | A, G (strong), M | The children objects are stopped beginning with the bottom of the dependency structure. When all of the immediate children objects of the selected object/set are stopped it is stopped. |
Issue stop command against an object in ACTIVE status | D, H (strong), M | The selected object is stopped, the parent is not affected. |
Issue stop command against an object in ACTIVE status | A, D, G (strong), H (strong), M | The children objects are stopped beginning with the bottom of the dependency structure. When all of the immediate children objects of the selected object are stopped the selected object will be stopped, the parent is not affected. |
Issue stop command against an object or set in ACTIVE status | A, G (strong),N | The selected object or set is stopped immediately. When evaluation occurs, the immediate children objects are stopped. This continues until all of the descendents of the selected object or set have stopped. |
Issue stop command against an object in ACTIVE status | D, H (strong), N | The selected object is stopped, the parent is not affected. |
Issue stop command against an object in ACTIVE status | A, D, G (strong), H (strong), N | The selected object is stopped. When evaluation occurs, the immediate children objects are stopped. This continues until all of the descendents of the selected object have stopped. The parent is not affected. |
Issue stop command against an object or set in ACTIVE status | A, G (weak), M | The children objects is not stopped. the selected object or set is stopped immediately. |
Issue stop command against an object in ACTIVE status | D, H (weak), M | The selected object is stopped, the parent is not affected. |
Issue stop command against an object in ACTIVE status | A, D, G (weak),H (weak),M | The selected object is stopped, the children objects is not stopped, and the parent is not affected. |
Issue stop command against an object or set in ACTIVE status | A, G (weak),N | The selected object or set is stopped immediately. The child is not stopped. |
Issue stop command against an object in ACTIVE status | D,H (weak),N | The selected object is stopped, the parent is not affected. |
Issue stop command against an object in ACTIVE status | A, D, G (weak), H (weak), N | The selected object is stopped, the child is not stopped, and The parent is not affected. |
Issue stop command against an object in ACTIVE status | A, D, G (strong), H (weak), M | The children objects are stopped beginning with the bottom of the dependency structure. When all of the immediate children objects of the selected object are stopped the selected object will be stopped, the parent is not affected. |
Issue stop command against an object in ACTIVE status | A, D, G (weak), H (strong), M | The selected object will be stopped, the parent is not affected, and the children objects will stay active. |
Issue stop command against an object in ACTIVE status | A, D, G (weak), H (strong), N | The selected object will be stopped, the parent is not affected, and the children objects will stay active. |
Issue stop command against an object in ACTIVE status | A, D, G (strong), H (weak), N | The selected object is stopped. When evaluation occurs, the immediate children objects are stopped. This continues until all of the descendents of the selected object have stopped. The parent is not affected. |
Issue stop command against an object in ACTIVE status | A, M | The children objects are stopped beginning with the bottom of the dependency structure. When all of the immediate children objects of the selected object or set are stopped, it is stopped. |
Issue stop command against an object in ACTIVE status | A, G (strong), H (strong), M | The children objects are stopped beginning with the bottom of the dependency structure. When all of the immediate children objects of the selected object or set are stopped, it is stopped. |
Issue stop command against an object or set in ACTIVE status | A, G (strong), H (weak), M | The children objects are stopped beginning with the bottom of the dependency structure. When all of the immediate children objects of the selected object or set are stopped, it is stopped. |
Issue stop command against an object or set in ACTIVE status | A, G (weak), H (strong), M | The selected object or set is stopped immediately. The child is not stopped. |
Issue stop command against an object or set in ACTIVE status | A, G (weak), H (weak), M | The selected object or set is stopped immediately. The child is not stopped. |
Issue stop command against an object in ACTIVE status | A, D, M | The children objects are stopped beginning with the bottom of the dependency structure. When all of the immediate children objects of the selected object or set are stopped, it is stopped. The parent is not affected. |
Issue stop command against an object in ACTIVE status | A, D, G (strong), M | The children objects are stopped beginning with the bottom of the dependency structure. When all of the immediate children objects of the selected object or set are stopped, it is stopped. The parent is not affected. |
Issue stop command against an object in ACTIVE status | A, D, G (weak), M | The selected object is stopped immediately, The child is not stopped and the parent is not affected. |
Issue stop command against an object or set in ACTIVE status | A, N | The selected object or set is stopped immediately. When evaluation occurs, the immediate children objects are stopped. This continues until all of the descendents of the selected object or set have stopped. |
Issue stop command against an object or set in ACTIVE status | A, G (strong), H (strong), N | The selected object or set is stopped immediately. When evaluation occurs, the immediate children objects are stopped. This continues until all of the descendents of the selected object or set have stopped. |
Issue stop command against an object or set in ACTIVE status | A, G (strong), H (weak), N | The selected object or set is stopped immediately. When evaluation occurs, the immediate children objects are stopped. This continues until all of the descendents of the selected object or set have stopped. |
Issue stop command against an object or set in ACTIVE status | A, G (weak), H (strong), N | The selected object or set is stopped immediately. The child is not stopped. |
Issue stop command against an object or set in ACTIVE status | A, G (weak), H (weak), N | The selected object is stopped immediately, The child is not stopped. |
Issue stop command against an object in ACTIVE status | A, D, N | The selected object is stopped immediately. When evaluation occurs, the immediate children objects are stopped. This continues until all of the descendents of the selected object have stopped. The parent is not affected. |
Issue stop command against an object in ACTIVE status | A, D, G (strong), N | The selected object is stopped immediately. When evaluation occurs, the immediate children objects are stopped. This continues until all of the descendents of the selected object have stopped. The parent is not affected. |
Issue stop command against an object in ACTIVE status | A, D, G (weak), N | The selected object or set is stopped immediately, The child is not stopped, and the parent is not affected. |
Issue stop command against an object in ACTIVE status | D, M | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (strong), M | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (weak), M | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (strong), H (strong), M | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (strong), H (weak), M | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (weak), H (strong), M | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (weak), H (weak), M | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, N | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (strong), N | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (weak), N | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (strong), H (strong), N | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (strong), H (weak), N | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (weak), H (strong), N | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object in ACTIVE status | D, G (weak), H (weak), N | The selected object is stopped and its parent object or set stayed active. |
Issue stop command against an object or set in ACTIVE status | A, H (strong), M | All of the children objects will be stopped first the selected object will be stopped. |
Issue stop command against an object or set in ACTIVE status | A, H (weak), M | The selected object will be stopped but its children objects object(s) will remain active. |
Issue stop command against an object in ACTIVE status | A, D,H (strong), M | All of the children objects will be stopped first the selected object will be stopped but the status of the parent object is not changed. |
Issue stop command against an object in ACTIVE status | A, D,H (weak), M | The selected object will be stopped. Its children objects and parent objects are not affected. |
Issue stop command against an object or set in ACTIVE status | A, H (strong), N | The selected object is stopped immediately. When evaluation occurs, the immediate children objects are stopped. This continues until all of the descendents of the selected object have stopped. |
Issue stop command against an object or set in ACTIVE status | A, H (weak), N | The selected object or set is stopped immediately. The child is not stopped. |
Issue stop command against an object in ACTIVE status | A, D, H (strong), N | The selected object is stopped immediately. When evaluation occurs, the immediate children objects are stopped. This continues until all of the descendents of the selected object have stopped. The parent is not affected. |
Issue stop command against an object in ACTIVE status | A, D, H (weak), N | The selected object or set is stopped immediately, The child is not stopped, and the parent is not affected. |
Comments
Log in or register to comment.