{
{    The purpose of this request is to initiate a CDNA Directory search.  A
{  directory search consists of scanning the CDNA Directory for translations of
{  titles which match a specified title pattern.  A title translation consists
{  of the network address registered in the CDNA Directory with the title and,
{  optionally, certain other attributes of the server application which
{  registered the title.
{
{    A directory search occurs asynchronous to (concurrent with) execution of
{  the task which initiates the search.  For each title which matches the
{  specified title pattern, a title translation is made available for delivery
{  to the task which initiated the directory search.  A title translation is
{  delivered to a task via the nap$get_title_translation request.  A task may
{  use the osp$await_activity_completion request to wait for a title translation
{  to be available for delivery.  A task may terminate a directory search via
{  the nap$end_directory_search request.
{
{        NAP$BEGIN_DIRECTORY_SEARCH (TITLE_PATTERN, CLIENT, RECURRENT_SEARCH,
{          SEARCH_IDENTIFIER, STATUS)
{
{  TITLE_PATTERN: (input) This parameter specifies a title pattern which
{        matches the titles for which translations are to be delivered.
{
{  CLIENT: (input) This parameter specifies the name of the client application
{        on whose behalf the directory search is to be initiated.
{
{        The specified name must be the name of a defined client application --
{        refer to the MANAGE_NETWORK_APPLICATIONS utility.  The caller must be
{        authorized to perform the functions of the specified client
{        application.  The criteria used to validate this privilege is
{        determined by the client_ring, client_system_privilege and
{        client_capability attributes of the specified client application.
{
{        Only translations of titles registered by server applications which use
{        the same type of connection as the specified client application are
{        returned by the directory search.  The type of connection used by the
{        client application is specified when the application is defined.
{
{  RECURRENT_SEARCH: (input) This parameter specifies whether the directory
{        search is to be recurrent.
{
{        Both recurrent and non-recurrent directory searches perform an initial
{        scan of the CDNA Directory for matching titles.  When this scan is
{        complete, a non-recurrent search completes.  A recurrent search
{        continues to examine broadcasted title translations and makes
{        available for delivery any that match the specified title pattern.  A
{        recurrent search never completes; the search continues until explicitly
{        terminated by the task which initiated it.
{
{        The recurrent directory search provides a means for a client
{        application to be notified of titles which are registered in the CDNA
{        Directory after the initial scan of the directory has been completed.
{        To be effective, a recurrent search must be used in conjunction with
{        broadcasting the registration of the titles to be translated.
{
{  SEARCH_IDENTIFIER: (output) This parameter specifies an identifier for the
{        directory search which must be supplied on all subsequent requests
{        which reference the search.
{
{  STATUS: (output) This parameter specifies the request status.
{        CONDITIONS: nae$application_inactive
{              nae$network_inactive
{              nae$title_pattern_too_long
{              nae$title_pattern_too_short
{              nae$unknown_application
{
