HP OpenVMS System Services Reference Manual

This Fortran program demonstrates how any job can obtain information about other jobs from the system job queue file by using the $GETQUIW system service. This program lists all print jobs in output queues with a job size of 500 blocks or more. It also displays queue name, job size, user name, and job name information for each job listed.

$GETQUIW

Returns information about queues and jobs initiated from those queues. The $SNDJBC service is the major interface to the Job Controller, which is the queue and accounting manager. For a discussion of the different types of job and queue, see the Description section of $SNDJBC.
The $GETQUIW service completes synchronously; that is, it returns to the caller with the requested information. For asynchronous completion, use the Get Queue Information ($GETQUI) service; $GETQUI returns to the caller after queuing the information request, without waiting for the information to be returned.
In all other respects, $GETQUIW is identical to $GETQUI. For more information about $GETQUIW, see the description of $GETQUI in this manual.
For additional information about system service completion, see the Synchronize ($SYNCH) service.

Format

SYS$GETQUIW [efn] ,func [,context] [,itmlst] [,iosb] [,astadr] [,astprm]

C Prototype

int sys$getquiw (unsigned int efn, unsigned short int func, unsigned int *context, void *itmlst, struct _iosb *iosb, void (*astadr)(__unknown_params), int astprm);

$GETRMI

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);

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 HP.
nullarg

OpenVMS usage: null_arg

type: longword (unsigned)

access: read only

mechanism: by value

Placeholding argument reserved to HP.
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.
The following diagram depicts the structure of a single item descriptor:

The following table defines the item descriptor fields:

Descriptor Field Definition

Buffer length A word containing a user-supplied integer specifying the length (in bytes) of the buffer in which $GETRMI is to write the information. The length of the buffer needed depends upon the item code specified in the item code field. If the buffer length is too small, $GETRMI truncates the data.

Item code A word containing a user-supplied code specifying the item of information that $GETRMI is to return. The RMIDEF macro defines these codes. A description of each item code is given in the item codes section.

Buffer address A longword containing the user-supplied address of a buffer in which $GETRMI returns the requested information.

Return length address A longword containing the user-supplied address of a word in which $GETRMI writes the length in bytes of the information returned.

Descriptor Field	Definition
Buffer length	A word containing a user-supplied integer specifying the length (in bytes) of the buffer in which $GETRMI is to write the information. The length of the buffer needed depends upon the item code specified in the item code field. If the buffer length is too small, $GETRMI truncates the data.
Item code	A word containing a user-supplied code specifying the item of information that $GETRMI is to return. The RMIDEF macro defines these codes. A description of each item code is given in the item codes section.
Buffer address	A longword containing the user-supplied address of a buffer in which $GETRMI returns the requested information.
Return length address	A longword containing the user-supplied address of a word in which $GETRMI writes the length in bytes of the information returned.

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.

Item Codes

