SFLDLT (Subfile Delete) keyword for display files

Use this record-level keyword with an option indicator on the subfile control record format to enable your program to delete the subfile.

When the maximum number of subfiles in a display file is already active (24) and another subfile is to be made active, your program must delete one of the active subfiles before making another active.

This keyword has no parameters.

To make a subfile active, your program sends an output operation to the subfile record format or sends an output operation to the subfile control record format with the SFLINZ keyword in effect. To delete a subfile, your program sends an output operation to the subfile control record format with SFLDLT in effect. (Closing the display file deletes all the active subfiles.)

If your program sends an output operation with SFLDLT in effect to a subfile that is not active, the SFLDLT keyword is ignored.

Option indicators are required for this keyword; display size condition names are not valid.

Example

The following example shows how to specify the SFLDLT keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
00010A          R SFLR                      SFL
     A*
     A*            (at least one displayable field)
     A*
00040A          R SFLCTLR                   SFLCTL(SFLR)
00050A                                      SFLPAG(17)
00060A                                      SFLSIZ(17)
00070A  01                                  SFLDSP
00080A  01                                  SFLDSPCTL
00090A  04                                  SFLDLT
     A

The subfile is displayed when option indicator 01 is set on for an output operation to SFLCTLR, and the subfile is deleted when option indicator 04 is set on for an output operation to SFLCTLR. Normally, the option indicators specified for SFLDLT are different from the option indicators specified for the SFLDSP and SFLDSPCTL keywords.