NCLHELP.HLB  —  set  event_dispatcher, sink
    set  [node node-id] event dispatcher sink simple-name ...

    Modifies the attributes for an event dispatcher sink entity, which
    represents incoming connections and filters incoming events.  The
    modifiable attributes and their data types [in brackets] are:

    catch all filter [block-or-pass]
    client type [console-device-or-file]
    device name [latin1string]
    description [latin1string]
    file name [filespec]
    object name [full-name]
    template [simple-name] (Tru64 UNIX)
    user client [end-user-spec] (Tru64 UNIX)
    displayuids [boolean]

    Refer to attributes for specific command examples.

1  –  catch_all_filter

    Default: Pass          Value: Block or pass

    Specifies the action to take if neither the specific filter
    setting nor the global filter setting matches an event or if a
    filter setting that does match an event is set to Ignore.

    block    Discard the event.

    pass     Report the event.

    set [node node-id] event dispatcher sink sink-name -
        catch all filter block-or-pass

    Example:

    set event dispatcher sink local_sink -
        catch all filter pass

2  –  client_type

    Specifies the application to accept the events received by the
    sink. This can only be set when the event dispatcher sink entity
    is disabled (when the sink state is off).

    console     Events go to the operator's console (OPCOM-OpenVMS).
                This is the default.

    device      Events go to a device (see the device name
                attribute).

    file        Events go to a file (see the file name
                attribute).

    set [node node-id] event dispatcher sink sink-name -
        client type sink-type

    Example:

    set event dispatcher sink local_sink -
        client type file, -
        file name SYS$MANAGER:MYSINK.LOG

3  –  description

    Default: Null          Value: Latin1String

    Application description string.  On OpenVMS, this string must
    be embedded in quotes.

    set [node node-id] event dispatcher sink sink-name -
        description latin1string

4  –  device_name

    Default: Null          Value: Latin1String

    Name of the device to which events are going to be logged, if the
    client type of the sink is device.  On OpenVMS, this string must
    be embedded in quotes.

    set [node node-id] event dispatcher sink sink-name -
        device name latin1string

5  –  displayuids

    Default: True          Value: Boolean

    A boolean value indicating whether to include the UIDs when
    displaying an event.

    set [node node-id] event dispatcher sink sink-name -
        displayuids boolean

    Example:

    set event dispatcher sink local_sink displayuids false

6  –  file_name

    Default for Tru64 UNIX:      Value: File specification
    /usr/adm/event_file

    Default for OpenVMS:         Value: File specification
    SYS$MANAGER:NET$EVD_SINK_sinkname.LOG

    Name of the file to which events are going to be logged if the
    client type of the sink is file.

    set [node node-id] event dispatcher sink sink-name -
        file name file-name

    Example:

    set event dispatcher sink local_sink -
        client type file, -
        file name SYS$MANAGER:MYSINK.LOG

7  –  object_name

    Default: No sink object       Value: Full-name

    Full DNS object name of the sink. Modifying this characteristic
    affects only subsequent connect requests; existing connections
    are unaffected.

    set [node node-id] event dispatcher sink sink-name -
        object name full-name

8  –  template (Tru64 UNIX)

    Default: No template   Value: Simple name

    Transport template (see the osi transport template entity) for
    this sink's connections.

9  –  user client (Tru64 UNIX)

    Default: Null          Value: End-user specification

    Session control end user specification for a user program that
    has been set to receive events.
Close Help