Commands › YWRKSCRXRF - Work with Screen Cross-References

YWRKSCRXRF - Work with Screen Cross-References

Allows screen cross-reference records, which associate a screen with the corresponding HTML skeleton for that screen, to be created, updated, displayed or deleted. A screen is a single panel or view. Note that a single display can contain several screens (a 2E DSPRCD3 (Display record 3) function is an example of a display file that contains 4 separate screens - a key screen and 3 detail screens). Each separate screen within a display file must be identified.

Any CA 2E display files can include the *SCREEN ID field in their Header/Footer. Inclusion of this field results in automatic identification for each screen within that display file, and consequently, this command does not have to be run for those screens.

However, this command should be used whenever one of the following situations exists:

• A CA 2E-generated display file was generated prior to Release 8.0+ of CA 2E and you do not wish to regenerate it to include the *SCREEN ID field.
• You have manually created a skeleton for a non-CA 2E-generated screen. This might be an IBM screen, (for instance, the Work with All Spooled Files screen) that is part of a display file you have written yourself, or that you have received from a third-party vendor.

Manual identification is the process by which you determine a piece of output data on the screen (for example, the screen title) that uniquely identifies the screen. Using the YWRKSCRXRF command to manually identify a screen results in a record being created in the Screen Cross-Reference file, with its own unique Screen Identifier. It is this screen identifier that further links the screen to a skeleton. For more details about manual identification, see the Usage Details section that follows.