Chapter 4: Paint Character Screens

This chapter contains the following sections:

 

Screen Painter Concepts

Develop screens interactively

The APS Screen Painter lets you paint character-based screens that are intuitive and easy to use. You first paint text, input/output fields, and then blocks of fields that accept multiple record occurrences. You then specify field names, field attribute and edit criteria, and generation parameters. The APS Generators retrieve this screen information from the Application Dictionary to produce native screen source code.

Paint screen fields

A character screen consists of fields and blocks of fields that you paint on a blank screen. You paint two types of fields in the APS Screen Painter:

Application Screen with Text and I/O Fields shows a sample application screen with I/O fields and text fields.

 



Figure 4-1: Application Screen with Text and I/O Fields

 

Create repeated record blocks

Your screens can also include repeated record blocks that accept or display multiple occurrences of one or more records. With a simple command, you can repeat a block of one or more source row as many times as necessary. A repeated record block generates a table in Working-Storage.

Sample Application Screen with a Repeated Record Block shows a repeated record block created from the row of I/O fields in Application Screen with Text and I/O Fields.

 



Figure 4-2: Sample Application Screen with a Repeated Record Block

 

When you create a record block, you do not need to paint and assign characteristics to each field individually--all fields reflect the characteristics of the source row. For example, changing the length of the Order Number field changes the length of all fields in the column.

Choose design options

The APS Screen Painter provides editing and design options to help you paint the screen. For example, you can specify where the Command field automatically appears on your screen, and can determine whether your text displays in upper case, lower case, or both.

Access online help

Additionally, the Screen Painter has an extensive help facility that you can access from your screen by pressing PF1.

Field Attributes

Define 3270 attribute support

APS lets you assign field attributes, such as field protection, brightness, cursor positioning, and color, to both I/O and text fields. The APS Screen Painter supports full and extended 3270 attribute capabilities, including:

 

APS assigns default attribute values to each field for you. Alternatively, you can quickly override the default by entering the values you want, as illustrated in Field Attributes Screen.

 



Figure 4-3: Field Attributes Screen

 

Field Edits

Define the internal, input, and output data representation

Field edits let you define the display and storage characteristics for I/O fields. Field edits can validate input data and format that data for storage and output. You can assign characteristics, such as an internal picture, output picture, edit mask, or date format. Or, you can test for specific values or a range of values.The internal data representation specifies storage characteristics for data in a field. Input and output data representations let you specify the type of data that users can enter or that a field can display. For example, an input data representation for a field may permit a user to enter numbers from 1 to 1,000; an output data representation may require that data display a dollar sign, decimal point, and two places following the decimal point.

You can also code your own edit routines and apply them to multiple screens across any number of application systems. APS field edits ensure that entries match specified definitions. Some fields, however, require specialized testing. For example, if a field has alternate formats, no single field edit can confirm the validity of all possible entries. In such a case, you can write an application edit that verifies all legal entries. Or, you can select a predefined edit from a centralized application edit listing.

Field Selection Screen for Screen Field Editing shows the available edit categories.

 



Figure 4-4: Field Selection Screen for Screen Field Editing

 

Global Data Elements

Select I/O field definitions

You can select global I/O fields, complete with definitions, attributes, text prompts, and edits, from the APS Data Element Facility. At generation time, APS picks up the definitions in the Data Element Facility.

 



Figure 4-5: Data Element Facility Listing of I/O Fields

 

If you modify a global field on your screen, it becomes a local field. APS then stores the field definition as part of your screen member. The local screen field does not change when the original global field in the Data Element Facility changes.

Know your site and project standards

Depending on how your site or project standard implements the Data Element Facility, you can do some or all of the following:

 

Before you paint your screens, check with your APS Administrator or Project Leader to determine which of these methods you can use to create and modify I/O fields. The procedures in this chapter cover all methods.

Scenario Prototype

Review screen sequence with users

After you paint several application screens, you can use the APS Scenario Painter to create and run an application model, with or without data. Your end users can view a typical production sequence of screens, enter data into I/O fields, and pass entries between the screens. You do not need to assign field attributes and edits or generate your screens before running screen flow scenario prototypes.

Create the prototyping sequence

