HELPLIB.HLB  —  ENCRYPT Routine, ENCRYPT$GENERATE_KEY, Arguments
 algorithm-name

    type:      char_string
    access:    read only
    mechanism: by descriptor
    The name of the algorithm that will use the generated key.

 key-length

    type:      word unsigned
    access:    read only
    mechanism: by reference
    Unsigned integer indicating the size of the key to be generated.
    The key-length argument is the address of an unsigned word
    containing a value that indicates the length of the key.

    For AES, the key-length argument takes values as increments of
    AES block size: 16 bytes, 32, bytes, and 48 bytes, and so on.

 factor-a, factor-b, factor-c

    type:      char_string
    access:    read only
    mechanism: by descriptor
    Optional arguments. The factor-a, factor-b, and factor-c
    arguments are operation-dependent data used as randomizing
    factors when the routine generates a key value. For example,
    the factors might be:

    o  Time an operation started

    o  Size of a certain stack

    o  Copy of the last command line

 key-buffer

    type:      char_string
    access:    write
    mechanism: by descriptor
    Buffer into which the generated key is to be placed. The key-
    buffer argument is the address of a string descriptor referencing
    the appropriate buffer.

    If you specify a class D descriptor, dynamic memory is allocated
    to contain the entire key.
Close Help