 |
HP OpenVMS System Services Reference Manual
$ICC_TRANSMITW
Sends a single message over a connection.
The $ICC_TRANSMITW service completes synchronously; that is, it returns
to the caller when the underlying transport layer has released use of
the Transmit buffer. This does not mean that the data has been received
by the partner application.
For asynchronous completion, use the $ICC_TRANSMIT service. The
$ICC_TRANSMIT service returns to the caller as soon as the transmission
request has been queued to the transport layer, without waiting for
notification that the transport layer has released control of the data
buffer.
On Alpha and Integrity server systems, this service accepts 64-bit
addresses.
Format
SYS$ICC_TRANSMITW conn_handle ,ios_icc ,[astadr] ,[astprm] ,send_buf
,send_len
C Prototype
sys$icc_transmitw (unsigned int conn_handle, struct _ios_icc *ios_icc,
void (*astadr)(__unknown_params), __int64 astprm, char *send_buf,
unsigned int send_len);
$IDTOASC
Translates the specified identifier value to its identifier name.
On Alpha and Integrity server systems, this service accepts 64-bit
addresses.
Format
SYS$IDTOASC id ,[namlen] ,[nambuf] ,[resid] ,[attrib] ,[contxt]
C Prototype
int sys$idtoasc (unsigned int id, unsigned short int *namlen, void
*nambuf, unsigned int *resid, unsigned int *attrib, unsigned int
*contxt);
Arguments
id
| OpenVMS usage: |
rights_id |
| type: |
longword (unsigned) |
| access: |
read only |
| mechanism: |
by value |
Binary identifier value translated by $IDTOASC. The id
argument is a longword containing the binary value of the identifier.
To determine the identifier names of all identifiers in the rights
database, you specify id as --1 and call $IDTOASC
repeatedly until it returns the status code SS$_NOSUCHID. The
identifiers are returned in alphabetical order.
namlen
| OpenVMS usage: |
word_unsigned |
| type: |
word (unsigned) |
| access: |
write only |
| mechanism: |
by 32- or 64-bit reference (Alpha and Integrity
servers) |
Number of characters in the identifier name translated by $IDTOASC. The
namlen argument is the 32- or 64-bit address (on Alpha
and Integrity server systems) of a word containing the length of the
identifier name written to nambuf.
nambuf
| OpenVMS usage: |
char_string |
| type: |
character-coded text string |
| access: |
write only |
| mechanism: |
by 32- or 64-bit descriptor--fixed-length string descriptor
(Alpha and Integrity servers) |
Identifier name text string returned when $IDTOASC completes the
translation. The nambuf argument is the 32- or 64-bit
address (on Alpha and Integrity server systems) of a descriptor
pointing to the buffer in which the identifier name is written.
resid
| OpenVMS usage: |
rights_id |
| type: |
longword (unsigned) |
| access: |
write only |
| mechanism: |
by 32- or 64-bit reference (Alpha and Integrity
servers) |
Identifier value of the identifier name returned in
nambuf. The resid argument is the 32-
or 64-bit address (on Alpha and Integrity server systems) of a longword
containing the 32-bit code of the identifier.
attrib
| OpenVMS usage: |
mask_longword |
| type: |
longword (unsigned) |
| access: |
write only |
| mechanism: |
by by 32- or 64-bit reference (Alpha and Integrity
servers) |
Mask of attributes associated with the identifier returned in
resid. The attrib argument is the 32-
or 64-bit address (on Alpha and Integrity server systems) of a longword
containing the attribute mask.
Symbol values are offsets to the bits within the longword. You can also
obtain the values as masks with the appropriate bit set using the
prefix KGB$M rather than KGB$V. The following symbols for each bit
position are defined in the system macro library ($KGBDEF):
| Bit Position |
Meaning When Set |
|
KGB$V_DYNAMIC
|
Allows holders of the identifier to remove it from or add it to the
process rights list using the DCL command SET RIGHTS_LIST.
|
|
KGB$V_NAME_HIDDEN
|
Allows holders of an identifier to have it translated, either from
binary to ASCII or vice versa, but prevents unauthorized users from
translating the identifier.
|
|
KGB$V_NOACCESS
|
Makes any access rights of the identifier null and void. This attribute
is intended as a modifier for a resource identifier or the Subsystem
attribute.
|
|
KGB$V_RESOURCE
|
Allows holders of an identifier to charge disk space to the identifier.
It is used only for file objects.
|
|
KGB$V_SUBSYSTEM
|
Allows holders of the identifier to create and maintain protected
subsystems by assigning the Subsystem ACE to the application images in
the subsystem.
|
contxt
| OpenVMS usage: |
context |
| type: |
longword (unsigned) |
| access: |
modify |
| mechanism: |
by 32- or 64-bit reference (Alpha and Integrity
servers) |
Context value used when repeatedly calling $IDTOASC. The
contxt argument is the 32- or 64-bit address (on Alpha
and Integrity server systems) of a longword used while $IDTOASC
searches for all identifiers. The context value must be initialized to
the value 0, and the resulting context of each call to $IDTOASC must be
presented to each subsequent call. After contxt is
passed to $IDTOASC, you must not modify its value.
Description
The Translate Identifier to Identifier Name service translates the
specified binary identifier value to an identifier name. While the
primary purpose of this service is to translate the specified
identifier to its name, you can also use it to find all identifiers in
the rights database. Owner or read access to the rights database is
required. To determine all the identifiers, call $IDTOASC repeatedly
until it returns the status code SS$_NOSUCHID. When SS$_NOSUCHID is
returned, $IDTOASC has returned all the identifiers, cleared the
context value, and deallocated the record stream.
If you complete your calls to $IDTOASC before SS$_NOSUCHID is returned,
use $FINISH_RDB to clear the context value and deallocate the record
stream.
When you use wildcards with this service, the records are returned in
identifier name order.
Required Access or Privileges
None, unless the id argument is NAME_HIDDEN, in which
case you must hold the identifier or have read access to the rights
list.
Required Quota
None
Related Services
$ADD_HOLDER, $ADD_IDENT, $ASCTOID, $CHECK_ACCESS, $CHKPRO, $CREATE_RDB,
$ERAPAT, $FIND_HELD, $FIND_HOLDER, $FINISH_RDB, $FORMAT_ACL,
$FORMAT_AUDIT, $GET_SECURITY, $GRANTID, $HASH_PASSWORD, $MOD_HOLDER,
$MOD_IDENT, $MTACCESS, $PARSE_ACL, $REM_HOLDER, $REM_IDENT, $REVOKID,
$SET_SECURITY
Condition Values Returned
|
SS$_NORMAL
|
The service completed successfully.
|
|
SS$_ACCVIO
|
The
namlen,
nambuf,
resid,
attrib, or
contxt argument cannot be written by the caller.
|
|
SS$_INSFMEM
|
The process dynamic memory is insufficient for opening the rights
database.
|
|
SS$_IVCHAN
|
The contents of the context longword are not valid.
|
|
SS$_IVIDENT
|
The specified identifier is of invalid format.
|
|
SS$_NOIOCHAN
|
No more rights database context streams are available.
|
|
SS$_NORIGHTSDB
|
The rights database does not exist.
|
|
SS$_NOSUCHID
|
The specified identifier name does not exist in the rights database, or
the entire rights database has been searched if the ID is --1.
|
Because the rights database is an indexed file that you access with
OpenVMS RMS, this service can also return RMS status codes associated
with operations on indexed files. For descriptions of these status
codes, refer to the OpenVMS Record Management Services Reference Manual.
$IEEE_SET_FP_CONTROL (Alpha and Integrity servers)
On Alpha and Integrity server systems, modifies IEEE floating-point
state and, optionally, returns the previous value.
The service provides the mechanism to set the specified state bits, to
clear the specified state bits, and to swap one set of state bits for
another.
Format
SYS$IEEE_SET_FP_CONTROL [clrmsk] ,[setmsk] ,[prvmsk]
C Prototype
int sys$ieee_set_fp_control (struct _ieee *clrmsk, struct _ieee
*setmsk, struct _ieee *prvmsk);
Arguments
clrmsk
| OpenVMS usage: |
mask_quadword |
| type: |
quadword (unsigned) |
| access: |
read only |
| mechanism: |
by reference |
Address of a quadword bit mask to be cleared in the IEEE floating-point
control register.
The $IEEEDEF macro defines symbols for the floating-point control
register. Table SYS-46 shows the symbols, their corresponding masks,
and their meaning:
Table SYS-46 Format of the IEEE Floating-Point Control Register (Alpha and Integrity servers)
| Symbol |
Mask |
Meaning |
|
IEEE$M_TRAP_ENABLE_INV
|
2
|
Enable invalid operation exception
|
|
IEEE$M_TRAP_ENABLE_DZE
|
4
|
Enable divide by 0 exception
|
|
IEEE$M_TRAP_ENABLE_OVF
|
8
|
Enable overflow exception
|
|
IEEE$M_TRAP_ENABLE_UNF
|
10
|
Enable underflow exception
|
|
IEEE$M_TRAP_ENABLE_INE
|
20
|
Enable inexact exception
|
|
IEEE$M_TRAP_ENABLE_DNOE
|
40
|
Enable denormal operand exception
|
|
IEEE$M_MAP_DNZ
|
2000
|
Denormal operands are mapped to 0.0
|
|
IEEE$M_MAP_UMZ
|
4000
|
Underflow results are mapped to 0.0
|
|
IEEE$M_INHERIT
|
8000
|
Inherit FP state on thread create
|
|
IEEE$M_STATUS_INV
|
20000
|
Invalid operation
|
|
IEEE$M_STATUS_DZE
|
40000
|
Divide by 0
|
|
IEEE$M_STATUS_OVF
|
80000
|
Overflow
|
|
IEEE$M_STATUS_UNF
|
100000
|
Underflow
|
|
IEEE$M_STATUS_INE
|
200000
|
Inexact
|
|
IEEE$M_STATUS_DNO
|
400000
|
Denormal operand
|
setmsk
| OpenVMS usage: |
mask_quadword |
| type: |
quadword (unsigned) |
| access: |
read only |
| mechanism: |
by reference |
Address of a quadword bit mask to be set in the IEEE floating-point
control register.
Table SYS-46 shows the format of the IEEE floating-point control
register.
prvmsk
| OpenVMS usage: |
mask_quadword |
| type: |
quadword (unsigned) |
| access: |
write only |
| mechanism: |
by reference |
Address of a quadword to receive the previous value of the IEEE
floating-point control register.
Description
The Set IEEE Floating-Point Control Register service updates the IEEE
floating-point control register, maintained by the operating system,
with the values supplied by the calling program.
The following steps are used to update the register:
- If the prvmsk argument is specified,
$IEEE_SET_FP_CONTROL first reads the previous value of the IEEE
floating-point control register.
- If the clrmsk argument is specified,
$IEEE_SET_FP_CONTROL then clears the specified bit masks in the
clrmsk argument.
- If the setmsk argument is specified,
$IEEE_SET_FP_CONTROL then sets the specified bit masks in the
setmsk argument.
A program can swap the IEEE floating-point control register (that is,
save the old value and specify a new value) by specifying the following:
- The clrmsk argument with the address of a quadword
of all 1s
- The setmsk argument with the address of a quadword
that holds the new register value
- The prvmsk argument with the address of a quadword
to save the old register value
On Integrity server systems, the initial state value
and the scope of the modified state values differ depending on the
location of the call to this routine, as shown in the following table.
| Location of Call |
State Value |
Scope of New State Value |
|
Mainline
|
Determined by the compiler switches used when compiling the modules.
|
Change is in effect until this service is called again, with the
exception of ASTs (see below).
|
|
Condition handler
|
The same as the state in effect when the condition occurs, unless the
setting was changed by a previous condition handler.
|
Change is in effect until all remaining condition handlers have been
called or this service is called again.
|
|
AST routine
|
Determined by the compiler switches used when compiling the modules,
regardless of the state value in effect when the AST was triggered.
|
Change is in effect only until the AST completes or this service is
called again.
|
On Alpha systems, calling this routine changes the
setting for ASTs as well as the mainline program.
Required Access or Privilege
None
Required Quota
None
Related Services
$IEEE_SET_PRECISION_MODE
$IEEE_SET_ROUNDING_MODE
Condition Values Returned
|
SS$_NORMAL
|
The service completed successfully.
|
|
SS$_ACCVIO
|
The specified argument cannot be read or cannot be written.
|
$IEEE_SET_PRECISION_MODE (Integrity servers Only)
On Integrity server systems, modifies the IEEE precision mode and,
optionally, returns the previous value.
Format
SYS$IEEE_SET_PRECISION_MODE new_value , [*prev_value]
C Prototype
int sys$ieee_set_precision_mode (int new_value, int *prev_value);
Arguments
new_value
| OpenVMS usage: |
IEEE precision mode |
| type: |
longword (unsigned) |
| access: |
read only |
| mechanism: |
by value |
The new value can be one of the following:
| Symbol |
Value |
Meaning |
|
IEEE$C_PM_NO_CHANGE
|
-1
|
No change. Just get previous value
|
|
IEEE$C_PM_SINGLE
|
0
|
Single Precision
|
|
IEEE$C_PM_DOUBLE
|
2
|
Double Precision
|
|
IEEE$C_PM_DOUBLE_EXTENDED
|
3
|
Double-Extended Precision
|
prev_value
| OpenVMS usage: |
IEEE precision mode |
| type: |
longword (unsigned) |
| access: |
write only |
| mechanism: |
by reference |
The previous value is a pointer to a return value that can be one of
the last three items from the table showing new values.
Description
The initial precision mode and the scope of the modified precision mode
differ depending on the location of the call to this routine, as shown
in the following table.
| Location of Call |
Initial Precision Mode |
Scope of New Precision Mode |
|
Mainline
|
Determined by the compiler switches used when compiling the modules.
|
Change is in effect until this service is called again with the
exception of ASTs (see below).
|
|
Condition handler
|
The same as the precision mode in effect when the condition occurs,
unless the setting was changed by a previous condition handler.
|
Change is in effect until all remaining condition handlers have been
called or this service is called again.
|
|
AST routine
|
Determined by the compiler switches used when compiling the modules,
regardless of the precision in effect when the AST was triggered.
|
Change is in effect only until the AST completes or this service is
called again.
|
Required Access or Privileges
None
Required Quotas
None
Related Services
$IEEE_SET_FP_CONTROL
$IEEE_SET_ROUNDING_MODE
$IEEE_SET_ROUNDING_MODE (Integrity servers Only)
On Integrity server systems, modifies the IEEE rounding mode and,
optionally, returns the previous value.
Format
SYS$IEEE_SET_ROUNDING_MODE new_value , [*prev_value]
C Prototype
int sys$ieee_set_rounding_mode (int new_value, int *prev_value);
,
Arguments
new_value
| OpenVMS usage: |
IEEE rounding mode |
| type: |
longword (unsigned) |
| access: |
read only |
| mechanism: |
by value |
The new value can be one of the following:
| Symbol |
Value |
Meaning |
|
IEEE$C_RM_NO_CHANGE
|
-1
|
No change. Just get previous value
|
|
IEEE$C_RM_NEAREST
|
0
|
Nearest (or even)
|
|
IEEE$C_RM_DOWN
|
1
|
-Infinity (down)
|
|
IEEE$C_RM_UP
|
2
|
+Infinity (up)
|
|
IEEE$C_RM_TRUNCATE
|
3
|
Zero (truncate/chop)
|
prev_value
| OpenVMS usage: |
IEEE rounding mode |
| type: |
longword (unsigned) |
| access: |
write only |
| mechanism: |
by reference |
The previous value is a pointer to a return value that can be one of
the last four items from the table showing new values.
Description
The initial rounding mode and the scope of the modified rounding mode
differ depending on the location of the call to this routine, as shown
in the following table.
| Location of Call |
Initial Rounding Mode |
Scope of New Rounding Mode |
|
Mainline
|
Determined by the compiler switches used when compiling the modules.
|
Change is in effect until this service is called again, with the
exception of ASTs (see below).
|
|
Condition handler
|
The same as the rounding mode in effect when the condition occurs,
unless the setting was changed by a previous condition handler.
|
Change is in effect until all remaining condition handlers have been
called or this service is called again.
|
|
AST routine
|
Determined by the compiler switches used when compiling the modules,
regardless of the rounding in effect when the AST was triggered.
|
Change is in effect only until the AST completes or this service is
called again.
|
Required Access or Privileges
None
Required Quota
None
Related Services
$IEEE_SET_FP_CONTROL
$IEEE_SET_PRECISION_MODE
|