To create a scenario prototype, you list the screens in your application in the order you want to view them. For example, if you run the scenario in Screen Listing in Scenario Painter, the Customer Order Main Menu displays first, followed by the Customer Record Maintenance screen--just as if an end user requested the screen from the menu. The remaining screens display in sequence and the prototype returns to the menu to exit the application.

 



Figure 4-6: Screen Listing in Scenario Painter

 

Dynamically change prototype at run time

As you run the prototype, you can make changes to correct errors and meet new user requirements by:

Simulate application data

During the prototype, you can enter data in screen fields and pass the data to other screens. In Entering Sample Input Data, the prototype displays the second screen of an 11-screen scenario with user-entered data. When you enter data during a prototype session, you can save it, and reuse it to simulate the movement of data. All data you enter automatically becomes available to other screens that contain identically named fields.

 



Figure 4-7: Entering Sample Input Data

 

Target-Specific Parameters

Tailor screen generation

The APS Screen Generator takes your designs from the APS Screen Painter and generates native map definitions. When you are ready to generate, you specify parameters that tailor your screen for the CICS, DDS, IMS DC, ISPF Dialog, or ISPF prototyping target environment.

For any environment, you can:

 

CICS-specific options

For the CICS environment, you can also:

 

IMS-specific options

For the IMS environment, you can also:

 

ISPF-specific options

For the ISPF Dialog environment, you can also:

 

Painting a Screen

