DT(1)

     NAME
          dt - A request server shell for SoftBench CM tools.

     SYNOPSIS
          dt

     DESCRIPTION
          dt is a program that may be used to request CM activities on
          behalf  of  a  Defect-ID.  Successful CM actions may then be
          logged in the ddts database.

        Options
          In the following descriptions of the options, context refers
          to   the  triple:  host,  directory,  file;  specifying  the
          environment in which dt will run and/or service requests.

          dt is a "NET" based tool and will honor  requests  from  any
          tool  with  any context (host, dir, file).  Because of this,
          the typical "-host", "-dir", "-file" have no meaning to this
          tool.  There are no other options for this tool.

          dt has no user interface.  Access to  all  functionality  is
          through messages.

     MESSAGES
          The following describes the message interface  supported  by
          the message class XDDTS for use with SoftBench Encapsulator.
          See  the  SoftBench  Encapsulator:  Programmer's  Guide  for
          information on using messages.  Standard messages understood
          by SoftBench tools are described in softbench(5).

          In  addition  to  the  standard  softbench   messages,   the
          following message is recognized after dt has initialized and
          established a connection with an existing  xddts  or  run  a
          subordinate xddts.


        Check-Out
          Request DT CM-CHECK-OUT context DEFECT-ID=defect-id
          Notify  DT CM-CHECK-OUT context DEFECT-ID=defect-id
          Failure DT CM-CHECK-OUT context DEFECT-ID=defect-id
          error-message

          This message requests a check-out  action  be  performed  on
          behalf of the passed defect id and the file specified in the
          message context.  The message is translated to a

               Request CM VERSION-CHECK-OUT context

          which is then sent. When and if a  VERSION-CHECK-OUT  Notify
          or  Fail  message with the same context of the CM Request is
          received, appropriate logging action against  the  ClearDDTS
          database will be performed.


        Check-In
          Request DT CM-CHECK-IN  context DEFECT-ID=defect-id HEADER="defect header"
          Notify  DT CM-CHECK-IN  context DEFECT-ID=defect-id HEADER="defect header"
          Failure DT CM-CHECK-IN  context DEFECT-ID=defect-id HEADER="defect header" error-message

          This message requests a  check-in  action  be  performed  on
          behalf of the passed defect id and the file specified in the
          message context.  the "HEADER=" information is not currently
          handled  by  the SoftBench rcstool and sccstool programs but
          is  provided  now  for  future  enhancement  purposes.   The
          message is translated to a

               Request CM VERSION-CHECK-IN context

          which is then sent. When and if a VERSION-CHECK-IN Notify or
          Fail  message  with  the  same  context of the CM Request is
          received, appropriate logging action against  the  ClearDDTS
          database will be performed.


        UnCheck-Out
          Request DT CM-UNCHECK-OUT  context DEFECT-ID=defect-id
          Notify  DT CM-UNCHECK-OUT  context DEFECT-ID=defect-id
          Failure DT CM-UNCHECK-OUT  context DEFECT-ID=defect-id

          This message requests an uncheck-out action be performed  on
          behalf of the passed defect id and the file specified in the
          message context.  The message is translated to a
               Request CM VERSION-CHECK-IN context

          which is then sent. It is hoped  that  the  user  will  then
          select  the  "Cancel Check Out" button to cancel the current
          check-out. When and if a  VERSION-CHECK-IN  Notify  or  Fail
          message with the same context of the CM Request is received,
          appropriate logging action against  the  ClearDDTS  database
          will be performed.


        UnCheck-In
          Request DT CM-UNCHECK-IN   context DEFECT-ID=defect-id
          Notify  DT CM-UNCHECK-IN   context DEFECT-ID=defect-id
          Failure DT CM-UNCHECK-IN   context DEFECT-ID=defect-id

          This message is not implemented  in  the  current  SoftBench
          sccstool rcstool environment.

     SEE ALSO