HP OpenVMS Systems Documentation

HP OpenVMS RTL Library (LIB$) Manual

The address of the access name table can be obtained from the
LIB$GET_ACCNAM routine. Note that file access names are valid for any
protected object class.

The number of characters processed is optionally returned. This is
useful in error processing. The end position will be the offset to the
character that made the protection string invalid. Note that the entire
protection string must be valid, or an error is returned.

Several scenarios can cause the protection string to be invalid. The
format of the protection string may be invalid, or the access category
abbreviations may not be valid with respect to the access name tables.

Condition Values Returned

The Pause Program Execution routine suspends program execution and
returns control to the calling command level.

Format

LIB$PAUSE

RETURNS

OpenVMS usage:

cond_value

type:

longword (unsigned)

access:

write only

mechanism:

by value

Arguments

None.

Description

LIB$PAUSE suspends program execution and returns control to the calling
command level. The suspended image may be continued with the CONTINUE
command, or it may be terminated with the EXIT or STOP command. In the
latter case, the image will not return to this routine.

Note that this routine functions only for interactive jobs. If this
routine is invoked in batch mode, it has no effect.

Condition Values Returned

SS$_NORMAL

Routine successfully completed.

LIB$_NOCLI

No CLI present. The calling process does not have a CLI or the CLI does
not support the request. Note that DCL supports this function in
INTERACTIVE mode only.

D-floating values are not supported in full precision in native OpenVMS
Alpha and I64 programs. They are precise to 56 bits on VAX systems, 53
or 56 bits in translated VAX images, and 53 bits in native OpenVMS
Alpha and I64 programs.

RETURNS

Arguments

polynomial-argument

Argument for the polynomial. The polynomial-argument
argument is the address of a floating-point number that contains this
argument. The polynomial-argument argument is an
F-floating number.

degree

OpenVMS usage:

word_signed

type:

word (signed)

access:

read only

mechanism:

by reference

Highest-numbered nonzero coefficient to participate in the evaluation.
The degree argument is the address of a signed word
integer that contains this highest-numbered coefficient.

If the degree is 0, the result equals C[0]. The range of the degree is
0 to 31.

coefficient

OpenVMS usage:

floating_point

type:

F_floating

access:

read only

mechanism:

by reference, array reference

The address of an array of floating-point coefficients. The coefficient
of the highest-order term of the polynomial is the lowest addressed
element in the array. The coefficient argument is an
array of F-floating numbers.

floating-point-result

OpenVMS usage:

floating_point

type:

F_floating

access:

write only

mechanism:

by reference

Result of the calculation. The floating-point-result
argument is the address of a floating-point number that contains this
result. LIB$POLYF writes the address of
floating-point-result into an F-floating number.

Intermediate multiplications are carried out using extended
floating-point fractions (31 bits for POLYF).

RETURNS

Arguments

polynomial-argument

Argument for the polynomial. The polynomial-argument
argument is the address of a floating-point number that contains this
argument. The polynomial-argument argument is a
G-floating number.

degree

OpenVMS usage:

word_signed

type:

word integer (signed)

access:

read only

mechanism:

by reference

Highest-numbered nonzero coefficient to participate in the evaluation.
The degree argument is the address of a signed word
integer that contains this highest-numbered coefficient.

If the degree is 0, the result equals C[0]. The range of the degree is
0 to 31.

coefficient

OpenVMS usage:

floating_point

type:

G_floating

access:

read only

mechanism:

by reference, array reference

Floating-point coefficients. The coefficient argument
is the address of an array of floating-point coefficients. The
coefficient of the highest-order term of the polynomial is the lowest
addressed element in the array. The coefficient
argument is an array of G-floating numbers.

floating-point-result

OpenVMS usage:

floating_point

type:

G_floating

access:

write only

mechanism:

by reference

Result of the calculation. The floating-point-result
argument is the address of a floating-point number that contains this
result. LIB$POLYG writes the address of
floating-point-result into a G-floating number.

Intermediate multiplications are carried out using extended
floating-point fractions (63 bits for POLYG).

RETURNS

Arguments

polynomial-argument

Argument for the polynomial. The polynomial-argument
argument is the address of a floating-point number that contains this
argument. The polynomial-argument argument is an
H-floating number.

degree

OpenVMS usage:

word_signed

type:

word integer (signed)

access:

read only

mechanism:

by reference

Highest-numbered nonzero coefficient to participate in the evaluation.
The degree argument is the address of a signed word
integer that contains this highest-numbered coefficient.

If the degree is 0, the result equals C[0]. The range of the degree is
0 to 31.

coefficient

OpenVMS usage:

floating_point

type:

H_floating

access:

read only

mechanism:

by reference, array reference

Floating-point coefficients. The coefficient argument
is the address of an array of floating-point coefficients. The
coefficient of the highest-order term of the polynomial is the lowest
addressed element in the array. The coefficient
argument is an array of H-floating numbers.

floating-point-result

OpenVMS usage:

floating_point

type:

H_floating

access:

write only

mechanism:

by reference

Result of the calculation. The floating-point-result
argument is the address of a floating-point number that contains this
result. LIB$POLYH writes the address of
floating-point-result into an H-floating number.

Intermediate multiplications are carried out using extended
floating-point fractions (127 bits for POLYH).

RETURNS

Arguments

polynomial-argument

Argument for the polynomial. The polynomial-argument
argument is the address of a floating-point number that contains this
argument. The polynomial-argument argument is an IEEE
S-floating number.

degree

OpenVMS usage:

word_signed

type:

word (signed)

access:

read only

mechanism:

by reference

Highest-numbered nonzero coefficient to participate in the evaluation.
The degree argument is the address of a signed word
integer that contains this highest-numbered coefficient.

If the degree is 0, the result equals C[0]. The range of the degree is
0 to 31.

coefficient

OpenVMS usage:

floating_point

type:

IEEE S_floating

access:

read only

mechanism:

by reference, array reference

The address of an array of floating-point coefficients. The coefficient
of the highest-order term of the polynomial is the lowest addressed
element in the array. The coefficient argument is an
array of IEEE S-floating numbers.

floating-point-result

OpenVMS usage:

floating_point

type:

IEEE S_floating

access:

write only

mechanism:

by reference

Result of the calculation. The floating-point-result
argument is the address of a floating-point number that contains this
result. LIB$POLYS writes the address of
floating-point-result into an IEEE S-floating number.

Intermediate multiplications are carried out using extended
floating-point fractions (31 bits for POLYS).