CA IDMS Reference 19.0

PDF
English

Conducting a Menu Facility Session

An IDD menu facility session begins when you invoke the IDD menu facility at the ENTER NEXT TASK CODE system prompt. The session ends when you exit the menu facility and returns control to the system.
idmscu19
An IDD menu facility session begins when you invoke the IDD menu facility at the ENTER NEXT TASK CODE system prompt. The session ends when you exit the menu facility and returns control to the system.
To conduct a menu facility session, you should understand the following activities:
Beginning a Session
To begin an IDD menu facility session:
  1. Sign on to the system.
  2. Enter the task code that invokes the menu facility. The installation default is IDDM. The menu facility displays the
    Master Selection
     screen.
  3. Sign on to the menu facility by using one of the following methods:
    • Press the ENTER key. The menu facility automatically accepts the signon information.
    • Explicitly provide the appropriate information and press ENTER.
      This method must be used in the following situations:
      • IDD has been used to establish security for the dictionary to be accessed by the menu facility. You must identify the user name and, optionally, a password. The identified user must have been assigned IDMS-DC authority through the AUTHORITY clause of the USER statement (see USER).
      • A DDS user needs to specify the node name of the central version that controls the dictionary to be accessed by the menu facility.
      • You want to access a dictionary other than the default dictionary.
      • You want to override the default usage mode (shared update) in which the DDDL compiler is to access the dictionary.
After the menu facility confirms a successful signon, you can establish session-specific processing options by selecting the
Session Options
 screen. To select this screen, either type the screen name OPTI in the command area of the Master Selection screen or type any nonblank character in the appropriate field in the screen selection area.
More information: For more information about each processing option offered on the Session Options screen, see SET OPTIONS Statement. For additional information about requesting screens, see Navigating Screens.
Navigating Screens
The IDD menu facility consists of the
Master Selection
 screen and
subordinate screens
 arranged in a hierarchical structure. To implement a definition in the dictionary, you must navigate through the menu facility, choosing the next screen.
Screen Descriptions
The following table shows the names of screens and what can be done from each screen.
Screen
Description
Master Selection screen
This screen is at the top of the IDD menu facility structure. From the Master Selection screen, you can:
Transfer to an Entity screen to process a definition
Transfer to the Session Options screen or the Display All screen
Press CLEAR to terminate the session
Entity screens
These screens identify the entity type and occurrence to be defined. From an Entity screen, you can:
Transfer to a subordinate screen to further define the entity occurrence
Transfer to another Entity screen to begin another definition
Go back to the Master Selection screen
Subordinate screens
These screens complete the entity-occurrence definition. From a subordinate screen, you can:
Transfer to a lower level subordinate screen to further define the entity occurrence
Transfer to any screen on the same level within the entity occurrence
Return to a higher level screen within the same entity occurrence
Return back to the current Entity screen or to any other Entity screen to begin another definition
More information: For more information on screens, see Descriptions of IDD Menu Facility Screens later in this section.
Selecting Screens
You can select screens using any of the following methods:
  • Enter any character at the underscore that immediately precedes a screen name listed in the
    screen selection area
     and press ENTER.
  • Enter a screen name in the
    command area
     and press ENTER.
  • Press the appropriate
    global or local control key
    .
  • Type the PF-key number in the
    simulated PF-key field
     and press ENTER.
  • Press CLEAR to return to the prior screen.
    Returning to the prior screen by pressing CLEAR does not process changes on the current screen. To apply any changes to the definition, be sure to press ENTER before pressing CLEAR.
Considerations for entering a screen name
The following considerations apply when you enter a screen name to select the next screen:
  • You can request an entity screen by typing the DDDL entity type, rather than the screen name. For example, to access the RECD screen, you can type RECORD in the command area. The alternatives are listed as follows:
