Chapter Contents

Previous

Next
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

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.