.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.
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:
- BRIEF
- DESCRIPT
- FORMAT
- PARMS
- OPTIONS
- NOTES
- ERRORS
- 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
- 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
- This format word acts as a break.
- 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:
- Few RELATED HELP files exist, but you can use this option to customize your own HELP files.
- Abbreviations of conditional keywords are not allowed.