4. Operation › 4.8 CA MICS Documentation Conversion › 4.8.3 CA MICS Documentation Conversion Utilities › 4.8.3.1 HTML Conversion Utility (DOC2HTML) › 4.8.3.1.1 JCL and Options

4.8.3.1.1 JCL and Options

The following is an example of DOC2HTML JCL:


    // . . . . JOB . . . .
    //HTMLCVRT EXEC MICSDOCH,
    //        SYSPARM='options_string'
    //

  where options_string is the DOC2HTML processing options:

   o  Guide=guide_list

      Specifies which CA MICS guides are to be converted to
      HTML.  guide_list contains either guide name (e.g.,
      PIOM) or the one or two character guide id (e.g., L).

      If ALL is specified, then all guides are converted.

   o  CAT=category_list

      Requests that all guides in specified category be
      printed.  The two character category id can be found in
      the CA MICS Document Guide report as shown in section
      4.8.3.1.2.

      If ALL is specified, then all guides are converted.

   o  COMP=component_list

      Specifies all CA MICS guides associated with a
      particular CA MICS component (e.g., ACT) be printed.

      If ALL is specified, then all guides in all categories
      are converted.

   o  DIC=Y or N

      Controls the conversion of CA MICS Data Dictionary
      entries in the HTML guides.  By default, this option is
      set to 'N' (no conversion).

      Note:  Activating this option can significantly
             increase the amount of space required to store
             converted documents.

   Note: Options are case sensitive.

   To convert all CA MICS guides, the ALL parameter can be
   used on the GUIDE=, COMP=, or CAT= options.

   However, DOC2HTML can be a very resource intensive
   operation.  Converting all CA MICS guides at one time will
   consume a substantial amount of CPU time and may fail due
   to installation constraints on CPU time, output lines, or
   disk space.

   If no processing options or guides are selected, DOC2HTML
   will produce the CA MICS Document Guides report as shown
   in section 4.8.3.1.2.