Basic Random Number Generation (CEERAN0) API

The Basic Random Number Generation (CEERAN0) API generates a sequence of uniform pseudorandom numbers between 0 and 1 using the multiplicative congruential method with a user-specified seed.

Authorities and Locks

None.

Required Parameter Group

seed (I/O)

A 32-bit binary integer representing an initial value used to generate random numbers. It must be a variable; that is, it cannot be an input-only parameter. The valid range is 0 to 2 147 483 646.

If the value of the seed parameter is 0, the seed is generated from the current Greenwich Mean Time.

On return, CEERAN0 changes the value of seed so that it may be used as the new seed in the next call.

random_no (output)

A 64-bit double floating-point pseudorandom number with a value between 0 and 1, exclusive. If seed is not valid, random_no is set to -1 and CEERAN0 ends with a nonzero feedback code.

Omissible Parameter

fc (output)

A 12-byte feedback code passed by reference. If specified as an argument, feedback information (a condition token) is returned to the calling procedure. If not specified, and the requested operation was not successfully completed, the condition is signaled to the condition manager.

Feedback Codes and Conditions