Sample Session

A sample session that illustrates the use of the menu facility is presented below. During this session, you request the menu facility to display a list of ELEMENT entity occurrences, then chooses one entity occurrence for display.

Each step of the session is described and illustrated by the current screen. Default values for response fields (indicated by underscores) are listed when applicable.

Beginning a Menu Facility Session

To begin an IDD menu facility session:

Sign on to the system.
When signon is accepted, type the task code IDDM to invoke the IDD menu facility and display the Master Selection screen.
Press ENTER to sign on to the IDD menu facility, using the system signon information. The menu facility returns a message that indicates a successful signon.

                                            CA
      IDD REL nn.n              *** MASTER SELECTION ***               TOP
 ─►
                          SIGNON TO IDD WAS SUCCESSFUL

             DICTIONARY NAME...:             NODE NAME..:

             USER NAME.........:
             PASSWORD..........:

             USAGE MODE........:X UPDATE   _ RETRIEVAL

             PFKEY SIMULATION..:X OFF      _ ON


_ ATTR  =  ATTRIBUTE     <PF2>       _ PROC  =  PROCESS    <PF3>
_ CLAS  =  CLASS         <PF4>       _ PROG  =  PROGRAM    <PF5>
_ ELEM  =  ELEMENT       <PF6>       _ RECD  =  RECORD     <PF7>
_ FILE  =  FILE          <PF8>       _ TABL  =  TABLE      <PF9>
_ MODU  =  MODULE        <PF10>      _ USER  =  USER       <PF11>
_ ENTL  =  USER DEFINED ENTITY LIST  _ SYST  =  SYSTEM
_ MSGS  =  MESSAGE
_ QFIL  =  QFILE                     _ OPTI  =  OPTIONS
_ DISP  =  DISPLAY ALL               _ HELP  =  HELP       <PF1>

Displaying a List of Entity Occurrences

To display a list of entity occurrences, you type a character next to DISPLAY ALL in the screen selection area and press ENTER:

                                         CA
      IDD REL nn.n              *** MASTER SELECTION ***               TOP
 ─►
                          SIGNON TO IDD WAS SUCCESSFUL

             DICTIONARY NAME...:             NODE NAME..:

             USER NAME.........:
             PASSWORD..........:

             USAGE MODE........:X UPDATE   _ RETRIEVAL

             PFKEY SIMULATION..:X OFF      _ ON


_ ATTR  =  ATTRIBUTE     <PF2>         _ PROC  =  PROCESS <PF3>
_ CLAS  =  CLASS         <PF4>         _ PROG  =  PROGRAM <PF5>
_ ELEM  =  ELEMENT       <PF6>         _ RECD  =  RECORD  <PF7>
_ FILE  =  FILE          <PF8>         _ TABL  =  TABLE   <PF9>
_ MODU  =  MODULE        <PF10>        _ USER  =  USER    <PF11>
_ ENTL  =  USER DEFINED ENTITY LIST    _ SYST  =  SYSTEM
_ MSGS  =  MESSAGE
_ QFIL  =  QFILE                       _ OPTI  =  OPTIONS
x DISP  =  DISPLAY ALL                 _ HELP  =  HELP <PF1>

The menu facility displays the Display All screen.

Specifying Selection Criteria

The WHERE response area specifies criteria to be used by the menu facility in selecting the occurrences to be displayed. To display the first 20 ELEMENT entity occurrences that contain the string W-EMP in the element name, you:

Request a comparison, using the syntax option NAME
Override the default comparison action EQ by typing a character at the underscore that immediately precedes the CONTAINS field
Request that the ELEMENT NAME be searched for the string W-EMP by typing the string in the 'VALUE'/FIELD field

More information: For more information about the WHERE clause, see WHERE Clause (Conditional Expressions).

IDD REL nn.n *** DISPLAY ALL *** DISP ─► DISPLAY PROCESSING ORDER..:X FIRST _ NEXT _ LAST _ PRIOR _ ALL NUMBER OF OCCURRENCES.....:20 OF ENTITY TYPE............:_ ATTRIBUTES _ PROCESSES _ TABLES _ CLASSES _ PROGRAMS _ USERS X ELEMENTS _ QFILES _ MESSAGES _ FILES _ RECORDS _ MODULES _ SYSTEMS _ MODULES ONLY (WITHOUT PROCESSES, QFILES, TABLES) _ USER DEFINED ENTITY...: WHERE 'VALUE'/FIELD....:name COMPARISON ACTION..:X EQ _ NE _ GT _ GE _ LT _ LE X CONTAINS _ MATCHES 'VALUE'/FIELD....:'w-emp' OR 'VALUE'/FIELD....: OR 'VALUE'/FIELD....:

The menu facility displays the pageable Display All List screen.

Display All List Screen

The SELECTED ON field and underlying headers display the selection criteria; that is, element names that contain W-EMP. The entity occurrences that fulfill the requirements are listed in columnar format by name and version number.

