UUID

Edit online

UUID is an optional statement that defines which logical partitions have UUID checking enabled. Logical partitions with UUID checking enabled must have a unique user-defined identifier (UID) for each function defined in your configuration with access to that logical partition. A UID can be specified for a function using the UID keyword on the FUNCTION statement. If a function is assigned to a partition with UUID checking enabled and does not have a UID defined, then IOCP assigns an arbitrary unique UID value.

When specified, the UUID statement must
  • Follow the ID statement (if specified) and the RESOURCE statement
  • Precede all FUNCTION statements.

See Coding IOCP statements for a summary of rules for coding statements and the notation in this document to illustrate statements.

The format of the UUID statement is as follows:
[symbol] UUID {PART | PARTITION}=({name[,name]...] | *})
PART | PARTITION=
Specifies the logical partitions for which UUID (unique user-defined identifier) checking is enabled for functions. All logical partition (LP) names that you specify must match the ones specified in the RESOURCE statement.

Each LP name is a 1-8 alphanumeric (0-9, A-Z) character name that must have a non-numeric first character. If you want every LP in your configuration to have UUID checking enabled, you can specify a single asterisk (*) instead of listing every LP name. You cannot specify the LMC partition MCS_1 and it is excluded from the list of all partitions when you specify the asterisk.

The following rules apply when UUID checking is enabled for a LP:
  • Every function with a candidate list that includes that LP must have a unique UID (user-defined identifier).
  • You must either specify the UID keyword on the FUNCTION statement or let IOCP pick a default UID value. The default UID values chosen by IOCP will not interfere with any specified UID numbers.
  • All UIDs in the LP must be unique.
  • The UID number must be a maximum of 4 hexadecimal digits (for example, FFFF)
  • When a function has a candidate list that contains both LPs that have UUID checking enabled and LPs with UUID checking disabled, the uniqueness only applies to the partitions that have UUID checking enabled. However, the UID value must be a maximum of 4 digits.

For LPs that do not have UUID checking enabled, a UID value is not required for every function. Also, UID values that are specified can be duplicated for that LP.