I Usage Notes: I Error Conditions:
MF=(E,addr)
indicates that instructions are generated to execute the CMSIUCV func­
tion. "addr" represents the location of the parameter list. Information in
the parameter list may be changed by specifying the appropriate oper­
ands on the macro.
Note: When using the MF= parameter, all other parameters are optional. When
the function is executed, however, a valid combination of parameters must have
been specified by the LIST and EXECUTE formats of the macro.
1. To insure that no program tries to SEVER a path that another program estab­
lished, each individual IUCV path has a NAME associated with it. When a
program requests a CONNECT or ACCEPT function, the NAME specified
becomes the owner of this path. If the program requests a SEVER or an
ACCEPT for a specific path and the NAME specified does not correspond
with the owner of that path, the SEVER or ACCEPT is not permitted.
2. The HNDIUCV macro must be issued to identify the program to CMS before
issuing the CMSIUCV macro.
3. If the program requests a SEVER function with CODE=ALL, all IUCV paths
owned by that program are SEVERed. The IPUSER field of the IUCV SEV­ ER PRMLIST is set to binary ones.
4. The IUCV communication facility generates exceptions for some error condi­
tions. If IUCV generates an operation, specification, or addressing exception
while a HNDIUCV or CMSIUCV macro is executing, control does not directly
return to the next sequential instruction. Instead, a program check is
generated.
5. The HNDIUCV REP function will only replace the general exit address and/or UWORD set up by your program via the HNDIUCV SET function. If your
program had previously issued any CMSIUCV CONNECTs and had the EXIT
address or UWORD default to the HNDIUCV SET's EXIT and UWORD, the HNDIUCV REP function does not replace the path specific EXIT or UWORD set up via the CMSIUCV function. The EXIT and UWORD remain as estab­
lished when the CMSIUCV function was issued.
If an error occurs, register 15 contains one of the following return codes:
Code Meaning
8 No HNDIUCV SET has been issued for this program (CON­ NECT,ACCEPT,SEVER)
12 The program doesn't own the path (ACCEPT ,SEVER) 16 The NAME parameter was not specified or its address is equal
to zero (CONNECT,ACCEPT,SEVER) 24 The PRMLIST parameter was not specified or its address is
equal to zero (CONNECT,ACCEPT,SEVER) CMS IUCV Support 363
I Exits
\ Usage Notes
Code Meaning
28 An IUCV SEVER with the IP ALL bit on is not allowed
(SEVER) 40 Unrecognized function
lxxx Indicates that an IUCV error occurred. "xxx" is the IPRCODE field that was returned by IUCV to aid in diagnosing the error. (CONNECT ,ACCEPT ,SEVER)
When the program's IUCV external interruption routine is given control, all inter­
ruptions are disabled. The exit routine is responsible for providing proper entry
and exit linkage for its IUCV external interruption handling routine. The exit rou­
tine has the following requirements:
The routine should not enable itself for any type of interrupts.
The routine should not perform any I/O operations, since all interruptions are
disabled.
The routine must return control to the address in register 14.
When the routine receives control, the significant registers contain:
Register
o
1
2
13
14
15
Contents UWORD Field Points to a SA VEAREA in the format:
Label
GRS
FRS
PSW UAREA END
Displacement
Dec Hex
o 0 64 40 96 60 104 68
176 80 Address of the IUCV External Interrupt Buffer Points to the save area at label UAREA for use by the exit rou­
tine
Return address
Entry point address
1. If the CMS IUCV support is active, the external interrupt handler recognizes
two error conditions.
An IUCV pending-connect external interrupt occurs and the first eight
bytes of the IPUSER field does not match any currently active CMS IUCV program's identity.
364 VM!SP System Programmer's Guide
Previous Page Next Page