Previous Topic: Using Command ProcessingNext Topic: Using Line Commands


ADD PROFILE

Use the ADD PROFILE command to add a profile to CA Datacom Datadictionary. When you do not include the occurrence-name with the command, CA Datacom Datadictionary displays the Add Profile Prompter panel. For more information, see Adding CA Datacom Datadictionary Profiles.

Use the following format for this command:

►►─ ADD ─┬─ PROFILE ─┬─┬────────┬─────────────────────────────────────────────►◄
         └─ PROF ────┘ └─ name ─┘
name

(Optional) The AUTHORIZATION entity-occurrence name of the profile you are adding. The name, if entered, must begin with $DD-.

Valid Entries:

1 to 32 characters

Default Value:

(No default)

APPLY

Use the APPLY command to update CA Datacom Datadictionary with the data entered on a maintenance panel. APPLY is also a valid command from several prompter panels. Use the following format for this command:

►►─┬─ APPLY ─┬────────────────────────────────────────────────────────────────►◄
   └─ APP ───┘

BOTTOM

Enter the BOTTOM command to scroll to the last panel display of a variable panel. You can use this function in all modes. Use the following format for this command:

►►─┬─ BOTTOM ─┬───────────────────────────────────────────────────────────────►◄
   └─ BOT ────┘

CATALOG PROFILE

Use the CATALOG PROFILE command to post the definition of a profile to the CA Datacom Datadictionary High-Speed Directory (HSD). If you do not enter a name, CA Datacom Datadictionary displays the Catalog Profile Prompter panel for you to enter the information. For more information about this panel, see Cataloging Profiles. Use the following format for this command:

►►─┬─ CATALOG ─┬─┬─ PROFILE ─┬─┬─────────────────┬────────────────────────────►◄
   ├─ CAT ─────┤ └─ PROF ────┘ └─ atz-occ-name. ─┘
   └─ CATAL ───┘
atz-occ-name.

(Optional) The AUTHORIZATION entity-occurrence name of the profile you are cataloging. The name, if entered, must begin with $DD-.

Valid Entries:

1 to 32 characters

Default Value:

(No default)

Press PF9 or type APPLY to catalog the profile to the HSD.

If the CATALOG function is successful and no errors are detected, CA Datacom Datadictionary displays the DATACOM/DD Security Maintenance Menu with a message indicating successful completion of this function.

If the CATALOG function fails due to errors, CA Datacom Datadictionary displays an error panel that contains messages that can be used to diagnose the errors in the structure.

COMBINE Command

Use the COMBINE command to terminate the bottom region of a split screen and give its area to the region displayed above it. Do not stack this command with commands that process data, such as the APPLY command.

►►─ COMBINE ──────────────────────────────────────────────────────────────────►◄

DELETE PROFILE

Use the DELETE PROFILE command to delete a profile from CA Datacom Datadictionary. When you do not include the occurrence-name with the command, CA Datacom Datadictionary displays the Delete Profile panel. For information about this panel, see Deleting Profiles.

Use the following format for this command:

►►─┬─ DELETE ─┬─┬─ PROFILE ─┬─┬────────┬──────────────────────────────────────►◄
   └─ DEL ────┘ └─ PROF ────┘ └─ name ─┘
name

(Optional) The AUTHORIZATION entity-occurrence name of the profile you are deleting. The name, if entered, must begin with $DD-.

Valid Entries:

1 to 32 characters

Default Value:

(No default)

DISPLAY DEFINITION PROFILE

Use the DISPLAY DEFINITION PROFILE command to display profile definitions. This function is useful when you need to know how a particular Profile is set up before relating a new PERSON entity-occurrence, or prior to updating the profile definition.

If you omit the optional profile name, CA Datacom Datadictionary displays the Display Definition Prompter panel for you to enter this information. For more information about this panel, see Displaying Profile Definitions.

Use the following format for this command.

►►─┬─ DISPLAY ─┬─┬─ DEFINITION ─┬─┬─ PROFILE ─┬─┬────────┬────────────────────►◄
   ├─ DIS ─────┤ └─ DEF ────────┘ └─ PROF ────┘ └─ name ─┘
   └─ D ───────┘
