User-specific HELP File

Calling a User Menu

Entering ?user [,name] in the CFS command field will result in a temporary switch from CFSHELP to a Help file created by the user.

Search Sequence for a User-specific Help File

CFS searches for the user-specific Help file according to the following rules:

1) The file was explicitly assigned with a file command (/FILE xxxx, LINK=HELPUSER)

2) A file exists with the name CFSHELP.jobname, or .acct if no job name was specified.

3) A file exists with the name CFSHELP.USER.

4) A file exists with the name $userid.CFSHELP.USER, where

userid is the userid under which CFS is cataloged.

Generating a Help File

The following statements are necessary to generate a Help file:

/FILE helpfile,LINK=HELPFILE

/EXEC (GENHELP,$CFS.CFSLIB)

DATA=lib(element-1)

DATA= ....

......

SOURCE=lib(element-x)

END

The elements marked element-n must exist as S-type elements in the PLAM library lib.

A DO procedure called J/GENHELP exists in the library CFS.S.LMSLIB.

Data Layout of a Help File

The most important syntax elements are:

:MEN: Menu statements define selection menus. Menus can be constructed to any number of hierarchical levels.

:HDR: Header records define the headers of a Help screen.

:KEY:/:END: Key and End records mark the limits of the individual information units in a Copy block. (see below).

The beginning and end of selection menus in the SOURCE element is defined with Key and End records.

:COP: Cop statements results in the copy of information from a DATA element during the generation.

:DIR: Directory statement. All menu points contained in the Directory List can be displayed by entering the name directly, i.e. ?USER,name. Example: ?USER,EBCD.

Only one Directory block per Help file is allowed.

The elements S/CFSHELP.USER.MENUE and S/CFSHELP.HELPTABS in the CFS.S.LMSLIB library contain all the data necessary to generate a sample User Help File.