Screen name
DDDL Entity-type name
ATTR
ATTRIBUTE
CLAS
CLASS
ELEM
ELEMENT
FILE
FILE
MSGS
MESSAGE
MODU
MODULE
PROC
PROCESS
PROG
PROGRAM
QFIL
QFILE
RECD
RECORD
SYST
SYSTEM
TABL
TABLE
USER
USER
ENTY
Not applicable
  • To eliminate keystrokes when selecting an entity occurrence, you can do either of the following:
    • Type only the first three letters of the screen name or the DDDL entity type. Certain screens, such as PROC or PROG, must be invoked using the first
      four
       letters to ensure accuracy. For example, to request the Message Entity screen, type MSG in the command area.
    • Type the screen name or DDDL entity type followed by the name of the entity occurrence. For example, to display the DENTAL-CLAIM record, you type REC DENTAL-CLAIM in the command area.
      The entity-occurrence name consists of one parameter; version number or other qualifiers are not acceptable. When more than one entity occurrence exists in the dictionary, the menu facility displays the default version number of the requested occurrence.
Displaying Entity Occurrences
To display an entity occurrence previously defined in the dictionary:
  1. Request the appropriate Entity screen.
  2. Enter the entity-occurrence name (and version number, if appropriate).
  3. Press ENTER.
The default verb is DISPLAY. The menu facility automatically recognizes the request, displays the definition on the Entity screen, and returns a confirmation message on the message line. You can request subordinate screens to display the complete entity-occurrence definition.
Adding Entity Occurrences
To add a new entity-occurrence definition to the dictionary:
  1. Request the appropriate Entity screen.
  2. Enter the entity-occurrence name (and version number, if appropriate).
  3. Type a nonblank character at the underscore that immediately precedes the ADD literal.
  4. Press ENTER.
The menu facility automatically recognizes that the ADD request overrides the default DISPLAY request, submits the syntax to the DDDL compiler, and returns a message confirming that the definition has been added to the dictionary.
You can continue to define the entity occurrence by requesting subordinate screens. The menu facility automatically updates the new entity-occurrence definition in the dictionary when you request a subordinate screen and/or press ENTER.
Modifying Entity Occurrences
To modify an entity occurrence previously defined in the dictionary:
  1. Request the appropriate Entity screen.
  2. Enter the entity-occurrence name (and version number, if appropriate).
  3. Press ENTER to display the occurrence to be modified.
    For example, to modify a record called CUST-REC, the user first displays the occurrence by requesting the Record Entity screen and typing in the record name CUST-REC.
  4. Choose one of the following actions:
    • If the information to be modified is located
      on the Entity screen
      : change the information, type a nonblank character at the underscore that immediately precedes the MODIFY literal, and press ENTER.
    • If the information to be modified is located
      on a subordinate screen
      , transfer to the screen that contains the information to be modified and submit the changes.
Updating relationships between entity occurrences
On some subordinate screens (for example, the User Registration screen), you can update relationships between the named entity occurrence and other entity occurrences:
  • To
    replace
     one relationship with another, you can type the new definition over the obsolete definition.
  • To
    delete
     or
    disassociate
     a definition from the named occurrence, you can display the obsolete definition, then perform one of the following procedures:
    • Erase, space over, or blank out the related occurrence name and press ENTER.
    • Type a nonblank character at the underscore that immediately precedes the EXCLUDE option of the appropriate definition and press ENTER.
Deleting Entity Occurrences
To delete an entity occurrence previously defined in the dictionary:
  1. Request the appropriate Entity screen.
  2. Enter the name (and version number, if appropriate) of the entity occurrence to be deleted.
  3. Type a nonblank character at the underscore that immediately precedes the DELETE verb.
  4. Press ENTER.
The menu facility automatically recognizes the request, deletes the definition from the dictionary, and returns a confirmation message that the occurrence has been deleted.
Terminating a Session
To end an IDD menu facility session and return control to system, you can choose one of the following methods:
  • Type a DDDL signoff command (SIGNOFF, BYE, END, or LOGOFF) in the command area and press ENTER.
  • Type TOP in the command area and press ENTER to return to the Master Selection screen. Press the CLEAR key.
  • Press CLEAR as many times as needed to move through the menu facility structure, through the Master Selection screen, and back to the system.