name

(Optional) The AUTHORIZATION entity-occurrence name of the profile you want to display. The name, if entered, must begin with $DD-.

Valid Entries:

1 to 32 characters

Default Value:

(No default)

When you press Enter, CA Datacom Datadictionary responds with the profile definition requested.

DISPLAY INDEX PROFILE

Use the DISPLAY INDEX PROFILE command to display an index of CA Datacom Datadictionary Security profiles.

Use the following format for this command:

►►─┬─ DISPLAY ─┬─┬─ INDEX ─┬─┬─ PROFILE ─┬────────────────────────────────────►◄
   ├─ DIS ─────┤ ├─ IND ───┤ └─ PROF ────┘
   └─ D ───────┘ └─ I ─────┘

When you press Enter, CA Datacom Datadictionary responds with an index of the profiles defined to the system. You can enter margin commands in the line numbers of the profiles on the panel.

The following are the valid margin commands you can enter on this panel. For more information about using margin commands, see Using the Online Work Queue.

Margin Command

Description

CAT

Catalog a Profile

DDF

Display a Profile Definition

DEL

Delete a Profile

DUS

Display Profile Usage

UPD

Update a Profile

DISPLAY PERSON

Use the DISPLAY PERSON command to display authorization information for one PERSON entity-occurrence and information on the profile to which the PERSON entity-occurrence is related. This function is useful when you need to know the profile authorizations for a particular person.

If you omit the optional PERSON entity-occurrence name, CA Datacom Datadictionary displays the Display Person Prompter panel for you to enter this information. For more information about this panel, see Displaying Person Definitions.

Use the following format for this command:

►►─┬─ DISPLAY ─┬─┬─ PERSON ─┬─┬──────────────────────────┬────────────────────►◄
   ├─ DIS ─────┤ ├─ PER ────┤ └─ entity-occurrence name ─┘
   └─ D ───────┘ └─ PEOPLE ─┘
entity-occurrence name

(Optional) Limit the definition to a single entity-occurrence by entering the name of the entity-occurrence. You can enter ALL for all occurrences or a generic selection using 1 through 31 characters of an occurrence name and an asterisk (*). For example, ACC* processes all occurrences of this entity-type with ACC as the first three characters in the name.

Valid Entries:

1 to 32 characters
Generic selection
ALL

Default Value:

ALL

When you press Enter, CA Datacom Datadictionary responds with the PERSON entity-occurrence definition requested.

DISPLAY USAGE PROFILE

Use the DISPLAY USAGE PROFILE command to display a list of PERSON entity-occurrences assigned a specific profile.

If you omit the optional profile name, CA Datacom Datadictionary displays the Display Usage Prompter panel for you to enter this information. For more information about this panel, see Displaying Profile Usage. Use the following format for this command:

►►─┬─ DISPLAY ─┬─┬─ USAGE ─┬─┬─ PROFILE ─┬─┬────────┬─────────────────────────►◄
   ├─ DIS ─────┤ └─ USE ───┘ └─ PROF ────┘ └─ name ─┘
   └─ D ───────┘
name

(Optional) The AUTHORIZATION entity-occurrence name of the profile you want to display. The entity-occurrence name, if entered, must begin with $DD-.

Valid Entries:

1 to 32 characters

Default Value:

(No default)

When you press Enter, CA Datacom Datadictionary responds with the requested information.

END

Use the END command to terminate processing and return to the menu for the current mode. You can use this command in all processing modes.

►►─ END ──────────────────────────────────────────────────────────────────────►◄

When you press Enter, CA Datacom Datadictionary displays the menu for the current processing mode.

HELP

Use the HELP command to display the current HELP panel. The HELP command is valid in all modes. You can enter the HELP command on any panel. Use the following format for this command:

►►─┬─ HELP ─┬─────────────────────────────────────────────────────────────────►◄
   └─ HEL ──┘

MAINTAIN PERSON

