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