Maintaining Application Components › Maintaining Lists › List Format Panel

List Format Panel

After entering the Entry Line Presentation Attributes, press F8 (Forward) to specify the list format on the CAS : List Format panel.

 PROD-------------------------- CAS : List Format -------------------Page 4 of 4
 Command ===>                                   Function=Add Scroll ===> PAGE

 Appl ID ... TST      Type.Userid ... PUBLIC                 Name ... TST001

 LINE <---+----10---+----20---+----30---+----40---+----50---+----60---+----70---
 **** ****************************** TOP OF DATA *******************************
 0001 A>S/B=Browse U=Update C=Copy P=Print D=Delete
 0002 M>S/=Select
 0003 S>S/=Select (one only)
 0004 Number    Description
 0005 &PROBID   &DESCRIPTION
 0006 Number    Severity Status     Occurred Date/Time
 0007 &PROBID   &SEV     &STATUS    &OCCURDATE  &OCCURTIME
 0008 Number    Created     Last Updated
 0009 &PROBID   &CRTDATE    &UPDDATE    &UPDTIME  &UPDUSERID
 **** ***************************** BOTTOM OF DATA *****************************





  F1=Help      F2=Split     F3=File      F4=Save      F5=Fields    F6=Change
  F7=Backward  F8=Forward   F9=Swap     F10=Left     F11=Right    F12=Cancel

A list’s format determines how list items are displayed, the other attributes that are displayed about each item, and static heading and option text. This panel displays a text editor that is used to define the format of a list.

A list format consists of:

• Up to four comment lines; one for each list type
• Up to 10 screen formats. Each screen format defines a screen that is displayed when the list is presented to a user (that is, a list can be presented over ten screens). F11 (Right) and F10 (Left) can be used to scroll between the screens.

A screen format consists of:

• Up to 10 heading lines
• An entry line, which contains the list data. (Each line of a displayed list is referred to as an entry line.)

At the top of the CAS : List Format panel text area, you can enter up to four comment lines, one for each type of list, to display specific instructions to the user. When the list is displayed, the appropriate comment line is shown on line 4 of the list panel. Comment lines are optional.

Use the following codes at the beginning of your comment line as follows:

A>

Defines instructions for an Action List.

M>

Defines instructions for a Multiple Select List.

S>

Defines instructions for a Single Select List.

N>

Defines instructions for a Numbered List.

Comment lines can contain NCL variables. For instance, you might want a comment line for an Action List to describe only those actions for which a user is authorized. You could achieve this by setting the entire comment line through a variable set by the list’s service or exit procedure.

Any NCL variables defined in the comment line (except for system variables) must be set by the service procedure or list exit. The variable data in the comment line is then substituted by the system when a list is displayed using the list definition.

After entering the comment lines, to display the actual list entries you must define one or more screen formats (up to a maximum of 10). Each of these screen formats consists of a heading and an entry line.

Notes: 

• If you specified that the format for the list be drawn from an existing list definition, you cannot define a list format.
• A heading (up to 10 lines long) can contain constant or variable data, or both. Constant data is static, while variable data is set by the service procedure or list exit and substituted into the expression when the heading is displayed. For variables to be recognized, a Heading Sub Char must be specified; for example, if the NCL variable &USERID is used in the heading definition and the Heading Sub Char has been defined as &, the variable is replaced by the user’s user ID when the heading is displayed.

  If you wanted the & to appear as a constant in the heading, you would have to define a different Heading Sub Char; therefore, if you specify the ~ character as the Heading Sub Char, for the previous example you would use ~USERID instead of &USERID.

• An entry line consists of entry line fields (NCL variables), each of which is replaced by an attribute of the list item when the list is displayed. An entry line can also contain constant data. Note, however, that the first non-blank character on the line must be an ampersand (&).

  Entry line fields can be the following:

• Real variables
• Aliases for real variables