Paint an application screen following the steps below. After step 1, you can perform some or all of the steps in any order.

  1. Access the screen
    Access the Screen Painter to create or modify a screen in one of the following ways:

  2. Apply screen design options
    To specify your editing session options, type profile in the Command field. APS displays a screen displaying the current editing session options in your user profile.

  3. Specify editing session options, as follows:

     

    Option
    		 Description

    Command Location

    Specify where the Command field appears - enter top for the top-left corner or bottom for the bottom-left corner.

    Caps on/off

    On

    Convert text fields to upper case.

    Off

    Preserve or restore text fields as you enter them.

    Nulls on/off

    On

    Insert data directly into a row.

    Off

    Fill rows with spaces.

    Keys on/off

    On

    Display the Screen Painter function key definitions at the bottom of the screen.

    Off

    Do not display keys.

    Display field name

    Yes

    Activate the Field Name screen. As you move the cursor between fields by pressing the Enter key, this screen displays the name of the current field. Pressing PF3 removes the screen from display, but keeps this option active.

    No

    Do not display the field name. To perform text editing functions, such as typing in a new field or moving fields with the space bar, set this option to No.

     

  4. Press PF3 to set your selections and return to your screen. The selected options remain in effect for all application screens until you change them, either in the current editing session or a subsequent one.

  5. Paint text fields
    To paint a text field, position the cursor where you want the field to begin and type the text. Text fields can consist of any characters, including special characters. To enter one or more Xs in a text field, you must distinguish the text from an I/O field by putting an underline character on either the left or right side of the X, for example, e_xit.

  6. Paint I/O fields
    To paint an I/O field, position the cursor where you want the field to begin, and type Xs for the maximum length of the field. I/O fields can have as many characters as can fit on one row of your screen, excluding column 1. Note: You can name the field when assigning field attributes; instructions are later in this procedure.

  7. To change the length of an I/O field, move the cursor to the Xs designating the field, and type in your changes. You can space over or delete the Xs, or extend the field with more Xs.

  8. Select predefined I/O fields
    To select an I/O field from the Data Element Facility, press PF9 from anywhere on your screen. The Data Element List screen appears on the right side of your screen. An asterisk (*) preceding a name indicates fields that already exist on this screen, and therefore are not available.

  9. Navigate the Data Element List screen as follows:

  10. To display a field definition, type ? in the selection field preceding the field name(s) you want. The Info screen, as shown in Data Element Facility Information Screen, displays the information for the selected screen field. To exit the current Info screen, press either PF3 to take you to the next Info screen if you entered ? on several fields, or PF4 to position you back in the data element list.

     



    Figure 4-8: Data Element Facility Information Screen

     

  11. To select fields, type s in the selection field preceding the field names you want to include on your screen, and press Enter. A right arrow (>) displays in front of each field you selected. To delete a selection, type d in the selection field, and then press Enter.

     



    Figure 4-9: Selecting Fields from the Data Element List

     

  12. When your selection is complete, press PF3. A screen displays information on the first field you selected from the data element list. The Text field displays the text prompt or label for the field. The Length field displays the field length, excluding any accompanying text from the Text field.

     



    Figure 4-10: Field Selected from the Data Element List

     

  13. Position the cursor where you want to place the field and press Enter. If the field has a text prompt, the prompt begins at the cursor location.

  14. The selected field screen presents the fields you selected in alphabetical order. You can use PF keys to manipulate the display of selected fields and the location of the information screen (so that it is not in your way as you position a field), as follows:

     

    PF3

    Cancel any selected fields not yet placed on the screen.

    PF5

    Display first field.

    PF6

    Display last field.

    PF7

    Display previous field.

    PF8

    Display next field.

    PF10

    Move information screen counter-clockwise.

    PF11

    Move information screen clockwise.

     

  15. Create repeated record blocks
    To create a repeated record block from any row(s) of I/O fields you paint, position the cursor on the source row--the top row to be repeated--and press PF7. The Repeated Block screen displays.

     



    Figure 4-11: Creating a Repeated Record Block

     

  16. Complete the fields in the Repeated Block screen as follows:

  17. Press Enter to create the record block indicated, or press PF3 to exit the screen without creating the record block. Creating a Repeated Record Block shows the record block specified in Repeated Record Block.

     



    Figure 4-12: Repeated Record Block

     

  18. Assign a screen title
    To assign a descriptive screen title that appears when you prototype in the Scenario Painter, enter title or t in the Command field. The Screen Title screen displays. Type your description in the Title field, and press PF3 or enter end on the Screen Title screen Command field. The description does not appear on your screen.

  19. Prototype screen flow for your end user
    To prototype your screen flow in a scenario prototype to your end user, see Creating and Running a Screen Flow Prototype. You do not need to assign field attributes or field edits, or generate the screen, to do a scenario prototype--you can prototype anytime from this point on in the procedure.

  20. Assign field attributes
    To assign field attributes by modifying the default attribute values for your text and I/O fields, you can:

     

  21. Modify attributes for all screen fields, as follows:

  22. To cycle through and assign attributes to all your I/O and text fields from the Field Attributes screen, press PF12. The screen always appears above or below the active field; the asterisk in the screen points to the active field. Each time you press PF12, the Screen Painter saves the changes made to the current field and moves to the next field. To remove changes for the current field, enter cancel in the Command field.

  23. If you assign attributes on the full-screen Field Attributes screen, press PF3 or enter end in the Command field to exit and save your changes, or enter can in the Command field to exit without saving your changes.

    Note: For more information on field attributes, see the "Attributes, Screen Fields" topic in the APS Reference.

  24. Create field for system messages
    To specify the system message field to display both system and program messages, choose one of the following:

  25. Paint Online Express program fields
    If you want the end user to execute program functions by entering a function code on the screen, paint function code fields on your screen. To do so, see Define Database Access.

  26. For your program to execute database functions, your screen generally needs fields for savekey storage. To paint savekey storage fields, see Defining Savekey Storage and a Commarea.

  27. Assign field edits
    To assign screen field edits, choose one of the following:

    See Painting Field Edits for information.

  28. Assign generation and DC target parameters
    To assign screen generation parameters for your DC target, enter pm in the Command field. The Screen Generation Parameters screen displays with default parameter values. See Setting Parameters for Generation for details.

  29. End the session
    Choose one of the following to complete your work in the Screen Painter:

  30. Print screen documentation
    To print a hardcopy report, see the "About APS Reports" topic in the APS Reference.

Special Considerations

Painting Field Edits

