Creating the help files

REXX/CICS includes an online help utility that you can use to search for and display the product documentation that is supplied with REXX/CICS.

About this task

As part of installation, you must load the information from the CICS TS product delivery data sets into the REXX/CICS file system.

Procedure

Define the REXX Filing System (RFS) filepools and set the help paths for the help utility.

The supplied CICSTART member, in the hlq.CICSTS55.REXX.SCICEXEC data set, includes statements to define RFS filepools and to set help paths for REXX help. Check and, if necessary, change these statements to meet your requirements. For details, see Update the CICSTART member.

The supplied CICSTART member defines the help path HELPPTH2 for the current help utility. For compatibility, it also defines the help path HELPPTH for the previous help facility. You do not need HELPPTH unless the previous help facility is installed and you want to use it until these installation steps are complete.
Ensure that the user ID that will load the help information in step 3 is authorized to import the relevant data sets from the CICS TS product delivery libraries to the REXX Filing System.

The CICHLOAD exec in the hlq.CICSTS55.REXX.SCICEXEC data set imports help information from the supplied hlq.CICSTS55.REXX.SCICDOC and hlq.CICSTS55.REXX.SCICPNL data sets. It uses the information to build files in the RFS that REXX help uses.
One way to ensure this authorisation is to create copies of hlq.CICSTS55.REXX.SCICDOC and hlq.CICSTS55.REXX.SCICPNL with the relevant user ID as the high-level qualifier.
Start REXX/CICS and issue the EXEC CICHLOAD command.
CICHLOAD imports help information and panel definitions from MVS libraries. When the following messages are displayed, provide the data set names that you set in the previous step:
```
Please enter the MVS dataset name of the help package library 
Example: hlq.CICSTS55.REXX.SCICDOC
```
```
Please enter the MVS dataset name of the panels library 
Example: hlq.CICSTS55.REXX.SCICPNL
```
The supplied CICSTS55.REXX.SCICDOC data set contains the CICRXHLP member, which contains online help information. The CICHLOAD program processes this to create the files that the online help utility uses. Files are created in the help path HELPPTH2 that you specified.

Any CICR3270 or CICR3820 members in this data set are superseded by the CICRXHLP member and a PDF that is supplied with the CICS Transaction Server for z/OS product information.

It is advisable to check the REXX for CICS Transaction Server product documentation that is supplied with the latest release of the CICS Transaction Server for z/OS product information for any updates that are more recent than the online product documentation.