iucvconn

iucvconn

Perform an IUCV CONNECT

Portability: SAS/C extension

SYNOPSIS
DESCRIPTION
RETURN VALUE
CAUTION
IMPLEMENTATION
EXAMPLE

SYNOPSIS

#include <cmsiucv.h>

int iucvconn(const char *name, struct iucv_path_plist *conn_parmlst);

DESCRIPTION

iucvconn requests CMS to issue an IUCV CONNECT. name points to a string that must match the name argument to a previously invoked iucvset function. conn_parmlst is a pointer to an IUCV CONNECT parameter list.

RETURN VALUE

iucvconn returns 0 if the function call was successful. If signal(SIGIUCV,fp) has not been called, iucvconn returns -1 . If the CMSIUCV macro returns a nonzero return code, iucvconn returns that value. If an IUCV error occurs, iucvconn returns 1 , and the value of IPRCODE is available in conn_parmlst-> ip.rcode .

CAUTION

You must call iucvset before calling iucvconn .

IMPLEMENTATION

iucvconn invokes the CMS CMSIUCV macro with the CONNECT parameter.

EXAMPLE

#include <cmsiucv.h>
#include <lcstring.h>

 int rc; 
 struct iucv_path_plist path; 
. 
. 
.

    /* Name the receiving userid and program. */ 
memset((char *) &  path,0,sizeof(path)); 
memcpyp(path.vmid,"USERID",sizeof(path.vmid),6,' '); 
memcpy(path.pgm,"RECEIVER",8);

rc = iucvconn("SENDER",&  path);

Chapter Contents
Previous
Next
Top of Page