Commands › YWRKSCRXRF - Work with Screen Cross-References › Usage Details

Usage Details

When using the YWRKSCRXRF command to manually identify a screen, the following guidelines apply:

• Choose a piece of text near the top of the screen to use as the identifying data. This gives the best performance when the Web Option merge processor is trying to identify the screen.
• Choose a piece of text that is unlikely to be duplicated on another screen. For example, the*PROGRAM field that appears in CA 2E screens at the top left corner is not a good choice as an identifying field because it contains the same value for different screens within a multiple-screen function (for example, an DSPRCD3).
• Ensure that the field you choose contains data that does not change between different invocations of the program.

For example, if you wanted to manually identify the following screen (a CA 2E -generated screen that does not include the *SCREEN ID field):

*PROGRAM   *PGMMOD  OOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
                    Edit Region
Corp    Div                                     Region


 ?  Corp    Div     Description                   Region Description
                    OOOOOOOOOOOOOOOOOOOOOOOOO
                    OOOOOOOOOOOOOOOOOOOOOOOOO
                    OOOOOOOOOOOOOOOOOOOOOOOOO
                    OOOOOOOOOOOOOOOOOOOOOOOOO
                    OOOOOOOOOOOOOOOOOOOOOOOO
                    OOOOOOOOOOOOOOOOOOOOOOOOO
                    OOOOOOOOOOOOOOOOOOOOOOOOO
                    OOOOOOOOOOOOOOOOOOOOOOOOO

F3=Exit      F4=Prompt      F9=Go to 'Change' mode

If you want Edit Region to be the identifying text, and the skeleton to be called EDTREG1, then use F6 to create a Screen-cross reference record as shown in the following panel:

YSCRXRFE1R  CHANGE   Edit Screen Cross-reference


Screen ID: USR0001432   'Edit Region Panel 1'_________________________

Screen identifying data:  'Edit Region'______________________

SID row: 02   SID column:  36

DDS source member: RGHPEFKD
DDS source file  : QDDSSRC
                    *LIBL_____
Record format    : ZSFLCTL__


           ***** Skeleton details *****

Skeleton:   EDTREG1  Skeleton for Edit Region Panel 1_______________

Autoload level: 6   Server autoload level: 7


 F3=Exit  F12=Cancel

Note: You must enter the Record Format Name (there may be more than one screen associated with a function, and therefore more than one eventual Screen Identifier) as well as the DDS Source File and Member details.

The Screen Id is automatically assigned with the prefix USR, indicating that this panel is manually identified.