The following paragraphs describe all the debug options in alphabetical order.

$.BUG Option

(Type: value, Default: FALSE)

<$.BUG option>

          ┌◄────────────── , ─────────────┐
── $.BUG ─┴─┬─<integer>─────────────────┬─┴────────────────────────────┤
            └─<integer>── - ──<integer>─┘

$.BUG specifies SET, RESET, or POP for the $.BUG option as indicated by <integer> or all the $.BUG options indicated by the range<integer>–<integer>. The specific action of each $.BUG option is subject to change and can be found in the BUG DIRECTORY near the beginning of the symbolic.

$.CANDE Option

(Type: Boolean, Default: FALSE)

<$.CANDE option>

── $.CANDE ────────────────────────────────────────────────────────────┤

This option is valid only when you run the PATCH utility interactively from a remote terminal through CANDE. Changing the value of CANDE has no effect when the PATCH utility is initiated through a WFL job. When $.CANDE is TRUE, you can enter text that has sequence numbers by typing the sequence numbers first.

Example

The first group of records is equivalent to the second group in the following example:

 $.CANDE
 $# PATCH 005
 $.SET COMPARE
 500$ SET VOIDT
 01000$ POP VOIDT

 $#PATCH 005
 $.SET COMPARE
 $ SET VOIDT                               00000500
 $ POP VOIDT                               00001000

$.DISCARD Option

(Type: immediate)

<$.DISCARD option>

── $.DISCARD ──────────────────────────────────────────────────────────┤

The $.DISCARD option causes the PATCH utility to close and purge the LINE printer file so that all printer output up to this point is eliminated.

$.END Option

(Type: immediate)

<$.END option>

── $.END ──────────────────────────────────────────────────────────────┤

The $.END option indicates the end of all input to be merged for this particular set of patches. If no errors occur, the PATCH utility then creates the PATCH file and does the COMPARE operation and other optional output functions that have been specified. The utility then starts reading from the primary input file—CARD file or remote file---and expects input for another PATCH utility run. This capability permits multiple patches to be entered in one PATCH utility run. The $.EOF option is used to indicate that no more patches are to follow.

$.EQUATE Option

(Type: special)

<$.EQUATE option>

── $.EQUATE ─┬─ TAPE ────┬─ = ──<file name>────────────────────────────┤
             ├─ PATCH ───┤
             ├─ PATCHES ─┤
             └─ NEWTAPE ─┘

The $.EQUATE option causes the PATCH utility to change the name of one of the four files specified to the name given. An ON <family name> clause cannot be specified with the file name. At least one blank must precede the file name.

This option must be the last option on the $. record. When used with the $.END option, multiple patches can be entered against different pieces of software with different PATCH, PATCHES, and NEWTAPE files created in one PATCH utility run. Separate printer files are created for each run.

If the $.EQUATE option is not used, the PATCH utility looks for a file named TAPE and creates files named PATCH, PATCHES, and NEWTAPE.

SET and RESET context are ignored for the $.EQUATE option.

Example

 $.EQUATE TAPE = MYFILE
 $.EQUATE PATCH = MYFILE/PATCH

$.PDUMP Option

(Type: Boolean, Default: FALSE)

<$.PDUMP option>

── $.PDUMP ────────────────────────────────────────────────────────────┤

If $.PDUMP is TRUE, the PATCH utility performs a program dump when any error is encountered.