Assign screen field edits following the steps below:

  1. Access the field edit facility
    From your application screen, access the Field Edit Facility in one of the following ways:

     

  2. Depending on how you accessed the Field Edit facility in step 1, do one of the following:

    From either screen you can select several fields at one time; they process one after another. When the applicable screen displays, enter values as appropriate; to do so, refer to the topic listed for the category. Select an option as follows:

    Option
    		 Description

    Edit Selection

    Display the Edit Selection screen to see a summary of edits for that field and transfer to other edit specification screens. This is available only from the Field Selection screen.

    Internal Picture

    Display the Internal Picture screen to specify the internal storage format. See "Related Topics" below later for further information.

    Input Editing

    Display the Character Input or Numeric Input screen, depending on whether the internal picture specification is character or numeric. The internal picture default type is character. Assign input field edits on these screens. See "Related Topics" below for further information.

    Error Processing

    Display the Error Processing screen to specify error messages and attributes to display when the data for the field fails input edits. See "Related Topics" below for further information.

    Application Edits

    Display the Application Editing screen to create your own edit routine to process input data. See the "Application Field Edit Routines" topic in the APS Reference.

    Output Editing

    Display the Character Input or Numeric Input screen, depending on whether the internal picture specification is character or numeric. The internal picture default type is character. Assign output field edits on these screens. See the "Field Edits" topic in the APS Reference for more information.

    Application Edits

    Display the Application Editing screen to create your own edit routine to process output data. See the "Application Field Edit Routines" topic in the APS Reference for more information.

    Values Or Conversions

    Display the Values or Conversion screen to specify a valid value or range of values for input data, or conversion values for either input or output data. See the "Values, Conversion Values, and Value Ranges" topic in the APS Reference for more information.

    Special Edits

    Display the Special Edits screen to assign date or time specifications. This option is available only from the Edit Selection window. See the "Date and Time Field Edits" topic in the APS Reference for more information.

    Input and output editing

    Display the Character Input or Numeric Input screen, based on the internal picture specification, followed by the Character Output or Numeric Output screen. To do this, enter io next to a field on the Field Selection screen. See the "Field Edits" topic in the APS Reference for more information.

  3. Copy field edits
    To copy edits from another field, access the Edit Selection screen for the field you are copying field edits to, and then enter copy in the Command field. The Copy Function screen displays. Enter the field name you are copying edits from; it must be the same length as the current field. The current field inherits the edits of the copied field, and loses any prior edits.

  4. Delete field edits
    Delete field edits in one of the following ways:

  5. Specify global error messages
    Optionally assign a default error message for the screen to display when the end user enters invalid data as follows:
    1. Access the Field Selection screen, and enter pm or parm in the Command field. The Parm screen displays.

       



      Figure 4-17: Parm Screen

       

    2. On the Parm screen, type the name of the field that displays the error message.

    3. Enter the text to display when the data does not pass field edits and enter the text to display when required data is not entered in the appropriate fields.

    4. Specify the attribute values for fields that fail input edits; the default assigns bright and cursor positioning on the field.

      You can enter a field-specific error message by selecting the Error Processing prompt on most field edit screens; see the "Error Processing Messages" topic in the APS Reference for information. These messages override the global screen messages assigned in this step.

  6. Specify bypass options
    To define conditions for bypassing input edits for the screen, press Enter on the Parm screen. A subsequent Parm screen for bypassing edits displays. You can define bypass conditions for one field per screen; if any of these conditions occur, APS bypasses field edits for the entire screen. If the field is in a repeated block, APS bypasses edits for all fields in that row occurrence only.

     



    Figure 4-18: Second Parm Screen

     

  7. Complete the fields on this screen as follows:

    Field Name

    Specify any field on the screen, including a field in a repeated block, to bypass.

    Value(s)

    Specify the value or values that let end users bypass input edits. Valid COBOL reserved words are spaces, low-values, and high-values.

    Additional Value(s)

    Enter as many additional bypass values that can fit on the line; separate each value with a comma.

    Program Function Keys

    Type s in the selection field to indicate which PF keys the end user can press to bypass the input edits.

  8. Exit the Field Edit facility
    Choose one of the following to complete your field edits:

Creating and Running a Screen Flow Prototype

Test screen sequence

