VMS Help
RTL Routines, LIB$, LIB$DISABLE_CTRL

 *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Disable CLI Interception of Control Characters routine
    requests the calling process's command language interpreter (CLI)
    to not intercept the selected control characters when they are
    entered during an interactive terminal session. LIB$DISABLE_CTRL
    provides the same function as the DCL command SET NOCONTROL.

    Format

      LIB$DISABLE_CTRL  disable-mask [,old-mask]

  1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

  2 - Arguments

 disable-mask

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Bit mask indicating which control characters are not to be
    intercepted. The disable-mask argument is the address of an
    unsigned longword containing this bit mask.

    Each of the 32 bits corresponds to one of the 32 possible control
    characters. If a bit is set, the corresponding control character
    is no longer intercepted by the CLI. Currently, only bits 20 and
    25, corresponding to Ctrl/T and Ctrl/Y, are recognized.

    The following mask is defined in symbol libraries supplied by
    Compaq to specify the value of disable-mask:

    Symbol          Hex Value     Function

    LIB$M_CLI_      %X'00100000'  Disables Ctrl/T
    CTRLT
    LIB$M_CLI_      %X'02000000'  Disables Ctrl/Y
    CTRLY

    If a set bit does not correspond to a character that the CLI can
    intercept, LIB$DISABLE_CTRL returns an error.

 old-mask

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference

    Previous bit mask. The old-mask argument is the address of an
    unsigned longword into which LIB$DISABLE_CTRL writes the old bit
    mask. The old bit mask is of the same form as disable-mask and
    indicates those control characters that were previously enabled.
    It may therefore be given to LIB$ENABLE_CTRL to reinstate the
    previous condition.
  Close     HLB-list     TLB-list     Help  

[legal] [privacy] [GNU] [policy] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.