VMGROUPI(declare_buffer{=0},(8,vmname)==>c) Declare IUCV Buffer

Allows the vmname to establish IUCV paths.

Also allows paths to be established to this vmname. We assume this applies to non-control paths.

Forbids the vmname from establishing IUCV paths.

We assume this applies to non-control paths only.

Updates the count of active paths for the two vmnames. (The two vmnames may be the same.)

Return codes:

0 - Done.
N.B. vmname1 may invoke the RETRIEVE BUFFER function immediately afterwards. In this case it is up to vmname1 to sever the path.

2 - vmname1 is not a member of the group, counts unchanged.

3 - vmname2 is not a member of the group, counts unchanged.

4 - vmname1 has not invoked the DECLARE BUFFER function and therefore cannot establish an IUCV path. Counts unchanged.

5 - ditto vmname2, counts unchanged.

6 - the path would exceed the maximum number of connections allowed for vmname1. Counts unchanged.

7 - ditto vmname2. Counts unchanged.

Updates the count of active paths for the two vmnames. (The two vmnames may be the same.)

Return codes:

0 - Done.

2 - vmname1 is not a member of the group, counts unchanged.

3 - vmname2 is not a member of the group, counts unchanged.

S is a segment and rc is an address in the segment of an aligned word variable that is the next IUCV msgid to be assigned. rc < 4096.

Return codes:
0 - done

1 - vmname is not a member of the group

VMGROUPI(vmcf_authorize{=7},(8,vmname),(1,flags),(4,extintbuflen), (8,specific_userid); segment ==> c;) Authorize for VMCF

Declares vmname to be authorized for VMCF. If it was previously authorized, updates the information (without zapping any paths). If the flags indicate no specific authorizaion, specific_userid must nevertheless be present, and is ignored.

Passed key: segment is the memory segment of the virtual machine.

Zaps all paths to or from the vmname.

c=0: OK

c=4: the vmname was not previously authorized

Gets the sender's key from an existing VMCF connection, or if there is none, creates one.

Return codes:

0: ok

4: senderid is not authorized for VMCF

5: receiverid is not authorized for VMCF, or is not authorized for this specific sender

Return codes:
0: ok

12: there are no messages to be received