Chapter Contents

Previous

Next
iucvsevr

iucvsevr



Perform an IUCV SEVER

Portability: SAS/C extension


SYNOPSIS
DESCRIPTION
RETURN VALUE
CAUTION
IMPLEMENTATION
EXAMPLE


SYNOPSIS

#include <cmsiucv.h>

 int iucvsevr(const char *name, struct iucv_path_plist *svr_parmlst, 
              const char *code);


DESCRIPTION

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

code can be either "ALL" or "ONE" . If it is "ONE" , only the one path specified by svr_parmlist.pathid is severed (using SEVER). If code is "ALL" , all paths owned by the program are severed. The "ALL" and "ONE" parameters must be coded exactly as shown, uppercase and enclosed in quotation marks, with no substitutions or variations in syntax.


RETURN VALUE

iucvsevr returns 0 if the function call was successful. If neither signal nor sigaction has not been called to handle the SIGIUCV signal, iucvsevr returns -1 . If the CMSIUCV macro returns a nonzero return code, iucvsevr returns that value. If an IUCV error occurs, iucvsevr returns 1 , and the value of IPRCODE is available in svr_parmlst-> ip.rcode .


CAUTION

You must call iucvset before calling iucvsevr .


IMPLEMENTATION

iucvsevr invokes the CMS CMSIUCV macro with the SEVER parameter. The value of the CODE parameter depends on the value of code .


EXAMPLE

#include <cmsiucv.h>

short pathid;           /* PATHID to be severed */

path.pathid = pathid; 
rc = iucvsevr("SENDER",&  path,"ONE");


Chapter Contents

Previous

Next

Top of Page

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