Use the MAINTAIN PERSON command to display a list of PERSON entity-occurrences defined to the system. CA Datacom Datadictionary responds with the Maintain Person panel.

You can add, delete, or change the PERSON entity-occurrence definitions by using line commands or by typing over the information you want to change.

Use the following format for this command:

►►─┬─ MAINTAIN ─┬─┬─ PERSON ─┬────────────────────────────────────────────────►◄
   ├─ MAINT ────┤ ├─ PER ────┤
   └─ MNT ──────┘ └─ PEOPLE ─┘

MARGIN

Use the MARGIN command to display a list of the margin commands you can use to establish an online work queue. For more information, see Using the Online Work Queue.

►►─ MARGIN ───────────────────────────────────────────────────────────────────►◄

NEXT

Use the NEXT command in AUTHORIZE, DBMAINT, and ENTDISPL Modes and for TEXT processing in ENTMAINT Mode to obtain the next entity-occurrence that meets the criteria you specified. Use the following format for this command. You can also issue the NEXT command with the PF11 key.

►►─┬─ NEXT ─┬─────────────────────────────────────────────────────────────────►◄
   └─ NEX ──┘

OFF

Use the OFF command to terminate processing and sign off CA Datacom Datadictionary. This command is valid in all processing modes.

►►─ OFF ──────────────────────────────────────────────────────────────────────►◄

When you press Enter, CA Datacom Datadictionary presents the CA Datacom Datadictionary signoff panel.

OFFON

Enter the OFFON command to sign off CA Datacom Datadictionary and sign on again. This can be helpful when you want to sign on with a different user ID, or when you want to sign on to a different CA Datacom Datadictionary. You can establish specific user IDs for specific levels of authorization to perform specific functions. You can have multiple CA Datacom Datadictionarys at one site.

►►─ OFFON ────────────────────────────────────────────────────────────────────►◄

When you press Enter, CA Datacom Datadictionary presents the CA Datacom Datadictionary signon panel.

If you have entered data on a panel and have not issued the APPLY command, the CA Datacom Datadictionary is not updated and the data is lost. For more information, see Updating CA Datacom Datadictionary.

If you have an uncompleted work queue, it is lost when you sign off. For more information, see Using the Online Work Queue.

PROFILE

Use the PROFILE command to display the Security Profile panel. This panel displays the authorizations assigned to the user identification code with which you signed on to the current session of CA Datacom Datadictionary. For more information about assigning authorizations, see the sections about adding, deleting, updating, and cataloging profiles in this guide.

Use the following format for this command:

►►─┬─ PROFILE ─┬──────────────────────────────────────────────────────────────►◄
   └─ PROF ────┘

When you press Enter, CA Datacom Datadictionary presents a panel similar to the following example. You cannot update the attribute-values on this panel.

 =>  =>  =>  -------------------------------------------------------------------------------  DATADICTIONARY Security Profile                                            PRFH  DISPLAY PERSON: USERNAME                          User-Password: PSWD   User-ID: UID  Profile: $DD-ADM                           Security Admin.: Y  .......................... FACILITY LEVEL SECURITY ..........................  Online Facilities - ( DBM: Y   FMM: Y   ENTM: Y   ENTD: Y   ISF: Y   SQL: Y )  Batch  Facilities - ( UPD: Y   UTL: Y    CFB: Y    BTG: Y   RMF: Y   TRS: Y )  ........................... ENTITY LEVEL SECURITY .............................                                      D A D U  F   R S  V D E C  D T A D  R S S O         Entity              All      i d e p  r T e e  e s n a  e x l e  e e t b                 Status   Functions?  s d l d  m o s t  r a a t  f t s s  l c a s  ====== ========================== T O P =======================================  000001 AREA                  PROD        Y       Y Y Y Y  Y Y Y Y  Y Y Y Y  Y Y Y Y  Y Y Y Y  000002 AUTHORIZATION                  PROD        Y       Y Y Y Y  Y Y Y Y  Y Y Y Y  Y Y Y Y  Y Y Y Y

DISPLAY PERSON:

