Modify Nodes Screen
Use the Modify Nodes screen to Quiesce or Resume processing for all nodes or specified nodes. (To access the Modify Nodes screen, follow Steps 1 through 3 in Suspending or Resuming Processing on Nodes through the Modify Nodes Screen.) You can also use the Modify Nodes screen to modify debug and trace settings for all nodes or specific nodes. See Modify Trace and Debug Settings Through the Modify Nodes Screen for more information.
CMD Commands
CMD commands are entered in the CMD input field. Unknown commands and syntax errors will result in error messages. CMD commands operate on all nodes in the node table, not just the rows that are currently being displayed.
The CMD input field accepts the following commands:
CMD | Description |
---|---|
CANCEL | Unconditionally exits the Modify Nodes screen, discarding any changes. You can abbreviate CANCEL to CAN, CANC or CANCE. |
END | Exits the Modify Nodes screen if there are no unsaved changes outstanding. If there are unsaved changes, the END command causes the dialog to issue an error message and redisplay the ISPF table. |
SAVE | Commits all changes en masse to the DTF. It then gets a new copy of the node table from the DTF. Also, all the ISPF table change indicators are cleared. |
CLEAR nodename | Clears the quiesce and debug settings for the
rows with a matching node name. It is equivalent to doing both a DEBUG
OFF and a RESUME against the node name. The nodename operand can have any number of * or ? wildcard characters in any position. |
DEBUG nodename ON debug-bits | Turns on debugging and completely replaces the
Debug setting with the debug-bits operand for the rows with a matching
node name. This overrides the global DEBUG setting for the individual
nodes. 00000000 is a valid debug-bits value and is not the same as
DEBUG OFF. The nodename operand can have any number of * or ? wildcard characters in any position. |
DEBUG nodename OFF | Turns off debugging and blanks out the debug setting
for the rows with a matching nodename. This allows the nodes to revert
to using the global DEBUG setting. The nodename operand can have any number of * or ? wildcard characters in any position. |
DEBUG nodename BITSON debug-bits | Turns on the bits in the debug-bits operand without
changing any other bits in the row's debug setting, but only if the
rows with a matching node name have a non-blank debug setting. It
does not turn debugging on or off. Though 00000000 is a valid debug-bits
value, if it is specified in DEBUG BITSON, the command has no effect. The nodename operand can have any number of * or ? wildcard characters in any position. |
DEBUG nodename BITSOFF debug-bits | Turns off the bits in the debug-bits operand without
changing any other bits in the row's debug setting, but only if the
rows with a matching node name have a non-blank debug setting. It
does not turn debugging on or off. Though 00000000 is a valid debug-bits
value, if it is specified in DEBUG BITSOFF, the command has no effect. The nodename operand can have any number of * or ? wildcard characters in any position. |
QUIESCE nodename | Turns the Quiesce setting on for the rows with
a matching nodename. See the CLEAR command above for the description
of the nodename operand. The nodename operand can have any number of * or ? wildcard characters in any position. |
REFRESH | Discards any pending changes and gets a new copy of the node table from the DTF. It is the equivalent of doing a CANCEL, and then reentering the dialog. |
RESUME nodename | Turns the Quiesce setting off for the rows with
a matching nodename. See the CLEAR command above for the description
of the nodename operand. The nodename operand can have any number of * or ? wildcard characters in any position. |
TRACE nodename BITSOFF debug-bits | TRACE is an alias of DEBUG. They have the same syntax and can be used interchangeably. |
SEL commands are entered in the SEL input field for each row. Change the Debug field on each row by overtyping. You can update as many rows as are displayed when you press Enter.
The SEL input field accepts the following line commands:
- C - Clear all settings for the node (same as Debug OFF plus RESUME)
- Q - Quiesce the node (turn Quiesce ON)
- R - Resume the node (turn Quiesce OFF)
Type over the Debug field in any row to change its value. The Debug field accepts the same debug bits as the DEBUG command. Blanking out the Debug field in a row is equivalent to issuing a DEBUG OFF on that nodename.
If you change the Debug field to a non-blank value in a specific row, issue a CMD command for the same row, and press Enter, only the CMD command will take effect.
If you enter a CMD command and one or more SEL commands, when you press Enter, the SEL commands are processed before the CMD command.
Node Table Processing
When you issue a CMD command, a SEL command, or change the Debug field, the node table is not updated until you enter the SAVE command. Until then, MODIFY commands generated by these actions are stacked in first-in-first-out (FIFO) order in a MODIFY command queue.
You can enter a SAVE command only if one or more nodes are flagged as changed. If you change a node and then change it back before you issue the SAVE command, the change flag is cleared. If you back out all node changes, the MODIFY command queue is cleared. However, if any rows remain flagged as changed, SAVE sends all MODIFY commands queued since the last time there were no changed rows.
If multiple IUI users work on a copy of the node table simultaneously, it can be difficult to determine what changes are in effect. If you suspect that another user has changed the node table, discard your changes and retrieve a fresh copy of the node table by issuing the REFRESH command.