iucvset

iucvset

Initialize IUCV Communications

Portability: SAS/C extension

SYNOPSIS
DESCRIPTION
RETURN VALUE
CAUTIONS
IMPLEMENTATION
EXAMPLE

SYNOPSIS

#include <cmsiucv.h>

int iucvset(const char *name, int *maxconns);

DESCRIPTION

iucvset identifies an IUCV program to CMS. name is a 1- to 8-character string identifying the communicating program's name. For example, a SAS/C program called sender.c may specify the name "SENDER" . If name is less than eight characters long, it is padded with blanks on the right. If name is greater than eight characters, it is truncated. The maximum number of connections for the virtual machine is returned in the integer pointed to by maxconns .

You can call iucvset any number of times as long as each call uses a different name string.

RETURN VALUE

iucvset returns 0 if the function call was successful. iucvset returns a negative code as follows:

-1 if signal or sigaction has never been called to handle the SIGIUCV signal.
-2 if a previous call to iucvset had the same name parameter.
-3 if there is not enough memory to allocate an interrupt queue.

If the HNDIUCV macro returns a nonzero return code, iucvset returns that value.

CAUTIONS

You must call signal or sigaction to establish an IUCV interrupt handler before calling iucvset . An IUCV program must be ready to handle incoming IUCV interrupts even before iucvset has returned.

IMPLEMENTATION

iucvset invokes the CMS HNDIUCV macro with the SET parameter. In addition, it allocates an initial 4K external interrupt data buffer.

EXAMPLE

#include <cmsiucv.h>
#include <stdio.h>

int maxconns, rc; 
. 
. 
.

rc = iucvset("SENDER",&  maxconns); 
if (rc != 0) 
   puts("iucvset failed.");

Chapter Contents
Previous
Next
Top of Page