Specifies the full name associated with the user ID used on the CA Datacom Datadictionary signon panel for this session.

User-Password:

Specifies the password, if any, assigned to this user ID.

User-ID:

Specifies the user identification you accepted or entered on the CA Datacom Datadictionary signon panel for this session. You can have many different user identifications, for example, for different functions.

Profile:

Specifies the entity-occurrence name of the related $DD- AUTHORIZATION entity-occurrence.

Security Admin.:

Indicates with the letter Y (yes) if this user ID is authorized as a CA Datacom Datadictionary Security Administrator (profile $DD-SEC-ADM).

Facility Level Security section

Indicates with the letter Y (yes) that authorization is associated with this user ID to use the following facilities:

ID

Batch Facility

BTG

DDBTGLM maintenance

CFB

DDCFBLD maintenance

RMF

DDRMFLM maintenance

TRS

DDTRSLM maintenance

UPD

DDUPDATE maintenance

UTL

DDUTILTY maintenance

ID

Online Facility

DBM

CA Datacom/DB Structure Maintenance

ENTD

CA Datacom Datadictionary Entity Display

ENTM

CA Datacom Datadictionary Entity Maintenance

FMM

File Structure Maintenance

ISF

Interactive Service Facility

SQL

Interactive SQL Service Facility

Entity Level Security section

Contains a list of the function authorizations associated with this user ID for specific entity-types in a specific status.

Entity

The entity-type name.

Status

The status of the entity-type.

All Functions?

Indicates with the letter Y (yes) or N (no) if all functions are authorized for this entity-type in this status.

Specific Functions

Under the following abbreviations, the letter Y (yes) or N (no) indicates if the function is authorized for this entity-type in this status.

Note: The abbreviations for the functions that can be performed against an entity-type are displayed vertically on the panel.

Heading

Function

Heading

Function

Add

ADD/CREATE

Obs

OBSOLETE

Als

ALIAS maintenance

Rel

RELDEF/TRANSFER

Cat

CATALOG

Res

RESTORE

Def

DEFINE

Sec

PASSWORD/LOCK maintenance

Del

DELETE/REMOVE

Set

SET

Des

DESCRIPTOR maintenance

Sta

STATUS maintenance

Dis

DISPLAY

To

COPY TO

Dsa

DISABLE

Txt

TEXT maintenance

Ena

ENABLE

Upd

UPDATE/MODIFY

Frm

COPY FROM

Ver

VERIFY

SCROLL

Use the SCROLL command to move forward and backward through the lines of a panel that you cannot display all at one time on a single screen. Use the following format for this command.

►►─┬─ SCROLL ─┬─┬───────┬─────────────────────────────────────────────────────►◄
   └─ SCR ────┘ └─ opt ─┘

If you do not add a keyword with the SCROLL command, CA Datacom Datadictionary scrolls the display forward the set number of lines in a region with the last line of the previous display at the top of the new display. You can also enter this command with the PF8 key.

You can add the following optional keywords to the SCROLL command.

Command

Action

+

Scroll forward the set number of lines in a region. (You can also use the PF8 key, the SCROLL command, or the SRF command for this function.)

Scroll backward the set number of lines in a region. (You can also use the PF7 key or the SRB command for this function.)

+nnn

Scroll forward nnn number of lines in a region.

-nnn

Scroll backward nnn number of lines in a region.

B

Scroll backward the set number of lines in a region. (You can also use the PF7 key, the BACKWARD command, the SCROLL - command, or the SRB command for this function.)

F

Scroll forward the set number of lines in a region. (You can also use the PF8 key, the SCROLL command, the SCROLL + command, or the SRF command for this function.)

BOT

Scroll to bottom of the list. (You can also use the BOTTOM command for this function.)

TOP

Scroll to top of the list. (You can also use the TOP command for this function.)

SET

You can use the SET command in different ways depending on the online mode and the keywords used with the command. You can use this function with the appropriate keywords to assign certain default values, environment conditions, or the mode during the current session.

You use the SET DATABASE command to request CA Datacom Datadictionary to assign certain modifiable and nonmodifiable (those set internally by CA Datacom Datadictionary) attribute-values.

