SFLCTL (Subfile Control) keyword for display files

Use this record-level keyword to specify that this record format is to be a subfile control record format. This record format must immediately follow the subfile record format.

The format of the keyword is:

SFLCTL(subfile-record-format-name)

You must specify the name of the subfile record format as the parameter value for this keyword. The subfile control record format can contain field descriptions as well as subfile control keywords.

Your program can display subfile records only by issuing an output operation to the subfile control record format.

The subfile record format (SFL keyword) defines the format of the records in the subfile as opposed to the subfile control record format (SFLCTL keyword), which defines how the subfile can be displayed, cleared, deleted, and initialized. The program sends output operations to the subfile record format to build the subfile. It also sends output operations to the subfile control record format, setting option indicators for various subfile keywords to display, clear, delete, and initialize the subfile.

The following tables are a summary of subfile keywords used with the SFLCTL keyword. (Field-level keywords are used with fields in the subfile control record format.)

Table 1. Required keywords
SFLCTL SFLDSP SFLPAG SFLSIZ

Table 2. Optional keywords
CHCAVAIL CHCSLT CHCUNAVAIL SFLCLR SFLDLT SFLDROP SFLDSPCTL¹ SFLEND SFLENTER SFLFOLD SFLINZ	SFLLIN SFLMCLTCHC SFLMSG SFLMSGID SFLPGMQ SFLRCDNBR SFLRNA SFLROLVAL SFLSCROLL SFLSNGCHC
¹The SFLDSPCTL keyword is required if your program sends an input operation to the subfile control record format.

If subfile size equals subfile page, the following keywords are ignored. When several display sizes are used (DSPSIZ keyword specified), these keywords are ignored only for display sizes for which subfile size equals subfile page:

SFLDROP
SFLFOLD
SFLROLVAL

If the subfile record format contains field selection, the following keywords are not valid on the subfile control record format:

SFLDROP
SFLFOLD
SFLINZ
SFLLIN
SFLRCDNBR
SFLRNA (because SFLINZ is not valid)
SFLROLVAL

The USRDFN keyword is not valid for the subfile control record format.

The keywords CHCAVAIL, CHCSLT, and CHCUNAVAIL can be used only if either SFLSNGCHC or SFLMLTCHC is also used.

Option indicators are not valid for this keyword.

Example

The following example shows how to specify the SFLCTL keyword.

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