Before you generate your screens, you can review their design and flow with the end user in the APS Scenario Painter. Define a sequence of screens, called a scenario, enter data in those screens, and display the screens to the end user following the steps below. After step 1, you can perform most of the steps in any order.

  1. Access Scenario Painter
    Choose one of the following to access the Scenario Painter:

     



    Figure 4-19: Initial Application Prototype Definition

     

  2. Define the prototype
    To display the titles that you painted in the Screen Painter, enter retitle in the Command field. The titles display in the Screen Title field.

  3. To create the prototype definition to represent screen flow, use the ISPF I(nsert), D(elete), C(opy), and M(ove) commands to reorder, insert, and delete screen names until the prototype represents the scenario you want to test. A prototype definition can include up to 160 screens.

  4. To describe the screen for the end user, enter text in the User Comments field. For example, a user comment might identify the varying conditions under which the same screen displays. Initial Application Prototype Definition shows the definition from Scenario Prototype Definition, updated with sequence changes, screen titles, and screen descriptions.

     



    Figure 4-20: Scenario Prototype Definition

     

  5. To save your prototype definition, enter save in the Command field. To reset the screen flow to its sequence at the beginning of the session, enter reset in the Command field.

  6. Run the prototype
    To run the prototype, choose one of the following:

    The first screen in the scenario definition displays.

  7. To display an line that displays scenario information at the bottom of the screen, enter num in the top left corner of the screen. To hide the information line, enter num off.

     



    Figure 4-21: Prototype Information

     

    In Prototype Information, the information line states:

    TDOJ

    Screen name assigned in Application Painter

    6

    Sequence number of screen in scenario from prototype definition

    11

    Total screens in scenario from prototype definition

    CUSTOMER ORDERS INQUIRY

    Screen title painted in Screen Painter

    BROWSE ONLY

    User comment entered in Scenario Painter

  8. To display screens consecutively, press Enter repeatedly until all screens display. If a screen named in your prototype is not yet painted in the Screen Painter, a message displays that information.

  9. To transfer to the Screen Painter to create or modify a screen, enter edit in the top left corner of the screen.

  10. Demonstrate data flow between screens
    To enter data and show data flow between screens, type the data, followed by a space, in the Command area in the upper left corner of the screen.

     



    Figure 4-22: Entering the Data Command

     

  11. Enter data in the I/O fields, as desired. The data you enter replaces the Xs.

     



    Figure 4-23: Sample Input Data

     

    This data automatically appears in other screens that contain identically named fields.

     



    Figure 4-24: Passing Data in the Prototype

     

  12. When simulating data flow in your application, type any command, followed by a space, in the top left corner of the displayed screen:

    Command
    		 Description

    data

    The previous two steps and Entering the Data Command, Sample Input Data, and Passing Data in the Prototype illustrate this option.

    This option erases the Xs designating I/O fields and activates each field according to attributes assigned in the Screen Painter. You can now enter data in any field; this data automatically displays in identically named fields on other screens.

    dataoff

    Turn off data simulation and display the screen in its painted format.

    read

    Display the data saved by the most recently executed SAVE command and execute the DATA command. You can now enter or modify data in any field.

    save

    Store the current data entered in this scenario for use in future prototyping sessions.

  13. Modify the screen flow sequence
    To modify the viewing sequence of the screens, type a command, followed by a space, in the top left corner of the displayed screen.

     

    Command
    		 Description

    start, first

    Display the first screen in the prototype. When you press Enter, the second screen displays, and so on.

    last

    Display the last screen in the prototype.

    end, can, quit

    Terminate the prototype and return to the invoking screen.

    number

    Display the screen in the position specified in the prototype definition.

    +increment
    -increment

    Display the screen before (+) or after (-) the current screen, according to the prototype definition.

    screenname

    Display the first occurrence of the specified screen in the prototype definition.

    +screenname
    -screenname

    Display the first occurrence of the screen specified after (+) or before (-) the current screen.

  14. After viewing the last screen in the scenario, press Enter to exit the Scenario Painter.

Modifying Screen Layouts

Once you create a screen, you can easily change its layout. To do so, follow the procedures below.

Delete a Field or Row

Delete screen fields and rows as follows:

Modify a Repeated Record Block

Modify a repeated record block by following these steps:

  1. Position the cursor anywhere within the record block and press PF7. The Repeated Block Menu displays, as shown in Menu for Modifying a Repeated Block.

     



    Figure 4-25: Menu for Modifying a Repeated Block

     

  2. Select one of the following options by entering its number in the column preceding the first option listed.

     

    Option
    		 Select …
    		 To …

    1

    Change repeated block

    Display the Repeated Block pop-up to change the number of rows or occurrences in the record block.

    2

    Cancel repeated block

    Eliminate the record block and its repeated rows. The original source fields remain.

    3

    Cancel and retain all rows in the block

    Eliminate the record block, but retain every source field. The Screen Painter gives each field a unique name, and thereafter treats each as a separate entity.

    4

    Exit

    Exit the screen without changing the record block. This option is the same as pressing PF3.