Note: For more information about the SET DATABASE command, see the CA Datacom Datadictionary User Guide.

Use the following commands to perform the described action:

SET AUTHID

Displays the AUTHORIZATION-ID Panel in the SQLADMIN function of the Interactive SQL Service Facility. Use the panel to change to a different AUTHID to be used as the default for the session.

Note: For more information about the Interactive SQL Service Facility and AUTHID, see the CA Datacom/DB SQL User Guide.

SET AUTHOR 'name'

Specify the default setting for the AUTHOR attribute when defining entity-occurrences. The name must be enclosed in single quotes.

SET CMD DLM c

Change the command delimiter character, where c is the character. The default delimiter is a semicolon (;).

SET CMD LIN n

Change the number of lines for commands on panels, where n is the number of lines. Valid entries are 0-5. The default is three lines.

SET CMD RPT c

Change the command repeat character, where cis the character. The default is a dash (-).

SET CMD RSW c

Change the command reshow character, where cis the character. The default is a plus sign (+).

SET CMD SEP c

Change the separator character displayed on the line between regions in a split screen, where cis the character. For more information about the default, see the CA IPC documentation.

SET CONTROLLER 'name'

Specify the default setting for the CONTROLLER attribute when defining entity-occurrences. The name must be enclosed in single quotes.

SET DBID = nnnnn

Change to a different CA Datacom Datadictionary with a different CA Datacom/DB database ID than the one specified in the system resource table, where nnnnn is the ID number.

SET LANGUAGE language

Specify the default language to display on a Copybook Display Panel in ENTDISPL or ENTMAINT Modes. The system default is COBOL.

ASM|ASSEMBLER

Specifies the Assembler copybook

COB|COBOL

Specifies the COBOL copybook

DR

Specifies the CA Datacom/DB Reporting Facility copybook

PLI

Specifies the PL/I copybook

SET MODE type

Specify a processing mode, index display format, or text display format. The types and actions are as follows:

AUTH

Transfer to the Security Maintenance Mode.

DBM

Transfer to the CA Datacom/DB Maintenance Mode.

ENTD

Transfer to the Datadictionary Entity Maintenance Mode.

ENTM

Transfer to the Datadictionary Entity Display Mode.

FMM

Transfer to the File Maintenance Mode.

ISF

Transfer to the Interactive Service Facility Mode.

INDEX

Allow CA Datacom Datadictionary to determine the number of lines needed per entry on an index display panel. Two lines are used for FIELD, KEY, and ELEMENT entity-occurrences. One line is used for all other entity-occurrences.

INDEX1

Specify one line per entry on index display panels. This suppresses the display of parent-name for FIELD, KEY and ELEMENT entity-occurrences.

INDEX2

Specify two lines per entry on index display panels. Parent-name is displayed for FIELD, KEY, and ELEMENT entity-occurrences. A blank line follows all other entity-occurrences.

NONUM

Specify text panel lines at 79 characters with no numbered margins.

NUM

Specify the text panel lines at 72 characters with numbered margins.

SQL

Transfer to the SQL Mode.

blank

Return to the Datadictionary Mode Select Panel.

SET NAME name

Establish the default type of value to display for the Field-Name field on a Field Summary Display Panel in the ENTDISPL or ENTMAINT Modes. Enter one of the following for name in this command. The system default is the CA Datacom Datadictionary entity-occurrence name.

ASM|ASSEMBLER

Display the Assembler name.

CMP|COMPILER

Display the Compiler name.

DD|DATADICT

Display the CA Datacom Datadictionary entity-occurrence name.

DESC

Display the FIELD entity-occurrence descriptive information in the DESCRIPTION attribute.

SET SQL syntax-id

Override the syntax level set with the SQLMODE= parameter in the Multi-User Facility Master List or previously changed with this command. The change is valid for the duration of the current session. You cannot change this setting to DATACOM if SQLMODE=ANSI or SQLMODE=FIPS. For an explanation of conformance levels, see the CA Datacom/DB SQL User Guide. Enter one of the following:

