ZAP VVDS PATCH

Use the ZAP VVDS PATCH command to alter a VVDS record or the contents of a VVDS control interval.

Purpose

Read syntax diagramSkip visual syntax diagramZAPVVDS(SYS1.VVDS.V volservolser)PatCH(RBA(X'00000000')RBA(X' rba')VVDS-RECTYPE(*NQZ)Control-Interval(0n)CoMPonent(keyX' key')KRQ( annn)VVDS-RECTYPE(*NQZ)REP(, displmnt,C' value',X' value')VER(, displmnt,C' value',X' value')EXECuteSIMulateCouNT(1)CouNT(1ALLn)Print-AfterPrint-Before)

Keywords

VVDS
specifies the volume serial of the VVDS.
RBA
specifies the relative byte address of a specific record. The RBA is a four byte hexadecimal value. Specify the full value using 2-for-1 notation. For example, 0001C000.
CONTROL-INTERVAL
specifies the number of the CI to be processed.
COMPONENT
specifies a fully qualified or masked object name to be located within the VVR and NVR records maintained in the VVDS. Please remember that this will be the component name, not cluster, for VSAM objects. You can specify the component name as:
  • A space-delimited character string. For example, SYS1.LINKLIB.
  • A delimited character string. For example, C'SYS1.LINKLIB'.
  • A delimited hexadecimal string. For example, X'E2E8E2F14BD3C9D5D2D3C9C2'.
KRQ
specifies the key range qualifier suffix value that was appended to the component's data set name as a result of the DEFINE command KEYRANGE parameter. The value is in the format A001, A002, and so on. The ZAP command will append this value to the specified COMPONENT name as a compare value on the component name search.
VVDS-RECTYPE
specifies the particular VVDS record type to be processed. You must specify one of the following values:
  • * - Any VVDS record type. This is the default.
  • N - Non-VSAM (NVR) record.
  • Q - Secondary VSAM (VVR) record.
  • Z - Primary VSAM (VVR) record.
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 or control interval. 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 or control interval. 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.
COUNT
specifies the number of records that are to be processed.
  • 1 - process one record. This is the default.
  • ALL - process all remaining records. If COMPONENT or CONTROL-INTERVAL is also specified, ALL indicates that all records from that point onwards will be processed.
  • n - process the specified number of records. You can specify an integer from 1 to 99999999.
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 ZAP VVDS PATCH processes a record, an SMF type 60 record should be cut. This will allow RECOVER BCS or RECOVER VVDS to capture those changes in a forward recovery. These records can also be used in reporting and auditing.
  • Do not attempt to update the Data Component VVR of a catalog that is in an ECS-Active state. Otherwise, PATCH updates the DASD version of that VVR, and any changes made by ZAP are regressed by the VVR version residing the SYSIGGCAS_ECS structure in the Coupling Facility when the catalog is taken out of ECS mode. To make permanent changes to the Data Component VVR of an ECS catalog, the catalog must first be removed from ECS.