Move or Copy a Field or Row

You can move, and if your site standard allows, copy I/O fields, text fields, or entire rows, including those from repeated blocks, to any location on the screen where there is sufficient space. To do so:

  1. Position the cursor as follows:

    Press PF10. Move the cursor to the opposite side of the group and press PF10 again.

  2. Using the arrow keys, position the cursor where you want to move or copy data. APS inserts the row on that line; any previous data on that line shifts down accordingly.

  3. Press PF4 to complete the move or PF5 to complete the copy.

  4. Alternatively, move a field to another location on the same row by placing the cursor in front of the text or I/O field and either deleting or inserting blank spaces to move the field to the left or right. In this case, you must set the Profile screen field for Nulls to ON.

  5. Alternatively, move or copy text fields by retyping the entry at a new location and deleting the entry at the old location.

  6. To cancel a move or copy at any time, press Enter.

Track Multiple Field Changes

If you add, delete, or modify several fields in the same row at the same time, the APS Screen Painter may prompt you to identify the names of some of the fields resulting from your changes. The Screen Field Name Selection screen displays; the asterisk points to the field in question.

 



Figure 4-26: Screen Field Name Selection Screen

 

From this screen, select one of the following options by entering its number in the column preceding the first option listed.

Select …
 To …

1

Assign the displayed value to the field. In fieldname, the Screen Painter displays an existing field name that cannot be assigned with certainty to a screen field.

2

Let the APS Screen Painter assign a default name to the field. The default name reflects the row and relative position of the field in that row: for example, A-ROW003-FLD002.

3

Default. If more than one existing field name cannot be assigned with certainty to a screen field, you can cycle through those field names by selecting option 3.

Setting Parameters for Generation

