Returns system performance information about the local system.
$GETRMI is an asynchronous system service and requires the
$SYNCH service or another wait-state synchronous mechanism to
guarantee that the required information is available. There is no
synchronous wait form for this system service.
For additional information about system service completion, see
the Synchronize ($SYNCH) service.
Format
SYS$GETRMI [efn] [,nullarg] [,nullarg] ,itmlst [,iosb]
[,astadr] [,astprm]
C Prototype
int sys$getrmi (unsigned int efn, unsigned int nullarg,
unsigned int nullarg, void *itmlst, struct
_iosb *iosb, void (*astadr)(__unknown_params),
int astprm);
1 – Arguments
efn
OpenVMS usage:ef_number
type: longword (unsigned)
access: read only
mechanism: by value
Number of event flag to be set when the $GETRMI request
completes. The efn argument is a longword containing this number;
however, $GETRMI uses only the low order byte.
nullarg
OpenVMS usage:null_arg
type: longword (unsigned)
access: read only
mechanism: by value
Placeholding argument Reserved to VSI.
nullarg
OpenVMS usage:null_arg
type: longword (unsigned)
access: read only
mechanism: by value
Placeholding argument Reserved to VSI.
itmlst
OpenVMS usage:item_list_3
type: longword (unsigned)
access: read only
mechanism: by reference
Item list specifying which information is to be returned about
the local node. The itmlst argument is the address of a list of
item descriptors, each of which describes an item of information.
The list of descriptors is terminated by a longword of 0.
To view the item code diagram and descriptor fields table, see
the VSI OpenVMS System Services Reference Manual.
iosb
OpenVMS usage:io_status_block
type: quadword (unsigned)
access: write only
mechanism: by reference
I/O status block to receive the final completion status. The iosb
argument is the address of the quadword I/O status block.
astadr
OpenVMS usage:ast_procedure
type: procedure value
access: call without stack unwinding
mechanism: by reference
AST service routine to be executed when $GETRMI completes. The
astadr argument is the address of this routine.
astprm
OpenVMS usage:user_arg
type: longword (unsigned)
access: read only
mechanism: by value
AST parameter to be passed to the AST service routine specified
by the astadr argument.