Previous Topic: REALMNAME Keyword—Specify Local and Foreign Realm NameNext Topic: RECORD Keyword—RLP Record Name

Keywords › RECDATA Keyword—RECORD Field Characteristics

RECDATA Keyword—RECORD Field Characteristics

Valid on z/OS, z/VSE, and z/VM.

Use the RECDATA keyword to specify field characteristics associated with a RECORD. Administrators can add, remove, or replace a RECDATA field in the RLP record of the SDT Record.

This keyword has the following format:

TSS ADDTO(SDT) RECORD(rlp‑name)
               RECDATA(field‑definition)
field‑definition

Contains the layout of the field to be masked. You can specify up to five fields on each RLP keyword. Each field‑definition operand consists of four sub‑fields:

fld‑name

Specifies a field name unique to this RLP record. The name can consist of letters, digits, or national characters and can be qualified with periods (.), underscores (_), or hyphens (‑).

Size: Up to 24 characters

type

Indicates the field type. Replace type with one of these values:

  • CHAR. Specifies any of the EBCDIC characters, left‑justified and padded with blanks.
  • BIN. Specifies up to 16 decimal digits with optional sign. If no sign is specified, a positive value is assumed.
  • PACKED. Specifies up to 16 decimal digits with optional sign. If no sign is specified, a positive value is assumed.
  • ZONED. Specifies up to 16 decimal digits with optional sign. If no sign is specified, a positive value is assumed.
  • HEX. Specifies up to 256 hexadecimal digits (0‑F) left‑justified and padded with nulls (X"00").
offset

Specifies a five‑digit initial position (relative to 1) of the data field.

length

(Optional) Specifies the length of the data field. If the length field is omitted, it indicates a length large enough to include the rest of the record.

Size: Up to 44 characters

This keyword is used with:

Examples: RECDATA keyword

This example adds a RECDATA field to the RLP record PROLL1 that contains a name field in character format called NAME, having an offset of 20 and a length of 30 characters:

TSS ADDTO(SDT) RECORD(PROLL1)
               RECDATA(NAME,CHAR,20,30)

This example replaces an existing record with one new field

TSS REPLACE(SDT) RECORD(PROLL1)
                 RECDATA(NAME,CHAR,20,15).

Even though only one field's worth of data is entered with the REPLACE syntax, all previously entered fields are replaced by the single field entered in the REPLACE command. If the RLP record consists of seven fields, all seven original fields are lost and one new field replaces them. There is no command to replace a single field.