Previous Topic: Delete FIELD OccurrencesNext Topic: Update Name


Update Lock

Use the UPDATE LOCK option to assign a lock level to restrict access to an occurrence. You can use one level to restrict updates to an occurrence and another level to restrict both updates and display of the occurrence. CA Datacom Datadictionary provides the following three levels of lock instructions:

0

Applies no maintenance restrictions to an occurrence.

1

Restricts an occurrence from updates or deletion unless the override code is specified at the time the function request is issued. You can copy, display, or print an occurrence with a LOCK1 assignment without specifying the override code.

2

Restricts any action to the occurrence unless you specify the override code in the function request. This restriction includes copying, updating, deleting, displaying, or printing the occurrence.

Do not update lock levels for occurrences maintained by other CA products unless specifically documented by the product.

How to Use

When you select the UPDATE LOCK option in ENTMAINT Mode, you receive the following Selection Criteria Fill-in panel:

=> => => 1-DDOL000196A - CMPP - PLEASE COMPLETE REQUIRED INFORMATION FOR COMMAND

----------------------------------------------------------------------------- DDOL Entity Maintenance Selection Criteria Fill-in T01F ...................optional.............................. UPDATE LOCK : using _ ________________________________ : UPD LOC : using (A-alias) (alias name) : : (D-descr) (descriptor name) : : (P-path) (STANDARD) (S-Sqlname) : :.......................................................: / ________________________________ , ________________________________ . (entity-type) (parent occurrence-name) ________________________________ ( ____ , , ) / (occurrence-name) (stat, pswd, ovrd) (vers, pswd, ovrd) PF1=HELP PF2=END PF3=CLARIFY PF4=PROCESS PF5=MENU PF6=STATUS PF7=SCB PF8=SCF PF9=APPLY PF10=PATH PF11=NEXT PF12=INPUT

Complete your specifications on the Selection Criteria Fill-in panel according to the following descriptions. Use the optional criteria box with the DISPLAY function only.

(entity-type)

Specify the entity of the occurrence you are updating. You cannot use abbreviations in this field.

Valid Entries:

An existing entity-type

Default Value:

(No default)

(parent occurrence-name)

When the entity you are selecting is FIELD, KEY, or ELEMENT, you can enter the name of a TABLE or RECORD occurrence in this field to limit your selection to the occurrences contained in a single table or record.

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.

When you leave this field blank, CA Datacom Datadictionary uses the occurrence that meets the other selection criteria you enter on this panel. For more information about how CA Datacom Datadictionary returns occurrences, see the CA Datacom Datadictionary User Guide.

Valid Entries:

1- to 32-character RECORD or TABLE occurrence name

Generic selection

ALL

Default Value:

The name of the first RECORD or TABLE occurrence that meets the other selection criteria

(occurrence-name)

Limit the selection to a specific occurrence by entering the name of the occurrence.

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.

When you leave this field blank, CA Datacom Datadictionary returns the occurrence or occurrences that meet the other selection criteria you enter on this panel. For more information about how CA Datacom Datadictionary returns occurrences, see the CA Datacom Datadictionary User Guide.

Valid Entries:

1- to 32-character occurrence name

Generic selection

ALL

Default Value:

The name of the first occurrence that meets the other selection criteria

(stat, or vers,)

Specify the status or version of the occurrence you are updating. When you leave this field blank, CA Datacom Datadictionary uses the status/version from the list below of the occurrence that meets the other selection criteria you enter on this panel. For more information about how CA Datacom Datadictionary returns occurrences, see the CA Datacom Datadictionary User Guide.

Valid Entries:

TEST
T001—T999
PROD
001—999
ALL

Default Value:

The status/version of the first occurrence that meets the other selection criteria

pswd,

Supply the password for this occurrence if this occurrence has password protection against unauthorized maintenance.

Valid Entries:

1- to 4-character password

Default Value:

(No default)

(ovrd)

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

Valid Entries:

1- to 4-character override code

Default Value:

(No default)

After completing your entries, press Enter. If there are no errors, CA Datacom Datadictionary displays a Lock Code Change panel similar to the following:

=> => => ----------------------------------------------------------------------------- DDOL: ANCHORED OCCURRENCE FOR LOCK CODE CHANGE TYPE OCCURRENCE STA VER JOB SAMPLE-JOB T 001 --------------------------------------------------------------------------T15U DDOL Entity Occurrence Maintenance Occurrence Lock Code Change 1. Enter new lock code: _ Valid entries: 0 - unrestricted 1 - restrict update 2 - restrict display and update 2. Issue 'APPLY' command or press PF9 key to change the status. PF1=HELP PF2=END PF3=CLARIFY PF4=PROCESS PF5=MENU PF6=STATUS PF7=SCB PF8=SCF PF9=APPLY PF10=PATH PF11=NEXT PF12=INPUT

This panel displays one field where you can enter the lock level you are assigning to the anchored occurrence.

Enter new lock code:

Specify the desired lock code.

Valid Entries:

0, 1, 2

Default Value:

0

After completing your entries, press PF9 (APPLY). If there are no errors, CA Datacom Datadictionary displays the Function Select panel with a message confirming successful completion of the function.