RESET-Return codes

The following table shows the possible values for TOMRC and what they mean.

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.

153RESETOPT 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

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.

Was this page helpful? Yes No Submitting... Thank you

Comments