Use Commands in the Status and Graphical Monitors

Using Monitors › Use Commands in the Status and Graphical Monitors

Use Commands in the Status and Graphical Monitors

You can issue commands to perform various actions from the monitors, depending on your authority level.

Use the ? command to find a short list of commands (ShortLst) available for the selected resource. For descriptions of the commands, press F1 (Help).

Use the ?? command to find a full list of commands (FullList) available for the selected resource. For descriptions of the commands, press F1 (Help).

Note: While displaying a list of commands, you can press F4 to toggle between the full list and the short list.

Find Out More About Monitored Services and Resources

Use the D command to display information about the selected services or resources.

Use the B or S command to display information about the current and defined states, and the operation mode of selected services and resources. If necessary, you can override the current operation mode and state.

Note: You can also use commands to override the operation mode and the states.

Remove the User-defined Extended Display

If the last columns of a display are overwritten by an extended display and you want to view the original information in those columns, use the EDR command. The command removes the extended display temporarily. The extended display re-appears on the next update of the status.

Notes:

Enter the EXTDISP {OFF|ON} command at the prompt to turn the extended display on or off for all the resources. The setting stays for the duration of the session.
If you want to retain the setting across sessions, specify the setting in your monitor profile.

Access Extended Functions

Use the XF command to access any extended functions provided.

Reply to a WTOR Message

When the status indicates that there are outstanding write-to-operator with reply (WTOR) messages waiting to be replied to, enter W beside the resource. A Command Entry panel appears listing the WTOR messages.

To reply to a WTOR message

Issue the following command at the SYSCMD prompt:
```
REPLY wtor-id,reply-text
```

Browse or Update the Definition of Monitored Services and Resources

Use the DB command to browse selected service and resource definitions. Users with the appropriate authority can also update the definitions. The update is effective immediately. For example, you may need to add a new status monitor message.

Important: Resources of the INTNL class with names in the forms DT(*), ET(*), SE(*), and ST(*) are dynamic APPC resources that provide communications between regions. These resources are defined only for the duration of the APPC link. Some products also use dynamic resources of the form xx(*). Do not change these resource definitions.

Note: You can use the F4 (Add) function key or the ADD primary command to add definitions to and the DEL command to delete definitions from the knowledge base. For more information, see help.

Override the Operation Mode

The following commands enable you to modify the operation mode of selected services and resources:

Use the MA command to set the operation mode to AUTOMATED. The region takes control of the affected service or resource.
Note: If the global operation mode is MANUAL, the mode cannot change even though the AUTOMATED override is applied. A G in the Ovr column indicates this condition.
Use the MS command to set the operation mode to AUTOMATED. When the affected service or resource achieves desired state, the mode is set to MANUAL.
Use the MI command to set the operation mode to IGNORED. This mode is the same as the MANUAL mode except that the logical state of the affected service or resource is always set to OK. Use this mode if you are not interested in the state of the service or resource.
Use the MM command to set the operation mode to MANUAL. The region relinquishes control of but continues to monitor the affected service or resource.
Use the MR command to remove the override.

On the status monitor, an M in the Ovr column identifies a service or resource as having an operation mode override.

Override the Service and Resource States

You can override the actual state and the desired state of selected services and resources.

Override the Actual State

Override the actual state only if you believe that the displayed state is wrong. The following commands enable you to modify the actual state of selected services and resources:

Use the ASA command to set the actual state to ACTIVE.
Use the ASD command to set the actual state to DEGRADED.
Use the ASF command to set the actual state to FAILED.
Use the ASI command to set the actual state to INACTIVE.
Use the ASU command to set the actual state to UNKNOWN to recheck the status.

Override the Desired State

The following commands enable you to modify the desired state of selected services and resources:

Use the DSA command to set the desired state to ACTIVE.
Use the DSI command to set the desired state to INACTIVE. If you enter DSI beside a resource or service that has the SVC override flag, a panel is displayed listing the services that might be affected by the action.
Use the DSR command to remove the override.

On the status monitor, a DSA, DSI, G/D, or M/D, in the Ovr column identifies a service or resource as having a desired state override.

If you set the desired state of a service to ACTIVE, then when the service is started (either through automation or by you manually), the service places an ACTIVE desired state override on its members. On the status monitor, an SVC in the Ovr column identifies a service or resource as having a desired state override imposed on it by a service. Similarly, if you set the desired state of a service to INACTIVE, then when the service is stopped, the service removes the ACTIVE desired state override from its members.

Modify the Scheduled Operations Changes for a Monitored Item

Scheduled changes in the operation of a service or resource are defined in an availability map. An availability map defines the desired service or resource status at specific times. If a service or resource is attached to the map and is in the AUTOMATED operation mode, the region will try to ensure that the actual status of the service or resource matches the desired status defined in the map. More than one service or resource can use the same map.

You can modify those changes in one of the following ways:

Create a map to override any existing requirements.
Update the attached map. This action, however, also modifies the behavior of other services and resources attached to the map.

Override the Scheduled Operations Changes

Use an overriding map when you want to modify the behavior of a service or resource for a defined period of time only.

Enter MPO to create an overriding map that specifies your new requirements. You must specify the map expiry date and time, and the map is deleted automatically at the specified date and time. The scheduled operations changes then revert back to what were specified originally.

You can revert the scheduled operations changes back to what were specified originally, at any time. To do this, enter MPR. The command replaces the overriding map by the original map. The command does not, however, delete the overriding map.

Once the map is created, it is available for use by other services and resources. (To attach an overriding map to another service or resource, specify the name of the map in the appropriate definition. You can update the definition by using the DB command from your monitor or through the Definition menus.)

Browse or Update Maps

Important! Updating a map affects the operation of all services or resources attached to the map.

Use the MAP command to browse the map for selected service and resource definitions. Users with the appropriate authority can use the MAP command to update maps to which selected services and resources are attached. The update is effective immediately.

Control Manual Services and Resources

You have direct control over services and resources that are in the MANUAL or IGNORED operation mode. That is, you can start and stop manual services and resources. You can use these modes of operation when automatic error recovery fails.

Note: For a resource, these operations use the methods specified in the definition for that resource, provided that you have not registered commands that override the supplied commands.

Start Manual Services and Resources

You can start selected services and resources manually. For example, you may want to restart a resource after recovering it from a failure. Ensure that the operation mode of the service or resource you want to start is MANUAL or IGNORED. Use the A command to start the services and resources. A message appears prompting you for confirmation. Press Enter to confirm the action. The actual state changes to ACTIVE if the service or resource starts successfully.

Stop Manual Services and Resources Normally

You can stop selected services and resources manually. For example, you might want to stop a resource because its status is degrading and you want to take it out of service. Ensure that the operation mode of the service or resource you want to stop is MANUAL or IGNORED. Use the T command to stop the services and resources. A message appears prompting you for confirmation. Press Enter to confirm the action. The actual state changes to INACTIVE if the service or resource stops successfully.

Stop Manual Resources by Force

You can stop selected resources manually by force. For example, in an emergency, you want to stop a resource quickly. The normal stop process can take some time to complete. Ensure that the operation mode of the resource you want to stop is MANUAL or IGNORED. Use the TF command to stop the resources. A message appears prompting you for confirmation. Press Enter to confirm the action. The actual state changes to INACTIVE when the resource has stopped.