Maintaining Special Security Records › FDT Record › FDT Record Data › Define Data to the FDT Record

Define Data to the FDT Record

Use the ADDTO command to add new fields to the FDT.

To define a new field to the FDT, enter the command:

TSS ADDTO(FDT) FDTNAME(field‑name) 
               FDTCODE(hex‑code)
               MAXLEN(nn)
               DISPLAY(display‑name)
               [SEGMENT(segment‑name)] 
               [ATTR(MIXED)][(NONDISP)][(NOXTRPRP)][(XTRPRP)]

FDTNAME

Adds user‑defined field to the FDT Record when FDT is the target ACID name, and allows one field‑name per command that can be a letter, number, or national characters (@, #, $).

Range: 1 to 8 characters

FDTCODE

Adds a user‑defined hex‑code to the FDT Record when FDT is the target name, and allows one hex‑code per command.

Range: 01 to FF

SEGMENT

Assigns an field to a specific segment, and allows one segment‑name per command that can be a letter, number, or special character. You cannot add user‑defined fields to predefined segments. The following are predefined CA Top Secret segments:

ALL, BASE, CICS, DFP, DLFDATA, IMS, LANGUAGE, OPERPARM, TSO, WORKATTR, z/OS.

A new segment is defined by specifying a unique value when adding a new field. If the value specified for a segment already exists, a new field is added to that segment. If the segment name is not specified the field is added to the base segment.

Range: Up to eight‑character.

MAXLEN

Defines the number of bytes that can be entered for the user‑defined FDT entries, and allows one MAXLEN value per command. The total of all user‑defined fields should not exceed 32,767 bytes.

DISPLAY

Defines a display‑name with its associated defined field and segment in the FDT Record, and allows one display‑name per command that can be a letter, number, or special character. The display‑name must be enclosed in single quotes if it contains blanks.

Range: 1 to 11 characters

ATTR

Specifies attributes in effect. One or more of the following operands may be specified with the ATTR keyword:

MIXED

Displays field in mixed case format. If you do not specify MIXED, the display defaults to uppercase.

NONDISP

The field is not displayed by an administrator using a TSS LIST function on the ACID. The data can be extracted and/or modified as normal using the Application Interface or the RACROUTE macro. If you do not specify NONDISP, the field displays.

NOXTRPRP

Prohibits successful extract/replace call results for the field from being sent to the recovery file and propagated to other systems. You can change this attribute via a “TSS REPLACE” command for user-defined fields in the FDT and pre-defined fields in the FDT where CA did not already include this attribute.

XTRPRP

Allows successful extract/replace call results for the field to be sent to the recovery file and propagated to other systems. This attribute does not display when you list the field. You can change this attribute via a “TSS REPLACE” command for user-defined fields in the FDT and pre-defined fields in the FDT where CA did not already include this attribute or NOXTRPRP.

Example: define a new FDT field

This example creates an area code and home phone field called HPHONE that belong to a segment named HPHNATTR and a display called HPHNUM. The maximum length for the field is 12 bytes and has a hex‑code of 01:

TSS ADDTO(FDT) FDTNAME(HPHONE) 
               FDTCODE(01)
               SEGMENT(HPHNATTR)
               MAXLEN(12)
               DISPLAY(HPHNUM)

This example adds the contents of this area code and home phone field to its respective owner:

TSS ADDTO(USER01) HPHONE(‘908 780 5550’)

Use single quotes when the field contains blanks.