ZAP BCS PRINT

Syntax

Path A

Path B

Path C

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.

DUMP

specifies that the records are shown in 16 bytes per line in hexadecimal and limited EBCDIC. The names of cells are not identified.

CELLDUMP

specifies that the records are shown in 16 bytes per line in hexadecimal and limited EBCDIC. The names of cells are identified, but not individual fields.

FORMAT

specifies that individual fields are included with field descriptions.

FATAL-READ-ERROR

controls what happens when a serious read error is encountered when processing the input object. Fatal errors are caused by anomalies in the VSAM structure. For example, a spanned record is maintained in two or more control intervals; if the update number in these control intervals is not synchronized, attempts to read the record will fail.

• ERROR - issues an error message and terminates with a return code of 8.
• WARNING - issues a warning message and continues with a return code of 4.

CONTROL-INTERVAL

specifies the number of the CI to be processed. Entire control intervals will be printed.

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 a one byte value via two hexadecimal characters. 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.

KEY-ONLY

specifies that only the key content is printed.

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 RBA, CONTROL-INTERVAL, or a non-masked KEY is also specified, ALL indicates that all records from that point forward are processed. If a masked KEY is specified, ALL indicates that all records matching the mask are processed.
• n - process the specified number of records. You can specify an integer from 1 to 99999999.

Usage notes

1. The ZAP will fail if a SPANNED record is encountered, RBA('00000000') is specified or left to default, and COUNT(ALL) is specified.
2. If the COUNT keyword specifies a value greater than 1, the KEY or RBA keyword 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.