RESET (NCCF)

Syntax

The RESET command ends the command or command procedure that is running.

NORMAL: Causes the NetView® program to stop the active command or command procedure at the next breakpoint even if work remains to be done. NORMAL is the default.
RESET NORMAL might not work for a command that has no breakpoint. You might have to use RESET IMMED instead.
DUMP: Causes the same processing as IMMED. Additionally, a memory dump is requested.
IMMED: Causes the system to end the command immediately, the NetView program issues user abend 257. All currently active command procedures, NetView components, cross-domain sessions, and TAF sessions are ended on the task being RESET. Spans are not affected. If the task has not exceeded the MAXABEND count (specified in the CNMSTYLE member), the task is reinstated and processing of queued and new commands continues. If the abend causes the reinstate count of the task to exceed MAXABEND, the task is ended. The MAXABEND count for a task will be reset to zero if the task has run for at least 1 hour since the last abend.

The following usage notes apply to the RESET command:

If you issue RESET NORMAL and no command or command procedure is active, no message is issued.
If you send the RESET IMMED or RESET DUMP command from an NNT/OST cross-domain session to the other domain using the ROUTE command, the cross-domain session ends. This does not apply to RMTCMD cross-domain sessions.
RESET IMMED closes any open files (for example, EXECIO files) that are associated with your operator station task (OST). If you are using a function that runs partially under your OST and partially under a data services task (DST), the associated DST (for example, the session monitor or hardware monitor) is not affected by the RESET command. Data returned from the DST is discarded or ignored because any correlation data kept under the OST has been lost. Because the OST part of the function has dropped correlation, it can send duplicate requests to the DST and cause problems in the DST part of the function. If an error occurs while the system is attempting to close any open files, messages indicating the error are sent to the system operator's console.
You cannot retrieve RESET IMMED and RESET DUMP using the RETRIEVE command. You can retrieve RESET or RESET NORMAL.

The following usage notes are for high-level language (HLL):

If a command procedure is cancelable, it behaves according to the rules specified above. A command procedure ends at its next breakpoint whenever RESET NORMAL is issued. A breakpoint occurs in an HLL command procedure whenever an HLL service routine is invoked.
If the command procedure is not cancelable, it is reset only when RESET IMMED or RESET DUMP is issued. If you issue RESET NORMAL, the command procedure might or might not be reset. When an HLL command procedure is defined as not cancelable, the system programmer can determine what action is taken when RESET NORMAL is issued. Because the system programmer has control over not cancelable command procedures, the RESET command can appear to behave erratically to a NetView operator. The following results can occur when RESET NORMAL is issued:
- The command procedure might or might not be reset.
- A long delay can result before the command procedure is reset.
- If the command procedure is reset, the operator gets a NetView cancelation message (CNM982E) for each command procedure that is canceled. This includes command procedures that were called from within the command procedure invoked by the operator.

For more detail on how HLL command procedures respond to the RESET command, see IBM Z® NetView Programming: PL/I and C.

To end the command or command procedure that is currently running, enter:

RESET

Response

The following message is displayed only if a command or command list is running; otherwise, there is no response.

DSI052I   command COMMAND SELF-TERMINATED BY OPERATOR REQUEST

Note: Message CNM982E is displayed for an HLL command procedure.

The normal responses to RESET IMMED or RESET DUMP are these messages:

DSI131I  COMMANDS ABENDED BY RESET COMMAND.  STATION HAS BEEN RESET.
DSI172I  SUBTASK OPER1 ABENDED WITH CODE X'000101'