Sends a message to a host application.
HCON Library
C (libg3270.a)
Pascal (libg3270p.a)
FORTRAN (libg3270f.a)
#include <g32_api.h>
g32_write ( as, msgbuf, msglen)
struct g32_api *as;
char *msgbuf;
int msglen;
function g32wrte (var as : g32_api; buffer : integer; msglen : integer) : integer; external;
EXTERNAL G32WRITE
INTEGER AS(9), MSGLEN, G32WRITE
CHARACTER* XX MSGBUF
RC = G32WRITE(AS, MSGBUF, MSGLEN)
The g32_write function sends the message pointed to by the msgbuf parameter to the host. This function may only be used by those applications having API/API or API/API_T mode specified by the g32_alloc command.
HCON application programs using the Pascal language interface must include and link both the C and Pascal libraries. Applications programs using the FORTRAN language for the HCON API must include and link both the C and FORTRAN libraries.
> 0 (greater than or equal to zero) | Indicates successful completion. |
-1 | Indicates an error has occurred. |
The following example illustrates, in C language, the use of the g32_write function:
#include <g32_api> /* API include */ main() { struct g32_api *as; /* the g32 structure */ char *messg; /* pointer to a character string to send to the host */ int length; /* Number of bytes sent */ char *malloc(); /* C memory allocation function */ int return; /* return code is no. of bytes sent */ . . . messg = malloc(30); /* allocate 30 bytes for the string */ /* initialize message string with information */ strcpy(messg,"string to be sent to host/0"); length = strlen(messg); /* length of the message */ return = g32_write(as,messg,length); . . .
The g32_write function is part of the Host Connection Program (HCON).
The g32_write function requires one or more adapters used to connect to a host.
In a DBCS environment, the g32_write function only sends SBCS data to a host in the MODE_API_T mode.
/usr/include/g32_api.h | Contains data structures and associated symbol definitions. |
/usr/include/g32const.inc | Defines Pascal API constants. |
/usr/include/g32hfile.inc | Defines Pascal API external definitions. |
/usr/include/g32types.inc | Defines Pascal API data types. |