ANSI

Conform to ANSI standard.

DATACOM

Conform to CA SQL extension.

FIPS

Conform to FIPS standard.

OFF

Return to default.

SET PREFIX = name

Specify 1 to 15 characters for CA Datacom Datadictionary to add to the beginning of each entity-occurrence name you define on panels in the ENTMAINT Mode. You can terminate your prefix setting with the RESET PREFIX command.

Note: For more information, see CA Datacom Datadictionary Online Reference Guide.

SET TEXT class-name

Specify the default value that CA Datacom Datadictionary will use for the classification name for the text you add to entity-occurrences.

Note: For more information about updating text, see the CA Datacom Datadictionary Online Reference Guide.

The system default is STANDARD.

The name can be up to 32 characters and must follow the CA Datacom Datadictionary naming conventions.

SET WINDOW = nn

Change the number of lines inserted with the INPUT command on a Text Maintenance Panel, where nn is the number of lines (window). The window must be at least 1 and can be a maximum of 2 less than the region size. The default is 5.

SPLIT

Depending on the type of terminal you have, you can use the SPLIT command to present more than one display area at the same time. This allows you to display different CA Datacom Datadictionary panels simultaneously or to access CA Datacom Datadictionary in one area and another product, such as CA Ideal, in the other area.

Note: For more information about this online command, see the CA Datacom Datadictionary Online Reference Guide. You cannot abbreviate this command.

►►─ SPLIT ────────────────────────────────────────────────────────────────────►◄

Use the COMBINE command to terminate the bottom region of a split screen and give its area to the region displayed above it. Do not stack this command with commands that process data, such as the APPLY command.

SRB

Use the SRB command to scroll the display area backward one panel in a region. The PF7 key also performs this function.

►►─ SRB ──────────────────────────────────────────────────────────────────────►◄
SRF

Use the SRF command to scroll the display area forward one panel in a region. The PF8 key also performs this function.

►►─ SRF ──────────────────────────────────────────────────────────────────────►◄
STATUS

Use the STATUS command to display the Datadictionary Session Status Display panel. The panel shows CA Datacom Datadictionary session status and anchored entity-occurrence information.

Note: For the display and description, see the CA Datacom Datadictionary Online Reference Guide.

►►─┬─ STATUS ─┬───────────────────────────────────────────────────────────────►◄
   └─ STA ────┘	
TOP

Use the TOP command to scroll a display area so that line 1 is the first line in the display area.

►►─ TOP ──────────────────────────────────────────────────────────────────────►◄
UPDATE PROFILE

Use the UPDATE PROFILE command to display information for a specific profile. You can display the appropriate Update Profile panel based on the keywords. Add, delete, or change profile information by using line commands or by typing over the information you want to change on these panels.

Use the following format for this command:

►►─┬─ UPDATE ─┬─┬─ PROFILE ─┬─┬────────┬─┬───────────────┬────────────────────►◄
   ├─ UPD ────┤ └─ PROF ────┘ └─ name ─┘ ├─ ENTITY ──────┤
   └─ U ──────┘                          ├─ ENT ─────────┤
                                         └─ entity-type ─┘
name

(Optional) The AUTHORIZATION entity-occurrence name of the profile you are updating. If you enter the entity-occurrence name, CA Datacom Datadictionary displays the Update Profile panel. This panel lists authorizations for facilities and all entity-type/status combinations defined to this profile. For more information about maintaining profile information using this panel, see Updating Profile Entity-Types.

The profile name must begin with $DD-.

Valid Entries:

1 to 32 characters

Default Value:

(No default)

entity-type

(Optional) The entity-type name. If you enter the entity-type name, CA Datacom Datadictionary displays the Update Profile Entity-Type panel that displays Entity Level Security for the specified entity-type. For more information about maintaining profile entity-type information using this panel, see Updating Profile Entity-Types.

Valid Entries:

Valid CA Datacom Datadictionary long name for the entity-type.

Default Value:

(No default)

More information:

Maintaining Persons

Using Line Commands

Updating Profiles