You can scan the list of element entity occurrences on the Display All List screen and choose to view additional information about element W-EMP-ADDRESS by typing a character next to the list item and pressing ENTER.

IDD REL nn.n *** DISPLAY ALL LIST *** DISL ─► PAGE 1 OF 2 SELECTED ON: NAME CONTAINS 'W-EMP' ELEMENT NAME VER _ W-EMPOSITION-VERB 1 _ W-EMPLOYEE-VERB 1 _ W-EMP-BIRTH-DAY 1 _ W-EMP-TERM-DAY 1 _ W-EMP-START-DAY 1 _ W-EMP-SS-NUMBER 1 _ W-EMP-STATUS 1 _ W-EMP-HOME-PHONE 1 _ W-EMP-ZIP-LAST-4 1 _ W-EMP-STATE 1 _ W-EMP-CITY 1 _ W-EMP-STREET 1 X W-EMP-ADDRESS 1 _ W-EMP-ZIP-FIRST-5 1 _ W-EMP-ZIP 1 _ W-EMP-SEX 1

The IDD menu facility displays the element occurrence W-EMP-ADDRESS on the Element Entity screen.

Element Entity Screen

The message line contains an informative message confirming your request. The specification area identifies the entity occurrence by NAME, VERSION NUMBER, and USAGE.

      IDD REL nn.n            *** ELEMENT ENTITY ***                   ELEM
  ─►
                    ELEMENT 'W-EMP-ADDRESS' VERSION 1 DISPLAYED

 X DISPLAY      ELEMENT NAME....:W-EMP-ADDRESS
 _ MODIFY
 _ ADD          VERSION NUMBER..:1      _ HIGHEST   _ NEXT HIGHEST
 _ DELETE                               _ LOWEST    _ NEXT LOWEST

  DESCRIPTION:

  PICTURE....:

  USAGE......:X DISPLAY                  _ CONDITION NAME (LEVEL 88)
              _ COMP/COMP-4 (BINARY)     _ COMP-3 (PACKED DECIMAL)
              _ COMP-1 (SHORT FLOATING)  _ COMP-2 (LONG FLOATING)
              _ BIT                      _ POINTER

 _ ELMX  =  ELEMENT EXTENSION <PF9>      _ SUBE  =  SUBORD ELEMENTS  <PF11>
 _ REGN  =  USER REGISTRATION <PF2>      _ PUBL  =  PUBLIC ACCESS    <PF3>
 _ CLAT  =  CLASS/ATTRIBUTES  <PF4>      _ RKEY  =  RELATIONAL KEYS  <PF5>
 _ COMM  =  COMMENTS          <PF6>      _ COML  =  COMMENT KEY LIST <PF7>
 _ HIST  =  HISTORY           <PF8>      _ COPY  =  SAME AS/COPY FROM
 _ XREF  =  CROSS REFERENCE   <PF10>     _ HELP  =  HELP             <PF1>

Selecting Fields to View Additional Information

In order to view other information about W-EMP-ADDRESS, refer to the screen selection area at the bottom of the Element Entity screen. The screen selection area lists other screens that contain information about the ELEMENT entity occurrence.

To view information about subordinate elements, you type a character at the underscore immediately preceding the SUBE field and press ENTER.

      IDD REL nn.n              *** ELEMENT ENTITY ***                 ELEM
  ─►
                    ELEMENT 'W-EMP-ADDRESS' VERSION 1 DISPLAYED

 X DISPLAY      ELEMENT NAME....:W-EMP-ADDRESS
 _ MODIFY
 _ ADD          VERSION NUMBER..:1      _ HIGHEST   _ NEXT HIGHEST
 _ DELETE                               _ LOWEST    _ NEXT LOWEST

  DESCRIPTION:

  PICTURE....:

  USAGE......:X DISPLAY                  _ CONDITION NAME (LEVEL 88)
              _ COMP/COMP-4 (BINARY)     _ COMP-3 (PACKED DECIMAL)
              _ COMP-1 (SHORT FLOATING)  _ COMP-2 (LONG FLOATING)
              _ BIT                      _ POINTER

 _ ELMX  =  ELEMENT EXTENSION <PF9>      X SUBE  =  SUBORD ELEMENTS  <PF11>
 _ REGN  =  USER REGISTRATION <PF2>      _ PUBL  =  PUBLIC ACCESS    <PF3>
 _ CLAT  =  CLASS/ATTRIBUTES  <PF4>      _ RKEY  =  RELATIONAL KEYS  <PF5>
 _ COMM  =  COMMENTS          <PF6>      _ COML  =  COMMENT KEY LIST <PF7>
 _ HIST  =  HISTORY           <PF8>      _ COPY  =  SAME AS/COPY FROM
 _ XREF  =  CROSS REFERENCE   <PF10>     _ HELP  =  HELP             <PF1>

