VMS Help DCE_RPC, uuidgen  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   uuidgen - Generates a Universal Unique Identifier (UUID)

 SYNOPSIS

   uuidgen [argument] ...

 Arguments

   -c    Allows you to supply an existing UUID that uuidgen then outputs
         in the format you specify.  This option is especially useful in
         combination with the -s option for converting an existing UUID
         into a C structure.  You must specify the -c option at the end
         of the uuidgen command line; all options that follow -c are
         ignored.

   -i    Produces an Interface Definition Language (IDL) file template
         and includes the generated UUID string in the template.

   -o filename
         Redirects the generated UUID string to the file you specify.

   -s    Generates a UUID string as an initialized C structure.

   -v    Displays the version number of the UUID generator, but does not
         generate a UUID.

   -h    Displays information about the uuidgen command arguments.  The
         arguments -h and -? can be used interchangeably.

   -?    Displays information about the uuidgen command arguments.  The
         arguments -? and -h can be used interchangeably.

   -n number_of_uuid_strings
         Generates a specified number of UUID strings.

 DESCRIPTION

   The uuidgen command creates a UUID string that you assign to an object
   to uniquely identify it. One such use is in the UUID interface attribute
   of an IDL interface definition.  The format for representing a UUID
   string consists of eight hexadecimal digits followed by a dash,
   followed by three groups of four hexadecimal digits separated by dashes,
   followed by a dash and twelve hexadecimal digits:

        01234567-89ab-cdef-0123-456789abcdef

   The symbol uuidgen is defined in the DCE$DEFINE_OPTIONAL_COMMANDS
   command procedure.  This command file can be found in
   SYS$COMMON:[DCE$LIBRARY].

 FILES

   The locations of files have the following pathnames:

   SYS$SYSTEM:DCE$UUIDGEN.EXE
                       UUID Generator

 EXAMPLES

    1.  Generate a UUID string:

             $ uuidgen
             23c67e00-71b6-11c9-9dfc-08002b0ecef1

    2.  Generate a partial template, containing a generated UUID string,
        to be used to develop an interface definition:

             $ uuidgen -i
             [
             uuid(828bf780-71b6-11c9-b5a8-08002b0ecef1),
             version (1.0)
             ]
             interface INTERFACENAME
             {

             }

    3.  Convert a UUID string from the old-style format to the new format:

             $ uuidgen -t 34DC23469EAF.AB.A2.01.7C.5F.2C.ED.A3
             34dc2346-9eaf-0000-aba2-017c5f2ceda3

    4.  Generate four UUID strings:

             $ uuidgen -n 4
             612c0b00-71b8-11c9-973a-08002b0ecef1
             612c0b01-71b8-11c9-973a-08002b0ecef1
             612c0b02-71b8-11c9-973a-08002b0ecef1
             612c0b03-71b8-11c9-973a-08002b0ecef1

    5.  Convert a UUID into a C structure:

             $ uuidgen -s -c 1251ace6-93al-11cd-95ad-0800097086e4
                             0x1251ace6,
                             0x93al,
                             0x11cd,
                             0x95,
                             0xad
                             {0x08, 0x00, 0x09, 0x70, 0x86, 0xe4}
                     };

 RELATED_INFORMATION

     Commands: uuidgen.

1 - UUIDGEN DCL Command Interface

    This section provides DCL syntax for the UUID generation utility.
    Except where noted, DCL commands are equivalent to the universal
    command syntax documented in the uuidgen section of the OSF DCE
    Application Development Reference. See the Reference documentation
    for a complete description of the universal command syntax interface
    to the UUID generation utility.

    Users may choose to use either the universal interface to the
    UUID generation utility or the DCL-style alternative.

    NAME

     IDENTIFIER/TRANSLATE - Translates a DCE RPC Version UUID to a
     DCE RPC UUID.

    SYNOPSIS
     IDENTIFIER/TRANSLATE old-style-uuid [qualifier]...

    QUALIFIERS
     /OUTPUT=file
     /OUTPUT=SYS$OUTPUT  (default)

        This qualifier, used with a file name, directs output to a
        file.  If you do not specify a file name, the converted UUID
        goes to SYS$OUTPUT, generally your display terminal.

    NAME

     IDENTIFIER/GENERATE - Generates one or more DCE RPC
     UUIDs.

    SYNOPSIS
     IDENTIFIER/GENERATE [qualifier]

    QUALIFIERS
     /FORMAT [=option]

        Specify one or more of the following options.

        STRING (default)

        STRING Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

        This is a raw UUID in its readable form.

        IDL

        IDL Format:   [uuid(xxxxxxxx-xxxx-xxxx-xxxx- xxxxxxxxxxxx)]

        This is a UUID as it appears syntactically in an RPC
        interface definition.

        STRUCT

        STRUCT Format: This is an initialized C structure
        declaration, which can be included in C code that is used
        with DCE RPC.

     /COUNT=n

        This qualifier specifies the number of UUID strings to be
        generated. If you do not specify a number for n, the number 1
        is used by default.

     /OUTPUT=file
     /OUTPUT=SYS$OUTPUT (default)

        This qualifier, used with a file name, directs output to a
        file.  If you do not specify a file name, the converted UUID
        goes to SYS$OUTPUT, generally your display terminal.