Online Commands › UPDATE

UPDATE

Use the UPDATE command to perform a variety of maintenance functions on an occurrence. For more information about the command to update a universal field, see the section about maintaining UNIVERSAL fields in the CA Datacom Datadictionary User Guide.

Use the following format for this command:

Note: If your completed command exceeds the 76 spaces available in one command line, use the prompter panel to issue the command.

►►─┬─ UPDATE ─┬─ entity1 ─┬───────────────────┬─ / ─ entity, ─────────────────►
   └─ UPD ────┘           └─ USING ─ entity2 ─┘

 ►─┬─ rec-name. ─┬─ occ-name ─┬─────────────────────────────┬─ / ─────────────►
   └─ tbl-name. ─┘            └─ (vrs ─┬─ ,pswd,ovrd ─┬─ ) ─┘
                                       ├─ ,pswd ──────┤
                                       └─ ,,ovrd ─────┘

 ►─┬──────────────────────┬───────────────────────────────────────────────────►◄
   └─ CLASS ─ class-name ─┘

entity1

(Required) Specify the type of update to perform.

Valid Entries:

ALIAS|ALI
ATTRIBUTE|ATT
DESCRIPTOR|DES
FIELD|FIEL
LOCK|LOC
NAME|NAM
PASSWORD|PAS
RELATIONSHIP|REL
STATUS|STA
TEXT|TEX

Default Value:

(No default)

Important: If you update an attribute that changes the physical layout or length of the record, see the section about modifying definitions in CA Datacom Datadictionary, in the CA Datacom/DB Database and System Administration Guide.

entity2

(Optional) Specify the selection process for the command. You can qualify the selection process with an alias or descriptor name of 1 to 32 characters or by a standard path. For more information about additional options available, see Using the Selection Criteria Fill-in Panel.

Valid Entries:

ALIAS name

DESCRIPTOR name

PATH STANDARD

Default Value:

(No default)

/entity

(Required) Specify the entity of the occurrence to update. You cannot use abbreviations for the entities in this entry.

Valid Entries:

An existing entity

Default Value:

ALL

rec-name. or tbl-name.

Only required if the entity is FIELD, KEY, or ELEMENT. The occurrence name of the RECORD or TABLE that contains this occurrence.

Valid Entries:

1- to 32-character RECORD or TABLE occurrence name

Default Value:

ALL

occ-name

(Required) Specify the name of the occurrence on which to anchor the UPDATE function. You can enter ALL to select all occurrences or use a generic selection of one or more of the initial characters of the name with an asterisk (*) to select several occurrences. For example, PAY* processes all occurrences of this entity-type with PAY as the first three characters in the name.

Valid Entries:

1- to 32-character occurrence name
Generic selection
ALL

Default Value:

ALL

vrs

Use this field to limit your selection to a specific status or version.

Valid Entries:

1—999

TEST

ALL

Default Value:

ALL

,pswd

Only required if this occurrence has protection against unauthorized maintenance with a password assignment. Supply the password for this occurrence. If you omit the password but specify an override code, the preceding comma is required as a delimiter.

Valid Entries:

1- to 4-character password

Default Value:

(No default)

,,ovrd

Only required if this occurrence is restricted from unauthorized maintenance or retrieval with a lock level assignment. Supply the override code.

Valid Entries:

1- to 4-character override code

Default Value:

(No default)

class-name

(Optional) For text maintenance only. If you enter the CLASS keyword, specify the text classification you want to update.

Valid Entries:

1- to 32-character text classification for the occurrence

Default Value:

(No default)

When you press Enter, CA Datacom Datadictionary presents the appropriate panel for the type of update you requested. For more information, see the sections starting with Update Occurrences.