Previous Topic: 6.5 HTML Conversion Utility (DOC2HTML)Next Topic: 6.5.2 DOC2HTML Output


6.5.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 the guide name (for
      example, PIOM) or the one- or two-character guide id
      (for example, 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 Guides report shown in Figure 6-4.

      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.

   Note that 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 can fail due
   to data center 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 Figure 6-4.