The NCS$END_CS routine terminates a collating sequence.

    Format

      NCS$END_CS  cs_id

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  –  Argument

 cs_id

    OpenVMS usage:identifier
    type:         longword integer (unsigned)
    access:       modify
    mechanism:    by reference
    Address of a longword that NCS uses to store a nonzero value
    identifying a collating sequence.

    The cs_id argument is required.

3  –  Description

    The NCS$END_CS routine indicates to NCS that the calling program
    no longer needs the collating sequence. NCS releases the memory
    space allocated for the collating sequence and sets the value of
    the longword identifier to 0.

4  –  Condition Values Returned

    NCS$_NORMAL        Normal successful completion. The longword
                       identifier value is set to 0.
    NCS$_NOT_CS        Name of identifier does not refer to a
                       collating sequence.