When you are satisfied with your screen designs, you can define the parameters that the APS Screen Generator uses to generate the screens for your data communications (DC) target environment. To do so, follow the steps below. After step 1, you can perform most of the steps in any order.

  1. Access the Screen Generation Parameters screen
    From the APS Screen Painter, enter pm (parameters) in the Command field. The Screen Generation Parameters screen displays. Screen Generation Parameters Screen displays default parameter values for an application screen.

     



    Figure 4-27: Screen Generation Parameters Screen

     

  2. To assign or change any values, move the cursor to the applicable position and type the value. Parameter values of T(rue) and Y(es) are interchangeable, as are F(alse) and N(o).

  3. Assign parameters
    Change parameter values that affect the screen in any environment, as desired. Applicable parameters and valid values are:

     

    Parameter
    		 Description and Values

    Prt Asm Mac Expn

    F

    Default. Do not print expanded assembler macros.

    T

    Print macros.

    No Assembler END

    F

    Default. Do not generate an assembler END statement.

    T

    Generate statement.

    Retain Datanames

    F

    Default. Do not retain painted field names as assembler labels.

    T

    Retain field names. Under BMS or MFS, duplicate or invalid names can occur due to the maximum number of characters that BMS and MFS allow.

    Exattr Modifble

    F

    Default. Do not modify extended attributes at run time.

    T

    Allow modification at run time; generate EXTATTR=YES and extra attribute bytes in DSECT.

    Anything specified in this field has no effect during prototyping.

    Sysmsg Message

    NO or blank

    Default. Do not display system messages.

    YES or SYSMSG

    Display messages on last line of the screen, if space is available.

    fieldname

    Display messages in fieldname.

    YES,row,length|YES,row|YES,,length

    Display message of up to length characters on specified row. Row default is last line of screen. Length can be from 40 to 70 characters or up to 131 characters for MOD5 screens.

    Intensity

    Change the intensity of all text fields.

    N

    Default. Normal

    B

    Bright.

    Color

    Change the color of all text fields.

    NU

    Neutral

    BL

    Blue

    PK

    Pink

    TQ

    Turquoise

    RD

    Red

    GN

    Green

    YL

    Yellow

    Blink
    Rvideo
    Underline

    Set only one field to T(rue) for text fields. Blinking, reverse video, and underline are mutually exclusive.

     

  4. Specify CICS parameters
    For a CICS target, assign parameters as follows:

     

    Parameter
    		 Description and Values

    Associated Trans

    Specify an associated transaction ID; default is the first four characters of the screen. If more than one screen begins with the same four characters, you need to define a unique transid.

    Mapset Name

    Override an APS-generated mapset name; maximum seven characters. The default mapset name reflects the number of characters in the screen name, as follows:

    4-character name: screennameSET
    5-, 6-character name: screenname$
    7-character name: screenname$; the $ replaces the seventh character

    Line

    Starting line of the map on the physical screen; default is 001; value cannot exceed the screen depth.

  5. Specify ISPF prototype parameters
    For prototyping under ISPF, assign parameters as follows:

    Parameter
    		 Description and Values

    Global Fld Unpro

    F

    Default. Protect all I/O fields for prototyping.

    T

    Unprotect all I/O fields.

    Associated Pgm

    Name of the program receiving control from the screen; default program name is screenname.

  6. Specify IMS DC parameters
    For an IMS target, assign parameters as follows:

    Parameter
    		 Description and Values

    Device Type

    Standard device characters for different model terminals and printers. Defaults are IBM-recommended device characters. See your IBM MFS or IMS installation manual for further details.

    Cursor Feedback

    F

    Default. Do not define a field in the MID as the cursor feedback field.

    T

    Provide cursor information for input processing. To hold the information, APS appends two halfword binary fields to the screen record:
    screen-CURSOR-ROW and screen-CURSOR-COL.

    Cursor feedback fields do not affect output cursor positioning.

    DIF-DOF Name

    Override APS-generated name. Default reflects the number of characters in the screen name, as follows:

    4-character name: screennameDF
    5-, 6-character name: screenname$
    7-, 8-character name: screenname truncated to 6 characters

    Opr Logical Paging

    F

    Default. Do not request operator logical paging.

    T

    Request paging. Enter name of field that will contain the paging requests in the Optional Fld Name field.

    MID Name

    Override APS-generated name. Default reflects the number of characters in the screen name, as follows:

    4-character name: screennameMI
    5-, 6-, 7-character name: screennameI
    8-character name: screennameI; the I replaces the eighth character

    MID Default Values

    F

    Default. Do not treat initial values as default values for fields in the MFS-generated MID.

    T

    Treat initial values as default values.

    MOD Name

    Override APS-generated name. Default reflects the number of characters in the screen name, as follows:

    4-character name: screennameMO
    5-, 6-, 7-character name: screennameO
    8-character name: screennameO; the O replaces the eighth character

    MOD Fill Char

    Generate fill characters in the MOD seqment statement. Valid characters are: --, NULL, PT, C, or 'x', where x is any character value.

    DSCA

    Override the Default System Control Area default value of X'00A0'.

    "Labeled" Screen

    F

    Default. Do not append screen name to the input message.

    T

    Append the screen name.

    Lines Per Page

    If device type is a printer, specify number of lines to print on a page.

    Trancode: Literal

    Specify any literal value as the trancode. Default is the screen name.

    Optional Fld Name

    Specify fieldname or MFS PFKEY to hold the trancode or operator logical paging command. Alternatively, enter *PF and assign the PF key value on the MFS Function Keys screen, or *TC and construct a trancode on the Trancode Construction screen.

    MID Segment Exit:


    Number

    Vector

    Generate the EXIT parameter on the MID segment statement with Number as the exit routine number and Vector as the exit vector number. Valid values are:

    Number: 0 to 127

    Vector: 0 to 255

  7. To save your parameter selections and exit this screen, press PF3. To exit without saving your selections, enter cancel in the Command field.

    Note: To learn how to generate an entire application, see Generate the Application.

Importing BMS Mapsets

The BMS Mapset Importer creates a screen member from an existing BMS screen description and stores it in APSSCRN.

Acces the importer

To access the BMS Mapset Importer, follow these steps:

  1. From the APS Main Menu, select 2, Dictionary Services.

  2. Select 1, Importers.

  3. Select 4, Screen.

  4. Select 1, Import BMS Mapset. The APS Screen Importer panel appears.

     



    Figure 4-28: BMS Importer Screen

 

Copyright © 2002 Micro Focus International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.