HELPLIB.HLB  —  DCX Routines, DCX$COMPRESS_INIT
    The DCX$COMPRESS_INIT routine initializes the context area for
    the compression of data records.

    Format

      DCX$COMPRESS_INIT  context ,map

1  –  Returns

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

    Longword condition value. Most utility routines return a
    condition value in R0. Condition values that this routine can
    return are listed under Condition Values Returned.

2  –  Arguments

 context

    OpenVMS usage:context
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference
    Value identifying the data stream that DCX$COMPRESS_INIT
    initializes. The context argument is the address of a longword
    containing this value. You should not modify the context value
    after DCX$COMPRESS_INIT initializes it. You can define multiple
    context arguments to identify multiple data streams that are
    processed simultaneously.

 map

    OpenVMS usage:address
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    The function created by DCX$MAKE_MAP. The map argument is the
    address of the compression/expansion function's virtual address.

    The map argument must remain at this address until data
    compression is completed and the context is deleted by means
    of a call to DCX$COMPRESS_DONE.

3  –  Description

    The DCX$COMPRESS_INIT routine initializes the context area for
    the compression of data records.

    Call the DCX$COMPRESS_INIT routine after calling the DCX$ANALYZE_
    DONE routine.

4  –  Condition Values Returned

    DCX$_INVMAP        Error; invalid map. The map argument was not
                       specified correctly, or the context area is
                       invalid.
    DCX$_NORMAL        Normal successful completion.

    This routine also returns any condition values returned by
    LIB$GET_VM and LIB$FREE_VM.
Close Help