Chapter Contents |
Previous |
Next |
iucvsevr |
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.