HELPLIB.HLB  —  RTL Routines, LIB$  LIB$DISABLE_CTRL
    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 VSI
    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 Help