.CS (CONDITIONAL SECTION)

The CONDITIONAL SECTION format word identifies to HELP the section of the input file to be displayed based on the specified HELP command option.

Format
Read syntax diagramSkip visual syntax diagram .CS nkeywordONOFF

Operands

n
is a number from 0 to 7, which corresponds to the conditional section of the HELP file.
keyword
is the name of the conditional section. It may be:
  1. BRIEF
  2. DESCRIPT
  3. FORMAT
  4. PARMS
  5. OPTIONS
  6. NOTES
  7. ERRORS
  8. RELATED

These names correspond to the conditional section code number.

ON
marks the beginning of conditional section n.
OFF
marks the end of conditional section n.

Usage Notes

  1. The .CS format word enables you to identify the specific sections of the input file directly associated with the HELP Facility command options.

    You can then specify which section(s) of the HELP file are to be displayed by using the HELP command options: BRIEF, DESCRIPT, FORMAT, PARMS, OPTIONS, NOTES, ERRORS, and RELATED.

    If you choose to implement any HELP command files using the HELP command options, either the format word ‘.CS n ON’ or the ‘.CS keyword ON’ is required in the file. You must use the following form:
    Top of file
    .CS 0 on  (or .CS BRIEF on)
        (Text for BRIEF option)
    .CS 0 off (or .CS BRIEF off)
    .CS 1 on  (or .CS DESCRIPT on)
        (Text for DESCRIPT  option)
    .CS 1 off (or .CS DESCRIPT off)
    .CS 2 on  (or .CS FORMAT on)
        (Text for FORMAT  option)
    .CS 2 off (or .CS FORMAT off)
    .CS 3 on  (or .CS PARMS on)
        (Text for PARMS option)
    .CS 3 off (or .CS PARMS off)
    .CS 4 on  (or .CS OPTIONS on
        (Text for OPTIONS option)
    .CS 4 off (or .CS OPTIONS off)
    .CS 5 on (or .CS NOTES on)
        (Text for NOTES option)
    .CS 5 off (or .CS NOTES off)
    .CS 6 on  (or .CS ERRORS on)
        (Text for ERRORS option)
    .CS 6 off (or .CS ERRORS off)
    .CS 7 on  (or .CS RELATED on)
        (Text for RELATED option)
    .CS 7 off (or .CS RELATED off)
    End of file
  2. This format word acts as a break.
  3. If blank lines or portions of the file are written between the conditional sections (.CS sections), these lines are considered uncontrolled data and will be displayed with the DETAIL information.
Note:
  1. Few RELATED HELP files exist, but you can use this option to customize your own HELP files.
  2. Abbreviations of conditional keywords are not allowed.