RMI$_ACCESS
Returns the count of file name lookup operations in file directories.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_ACCLCK
Returns the systemwide count of access locks.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_ALLOC
Returns the number of QIO requests that caused allocation of disk space.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_ARRLOCPK
Returns the accumulated systemwide count of arriving local DECnet packets.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_ARRTRAPK
Returns the accumulated systemwide count of arriving transit DECnet packets.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BADFLTS
Returns the accumulated systemwide count of bad-list faults.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BLKIN
Returns the accumulated systemwide count of blocking ASTs queued that originated on a remote system and were processed on the local system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BLKLOC
Returns the accumulated systemwide count of blocking ASTs queued that originated and were processed on the local system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BLKOUT
Returns the accumulated systemwide count of blocking ASTs queued that originated on the local system and were processed on a remote system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BLKAST
Returns the number of blocking ASTs.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BUFIO
Returns the number of buffered I/Os.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BUFOBJPAG
Returns the number of buffer object physical pages currently allocated.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BUFOBJPAGPEAK
Returns the maximum number of buffer object physical pages currently allocated.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BUFOBJPAGS01
Returns the number of buffer object pages currently allocated in S0 and S1 space.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BUFOBJPAGS2
Returns the number of buffer object physical pages currently allocated in S2 space.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BUFOBJPAGMAXS01
Returns the available number of buffer object pages in S0 and S1 space.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BUFOBJPAGMAXS2
Returns the available number of buffer object pages in S2 space.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BUFOBJPAGPEAKS01
Returns the maximum number of buffer object pages currently allocated in S0 and S1 space.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BUFOBJPAGPEAKS2
Returns the maximum number of buffer object pages currently allocated in S2 space.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BUFOBJPGLTMAXS01
Returns the available number of buffer object pagelets in S0 and S1 space.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_BUFOBJPGLTMAXS2
Returns the available number of buffer object pagelets in S2 space.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CEF
Returns the number of processes in the common event flag wait state.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_COLPG
Returns the number of processes in the collided page wait state.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_COM
Returns the number of processes in the computable state.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_COMO
Returns the number of outswapped processes in the computable state.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CPUEXEC
Returns the amount of time, in 10-millisecond units, spent by all CPUs in executive mode.
Because this number is a quadword, the buffer length field in the item descriptor should specify 8 (bytes).
RMI$_CPUID
Returns the primary CPU ID.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CPUIDLE
Returns the amount of time, in 10-millisecond units, spent by all CPUs in idle mode.
Because this number is a quadword, the buffer length field in the item descriptor should specify 8 (bytes).
RMI$_CPUINTSTK
Returns the amount of time, in 10-millisecond units, spent by all CPUs in processing interrupts.
Because this number is a quadword, the buffer length field in the item descriptor should specify 8 (bytes).
RMI$_CPUKERNEL
Returns the amount of time, in 10-millisecond units, spent by all CPUs in kernel mode.
Because this number is a quadword, the buffer length field in the item descriptor should specify 8 (bytes).
RMI$_CPUMPSYNCH
Returns the amount of time, in 10-millisecond units, spent by the primary CPU in synchronization mode.
Because this number is a quadword, the buffer length field in the item descriptor should specify 8 (bytes).
RMI$_CPUSUPER
Returns the amount of time, in 10-millisecond units, spent by all CPUs in supervisor mode.
Because this number is a quadword, the buffer length field in the item descriptor should specify 8 (bytes).
RMI$_CPUUSER
Returns the amount of time, in 10-millisecond units, spent by all CPUs in user mode.
Because this number is a quadword, the buffer length field in the item descriptor should specify 8 (bytes).
RMI$_CUR
Returns the number of currently-executing processes.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CWPSBYTESIN
Returns the number of clusterwide process services (CWPS) message bytes received by the system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CWPSBYTESOUT
Returns the number of CWPS message bytes sent by the system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CWPSJPISIN
Returns the number of CWPS $GETJPI requests received by the system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CWPSJPISOUT
Returns the number of CWPS $GETJPI requests sent by the system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CWPSMSGSIN
Returns the number of CWPS messages received by the system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CWPSMSGSOUT
Returns the number of CWPS messages sent by the system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CWPSPCNTRLIN
Returns the number of CWPS PCNTRL requests received by the system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CWPSPCNTRLOUT
Returns the number of CWPS PCNTRL requests sent by the system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CWPSRSRCIN
Returns the number of CWPS resource-fail messages received by the system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_CWPSRSRCOUT
Returns the number of CWPS resource-fail messages sent by the system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_ABORTS
Returns the accumulated systemwide count of transactions aborted (planned and unplanned).
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_ADDS
Returns the accumulated systemwide count of transaction branches added on the local node.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_BAD_LINKS
Returns the total number of bad message links received.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_BAD_PARTS
Returns the number of invalid part IDs found.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_BAD_TYPECODE
Returns the total number of bad message type codes received.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_BRANCHS
Returns the accumulated systemwide count of transaction branches started on the local node.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_BUCKETS1
Returns the accumulated systemwide count of transactions with a duration of less than 1 second.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_BUCKETS2
Returns the accumulated systemwide count of transactions with a duration of 1 to 2 (1.99) seconds.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_BUCKETS3
Returns the accumulated systemwide count of transactions with a duration of 2 to 3 (2.99) seconds.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_BUCKETS4
Returns the accumulated systemwide count of transactions with a duration of 3 to 4 (3.99) seconds.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_BUCKETS5
Returns the accumulated systemwide count of transactions with a duration of 4 to 5 (4.99) seconds.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_BUCKETS6
Returns the accumulated systemwide count of transactions with a duration of at least 5 seconds.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_DECLARES
Returns the total number of $DECLARE_RMs.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_DISC_COMP
Returns the number of disconnected complete events.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_ENDS
Returns the accumulated systemwide count of transactions ended.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_FOR_UNLINKS
Returns the number of forced unlinks.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_FORGETS
Returns the total number of $FORGET_RMs.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_JOINS
Returns the total number of $JOIN_RMs.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_LOG_COMMITS
Returns the total number of commit records written.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_LOG_FORGETS
Returns the total number of forget records written.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_LOG_PREPARES
Returns the total number of prepare records written.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_ONE_PHASE
Returns the accumulated systemwide count of 1-phase commit events initiated.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_PREPARES
Returns the accumulated systemwide count of transactions that have been prepared.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_SEQNO
Returns the total number of XCBs created.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_STARTS
Returns the accumulated systemwide count of transactions successfully started.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_TWOPHASE_ACKRCV
Returns the accumulated systemwide count of 2-phase commit ACK messages received.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_TWOPHASE_ACKSNT
Returns the accumulated systemwide count of 2-phase commit ACK messages sent.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_TWOPHASE_CANRCV
Returns the accumulated systemwide count of 2-phase commit cancel messages received.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_TWOPHASE_CANSNT
Returns the accumulated systemwide count of 2-phase commit cancel messages sent.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_TWOPHASE_COMMITS
Returns the accumulated systemwide count of 2-phase commit events initiated.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_TWOPHASE_RDYRCV
Returns the accumulated systemwide count of 2-phase commit ready messages received.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_TWOPHASE_RDYSNT
Returns the accumulated systemwide count of 2-phase commit ready messages sent.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_TWOPHASE_REQRCV
Returns the accumulated systemwide count of 2-phase commit requests received.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_TWOPHASE_REQSNT
Returns the accumulated systemwide count of 2-phase commit requests sent.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_VOL_UNLINKS
Returns the number of voluntary unlinks.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_WRITES_FORKED
Returns the total number of forked writes.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DDTM_WRITES_STARTED
Returns the total number of writes started.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DEPLOCPK
Returns the accumulated systemwide count of departing local DECnet packets.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DEQ
Returns the number of DEQ operations.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DEQIN
Returns the accumulated systemwide count of unlock (dequeue) lock requests that originated on a remote system and were processed on the local system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DEQLOC
Returns the accumulated systemwide count of unlock (dequeue) requests that originated and were processed on the local system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DEQOUT
Returns the accumulated systemwide count of unlock (dequeue) requests that originated on the local system and were processed on a remote system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DIRDATA_HIT
Returns the systemwide count of directory data cache hits.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DIRDATA_MISS
Returns the systemwide count of directory data cache misses.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DIRFCB_HIT
Returns the systemwide count of directory FCB cache hits.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DIRFCB_MISS
Returns the systemwide count of directory FCB cache misses.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DIRIN
Returns the accumulated systemwide count of directory operations serviced by the local system that originated on remote systems.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DIROUT
Returns the accumulated systemwide count of directory operations that originated on the local system and were serviced by remote systems.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DIRIO
Returns the number of direct I/Os.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DLCK_INCMPLT
Returns the accumulated systemwide count of incomplete deadlock searches.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DLCKFND
Returns the number of deadlocks found.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DLCKMSGS_IN
Returns the systemwide count of incoming deadlock detection messages.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DLCKMSGS_OUT
Returns the accumulated systemwide count of outgoing deadlock detection messages.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DLCKSRCH
Returns the number of deadlock searches.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_DZROFLTS
Returns the number of demand zero page faults.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_ENQCVT
Returns the number of ENQ conversion operations.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_ENQCVTIN
Returns the accumulated systemwide count of lock conversion requests that originated on a remote system and were processed on the local system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_ENQCVTLOC
Returns the accumulated systemwide count of lock conversion requests that originated and were processed on the local system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_ENQCVTOUT
Returns the accumulated systemwide count of lock conversion requests that originated on the local system and were processed on a remote system.
Because this number is a longword, the buffer length field in the item descriptor should specify 4 (bytes).
RMI$_ENQNEW
Returns the number of new ENQ operations.

Previous Next Contents Index

OpenVMS usage:	ef_number
type:	longword (unsigned)
access:	read only
mechanism:	by value

OpenVMS usage:	null_arg
type:	longword (unsigned)
access:	read only
mechanism:	by value

OpenVMS usage:	item_list_3
type:	longword (unsigned)
access:	read only
mechanism:	by reference