Filter
Top Products
HTPA001 E
Input parameter &1 not valid
CPF9802 E
Not authorized to object &2 in &3.
Look up Server Instance Data (QzhbGetInstanceData) API
Required Parameter Group:
1 name Input Char(10)
2 buf Output Void
3 buf_size Input Binary(4)
4 format Input Char(8)
5 buf_actlen Output Binary(4)
6 running Output Binary(4)
7 errcode I/O Char(*)
Threadsafe: Yes
Use the QzhbGetInstanceData API to get detailed data about a specific server
instance. This data includes whether the instance is currently running and all
start-up data.
Authorities and locks
To invoke this API, the user must have the following authorities:
v *EXECUTE authority to the QUSRSYS library
v *OBJOPR and *READ authority to the QUSRSYS/QATMHINSTC file
Required parameter group
name
INPUT:CHAR(10)
The server instance name. The name can be up to 10 characters long (padded
with blanks).
buf
OUTPUT:VOID
The buffer where the instance names are placed. The buffer is defined based on
the format parameter. You may omit this parameter.
buf_size
INPUT:BINARY(4)
The size of the buffer in bytes. A size of 0 can be specified meaning that no
data is returned in the buffer, but the running variable is still set to indicate the
running status of the instance.
format
INPUT:CHAR(8)
The format in which the data should be returned. The possible format names
follow:
INSD0100
buf_actlen
OUTPUT:BINARY(4)
58 Web Programming Guide V4R5