The IDD menu facility displays the Subordinate Elements screen, which contains a list of elements that are subordinate to group element W-EMP-ADDRESS.

Subordinate Elements Screen

A message displayed on the message line identifies the group element entity occurrence.

IDD REL nn.n *** SUBORDINATE ELEMENTS *** SUBE ─► PAGE 1 LINE 1 1/4 ELEMENT 'W-EMP-ADDRESS' VERSION 1 ELEMENT NAME....:W-EMP-STREET VERSION NUMBER..:1 _ HIGHEST _ LOWEST OCCURS..: TIMES _ REDEFINES PREVIOUS SUBORDINATE ELEMENT ELEMENT NAME....:W-EMP-CITY VERSION NUMBER..:1 _ HIGHEST _ LOWEST OCCURS..: TIMES _ REDEFINES PREVIOUS SUBORDINATE ELEMENT ELEMENT NAME....:W-EMP-STATE VERSION NUMBER..:1 _ HIGHEST _ LOWEST OCCURS..: TIMES _ REDEFINES PREVIOUS SUBORDINATE ELEMENT ELEMENT NAME....:W-EMP-ZIP VERSION NUMBER..:1 _ HIGHEST _ LOWEST OCCURS..: TIMES _ REDEFINES PREVIOUS SUBORDINATE ELEMENT ELEMENT NAME....: VERSION NUMBER..: _ HIGHEST _ LOWEST OCCURS..: TIMES _ REDEFINES PREVIOUS SUBORDINATE ELEMENT

After choosing to review cross-reference information about element W-EMP-ADDRESS you request the Element Cross Reference screen by typing the screen name XREF in the command area of the Subordinate Elements screen and pressing ENTER.

IDD REL nn.n *** SUBORDINATE ELEMENTS *** SUBE ─►XREF PAGE 1 LINE 1 1/4 ELEMENT 'W-EMP-ADDRESS' VERSION 1 ELEMENT NAME....:W-EMP-STREET VERSION NUMBER..:1 _ HIGHEST _ LOWEST OCCURS..: TIMES _ REDEFINES PREVIOUS SUBORDINATE ELEMENT ELEMENT NAME....:W-EMP-CITY VERSION NUMBER..:1 _ HIGHEST _ LOWEST OCCURS..: TIMES _ REDEFINES PREVIOUS SUBORDINATE ELEMENT ELEMENT NAME....:W-EMP-STATE VERSION NUMBER..:1 _ HIGHEST _ LOWEST OCCURS..: TIMES _ REDEFINES PREVIOUS SUBORDINATE ELEMENT ELEMENT NAME....:W-EMP-ZIP VERSION NUMBER..:1 _ HIGHEST _ LOWEST OCCURS..: TIMES _ REDEFINES PREVIOUS SUBORDINATE ELEMENT ELEMENT NAME....: VERSION NUMBER..: _ HIGHEST _ LOWEST OCCURS..: TIMES _ REDEFINES PREVIOUS SUBORDINATE ELEMENT

The menu facility displays the Element Cross Reference selection screen.

Element Cross Reference Screen

To review all related information, you type a character in the CROSS REFERENCE TO ALL CATEGORIES LISTED BELOW field and press ENTER.

      IDD REL nn.n      *** 'ELEMENT' CROSS REFERENCE ***              XREF
 ─►
                        ELEMENT 'W-EMP-ADDRESS' VERSION 1


             X CROSS REFERENCE TO ALL CATEGORIES LISTED BELOW

             _ SAME AS OTHER ELEMENTS

             _ RELATED TO OTHER ELEMENTS

             _ WITHIN RECORDS    _ WITHIN REPORTS   _ WITHIN TRANSACTIONS






        NOTE - SELECT ONE OR MORE OF THE ABOVE CATEGORIES TO DISPLAY THE
               CROSS REFERENCE INFORMATION ASSOCIATED WITH THIS ELEMENT.

The entity occurrence is highlighted on the message line of the Element Cross Reference screen. Related cross-reference information is displayed in the specification area. W-EMP-ADDRESS is an element in the record JMH-WORD-REC-01, version number 1.

IDD REL nn.n *** 'ELEMENT' CROSS REFERENCE *** SHOW ─► PAGE 1 OF 1 ELEMENT 'W-EMP-ADDRESS' VERSION 1 WITHIN RECORD JMH-WORK-REC-01 VERSION 1 WITHIN GROUP W-EMPLOYEE VERSION IS 1

Ending the Menu Facility Session

To end the IDD menu facility session and return control to the system, you type the signoff command BYE in the command area of the current screen and press ENTER.

IDD REL nn.n *** 'ELEMENT' CROSS REFERENCE *** SHOW ─►BYE PAGE 1 OF 1 ELEMENT 'W-EMP-ADDRESS' VERSION 1 WITHIN RECORD JMH-WORK-REC-01 VERSION 1 WITHIN GROUP W-EMPLOYEE VERSION IS 1