ZAP VTOC PATCH

Use the ZAP VTOC PATCH command to alter one or more DSCBs from a VTOC.

Some fields such as EXTENTS will not be processed by this command.

Syntax

Read syntax diagramSkip visual syntax diagramZAPVTOC( volser)PatCH(CCHHR( cccchhhhrr)REP(, displmnt,C' value',X' value')VER(, displmnt,C' value',X' value')EXECuteSIMulatePrint-AfterPrint-Before)

ZAP VTOC PATCH Command Syntax

Keywords

VTOC
specifies a six character volume serial to process.
CCHHR
specifies a particular VTOC record to be processed. Specify a maximum of 10 hexadecimal characters for cccchhhhrr.
REP
specifies that you want to change the existing record contents. You must specify values in pairs, enclosed in parentheses, and separated by commas. The maximum length of the value of REP is 256 (512 characters of 2-for-1 notation).
  • displmnt—a hex offset, relative to the start of a record. It must be either 2, 4, or 6 hexadecimal characters. The displacement values must be in ascending order.
  • C'value' or X'value'—a character format or hexadecimal format. The length of the value compared is determined by the actual specification.
VER
specifies that you want to verify the existing record contents. You must specify values in pairs, enclosed in parentheses, and separated by commas. The maximum length of the value of VER is 256 (512 characters of 2-for-1 notation).
  • displmnt—a hex offset, relative to the start of a record. It must be either 2, 4, or 6 hexadecimal characters. The displacement values must be in ascending order.
  • C'value' or X'value'—a character format or hexadecimal format. The length of the value compared is determined by the actual specification.
Note: Record fields such as type codes, flag bytes, and so on could easily test true at an offset other than the one intended or in a record or control interval other than the one intended. Therefore, it is recommended that multiple areas be compared, for added insurance that the desired record/control interval field is, in fact, altered.
EXECUTE
indicates that you want run the command.
SIMULATE
indicates that you want to trial the command without actually performing it.
PRINT-AFTER
specifies that you want the record to be printed after any changes are made.
PRINT-BEFORE
specifies that you want the record to be printed before any changes are made.

Usage notes

  • If multiple VER keyword pairs are specified then all verifies must be true in order to perform a REP. Multiple REP pairs can be specified and do not have to match the number and displacements in the VER keyword.