CP Simulator Factory

SIM360F(PSB,M,SB,CLOCK,VDK ==> c;DEFINEDEVICE,DOMKEY) - Create CP simulator
CLOCK is a clock key and VDK is a domain keeper to handle traps in the simulated 360 domain {those not handled by 360 simulation}. DEFINEDEVICE is a define device key and DOMKEY is a virtual domain key to the 360 domain.

The virtual domain may be described as an extended CPU with a nember of CP type functions added. It "traps" as would a normal domain upon events that are forign to CP such as when the "real domain" suffers rejected return codes. DOMKEY may be used to fetch and store keys in the real domain.

DEFINEDEVICE(0,(2,addr),(8,type),(4,size);K1,K2,K3,K4==>c) - Define device
Parameter "type" is a an EBCDIC string right padded with blanks with one of the following values:
3330, 3350, 3370, 3380 (DASD)
K1 is a key to a segment that holds that state of a simulated disk.

If the segment is new (zero) then the segment is set to reflect the specified type and size (in cylinders or blocks as appropriate). Formating is still required before use by the CMS file system. (Formating 3370 blocks with the NOERASE option will improve formating speed.)

If the segment has already been used by the CP simulator to simulate a disk, then size is ignored but type must match previous use. The type is coded in a segment at bytes 4 thru 11.

K1 may also be a RLINK or WLINK key.

2400 - K1 is a TAPEACCESS key, c is the return code from a "make unlabeled" operation on that key.

1052 - K1 is a SIK6 key, K2 is a SOK6 key, K3 is a CCK6 key, and K4 is an optional ZMK key for simulation of the DISCONN command.

Return Codes:
When the proffered key returns a non-zero code that code is returned here. We propose that the code should be returned in a string accompanied by a new error code for the DEFINEDEVICE key disticnt from those below.

c=0 - Device defined

c=1 - No Device blocks left to define new devices

c=2 - Device type not recognized

c=10 - Device type specified not the same as the device type defined by the segment or the segment can not be accessed (DASD devices).

DEFINEDEVICE(1,(2,addr),(8,"1052 ");SIK6,SOK6,CCK6,ZMK==>c) - Define console
Return codes are the same as for order code 0, ZMK is optional.

DEFINEDEVICE(2;PRINTER==>0) - Define printer file sink
PRINTER is a key that will receive any printer spool files that are not held or spooled to self. It will be called using the KeyKOS print spooler protocol {(p2,printer)}. It will be responsible for deleting the spool file fresh segment (with kt+4) when it is finished using it.

DEFINEDEVICE(3,(2,addr);K1==>c) - Define formated disk device
Parameter "addr" is the device address to be defined.

K1 is a key to a segment that holds that state of a simulated disk.

Return Codes:

c=0 - Device defined

c=1 - No Device blocks left to define new devices

c=2 - Device type not recognized

c=10 - Device type of the segment not recognized, or the segment can not be accessed. Old key at that address is gone nonetheless.

DEFINEDEVICE(4;K1==>0) - Define link directory
K1 is a key to a directory which will be used to resolve CP LINK commands {(link)}.

DEFINEDEVICE(5,VMCOMM==>c) - Join a VM group
Causes the virtual machine to join the group from which the key VMCOMM was produced. {(vmcomm)}