1 HLP
 The function of this routine is to accept the help command string
 (including the 'HELP', 'HEL', 'HE', or 'H'), access the specified help
 library, and display the requested help information to the output
 device (SYS$OUTPUT:). 

 Calling Procedure:

        status = HLP( str, hlp_lib [,mask] )

2 Parameters
 str - is the address of a string descriptor.  The string must
    contain complete help command line including the 'HELP', 'HEL',
    'HE', or 'H'.  For example: 

	HELP SEARCH

 hlp_lib - is the address of a string descriptor.  The string must
    contain the file specification of the help library to be
    searched.  For example: 

	SYS$HELP:IPSS.HLB

 mask - is the address of an OPTIONAL integer*4 variable.  The
    variable, if specified, must contain a mask of help output
    options. If no mask is specified then all mask bits are set. 
    The valid settings are: 

	HLP$M_PROMPT    - Prompt for additional input
	HLP$M_PROCESS   - Search process logical HLP$LIBRARY_x
	HLP$M_GROUP     - Search group logical HLP$LIBRARY_x
	HLP$M_SYSTEM    - Search system logical HLP$LIBRARY_x
	HLP$M_LIBLIST   - Display HLP$LIBRARY_x librarys
	HLP$M_HELP      - Preceed list of topics with HELP msg.

    Additional information about these mask values may be found in
    the 'Utilities Reference Manual' under LBR$OUTPUT_HELP in the
    LIBRARIAN Utility section. 

    To use these masks from a Fortran program do the following:

	EXTERNAL        HLP$M_PROMPT
	EXTERNAL        HLP$M_HELP

	MASK = %loc(HLP$M_PROMPT) .OR. %loc(HLP$M_HELP)

	STATUS = HLP( cmd_str, hlp_lib, MASK )

 status - The return status from the LBR$OUTPUT_HELP librarian
    routine is returned in this variable.  Good completion is
    SS$_NORMAL 

