ZAP BCS DELETE

Use the ZAP BCS DELETE command to delete one or more records or control intervals in a BCS record.

Syntax

Read syntax diagramSkip visual syntax diagramZAP BCS( bcs)DELete(RBA(X'00000000')RBA(X' rba')Control-Interval(0n)INDeX-ComponentKEY(bcskeyC' bcskey'X' bcskey')EXTension(0X' nn'nn)VER(,displmnt, C' value', X' value')EXECuteSIMulateCouNT(1)CouNT(1ALLn)Print-Before)

ZAP BCS DELETE Command Syntax

Keywords

BCS
specifies the fully qualified data set name of the BCS you want to process.
RBA
specifies the relative byte address of a specific record. Please note that the RBA of VRRDS and KSDS (and BCS) records may change. The RBA is a four byte hexadecimal value. Specify the full value using 2-for-1 notation. For example, 0001C000. Because RBA access is physical, not keyed, when this keyword is specified for a keyed object, and the COUNT keyword requests multiple records, those records returned may not be in logical key sequence.
CONTROL-INTERVAL
specifies the number of the CI to be processed. The contents of an entire control interval will be deleted.
INDEX-COMPONENT
specifies that the Index Component of the catalog will be processed. The default component to be processed is the data component unless you specify the INDEX-COMPONENT keyword.
KEY
specifies a value of up to 45 bytes for the required catalog record's key. If the specified key value is only 44 bytes, ZAP will automatically add a byte value of X'00', assuming you want to process the first record for a VSAM cluster or GDG sphere record.
You can enter the key value as a mask or in one of the following formats:
  • 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'.
If a record with the specified key value is not located, processing begins with the next record in the BCS.
EXTENSION
specifies a particular extension record for a BCS record that has been identified by the KEY specification. Specify an even number of bytes in hexadecimal format. The value may or may not be enclosed in X'…'. For example, EXT(x'01') or EXT(01) are valid, but EXT(x'1') or EXT(1) are not valid.
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 hex).
  • displmnt—a hex offset, relative to the start of a record or control interval. It must be an even number of bytes of 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 1 record. This is the default if COUNT is not specified.
  • ALL—process all remaining records. If KEY, RBA or CONTROL-INTERVAL is also specified, ALL results in all records from that point onwards to be processed. If KEY, RBA, or CONTROL-INTERVAL is not specified, ALL processes all records in the entire BCS.
  • n—process the specified number of records. You can specify an integer from 1 to 99999999.
PRINT-BEFORE
specifies that you want the record to be printed before any changes are made.

Usage notes

  1. If ZAP BCS DELETE deletes a record, an SMF type 65 record should be cut. This will allow RECOVER BCS or RECOVER VVDS to capture these changes in a forward recovery. These records can also be used in reporting and auditing.
  2. The ZAP will fail if a SPANNED record is encountered, RBA('00000000') is specified or left to default, and COUNT(ALL) is specified.
  3. If the COUNT parameter specifies a value greater than 1, the KEY or RBA parameter indicates the record or control interval at which processing is to begin. It continues from that location in ascending key sequence for KEY or physically sequential for RBA.